Integrate PrefetchSizeInBytes Option

[jsquire]

Summary

As part of an exploratory effort, an option for tuning Event Hub consumer clients using a size-limited prefetch cache provided by the Microsoft.Azure.Amqp library was prototyped and released for partner testing. The prototype functionality has been confirmed, and the options should be integrated into the main branch of the repository for inclusion in future releases.

Scope of Work

• Review the prototype API with the .NET language architect and seek formal approval for its addition.

• Incorporate the changes from the prototype into the main branch of the repository, addressing comments left on the pull request as part of that integration.

• Review the behavior details provided by the Event Hubs service team and ensure that relevant API members are documented as appropriate for public options. (details provided as part of an internal email thread)

Success Criteria

• The API changes have been reviewed and approved by the .NET architect.

• The API surface needed to support the PrefetchSizeInBytes feature has been implemented by applying the prototype changes.

• The feedback from the prototype pull request has been addressed and incorporated.

• The tests necessary for validation of the feature have been created or adjusted and pass reliably.

• The existing live test suite continues to produce deterministic results and pass reliably.

References

• Expose PrefetchSize option which maps to TotalCacheSizeInBytes (#14458)