Feat/paging

[calebkiage]

Closes #1569

[baywet]

Good first draft!
Beside the comment I left, please fix the failing tests and add an entry to the changelog.
Also thank you for setting the friendly assembly!

[MIchaelMainer]

Coming into this without context....

Is it correct to call this OpenApi paging as this looks like Microsoft Graph paging coming from a custom attribute?

How do we enable arbitrary paging support for unknown API paging mechanism?

Looks like deltalink is missing as well.

[calebkiage]

Looks like deltalink is missing as well.

@MIchaelMainer, what is deltalink? This was designed to mirror the autorest extension Autorest x-ms-pageable

[baywet]

@MIchaelMainer the delta link is a mechanism of sync, not paging. By definition when your application gets a delta link, it's done paging the current changes with the next link, and needs to persist it and come back with it later. I don't think this applies to the scope of these changes.

[MIchaelMainer]

@baywet Delta query is a sync mechanism. The deltalink can be an end artifact of a nextlink driven paged result set that was started with a delta query. A deltalink can also be used to make a request that results in a paged result set that is driven by nextlink.

I do agree that it is outside the scope of x-ms-pageable and this PR.

[sonarcloud]

Kudos, SonarCloud Quality Gate passed!   

0 Bugs
0 Vulnerabilities
0 Security Hotspots
1 Code Smell

88.9% Coverage
0.0% Duplication