Adds count, scanned count and consumed capacity to DDB Enhanced Page

[cenedhryn]

Motivation and Context

This PR addresses the issue of missing metadata fields in the response of DDB Enhanced Scan and Query operations, as described in

• Enhanced Client doesn't return consumed capacity in all operations #3744 Enhanced Client doesn't return consumed capacity in all operations and
• #2707 for Java v1

In addition, this PR adds Count and ScannedCount to the response to aid users who want to understand the results of their queries.

Scan and Query are paginated operations where each page is represented by a backend call to DDB. The consumed capacity and count metric metadata is specific per page; therefore this metadata is exposed to the user per page. The new response values are available on both table and index operations.

Modifications

• Adds the parameter to request returning consumed capacity to the EnhancedScanRequest and EnhancedQueryRequest
• Adds ConsumedCapacity to the Page class
• Adds Count and ScannedCount to the Page class
• Refactors the existing integration tests into fewer classes that use less resources and let maintainers scan through the tests quicker.

Testing

Functional testing, integration testing

Screenshots (if appropriate)

Types of changes

• Bug fix (non-breaking change which fixes an issue)
• New feature (non-breaking change which adds functionality)

Checklist

• I have read the CONTRIBUTING document
• Local run of mvn install succeeds
• My code follows the code style of this project
• My change requires a change to the Javadoc documentation
• I have updated the Javadoc documentation accordingly
• I have added tests to cover my changes
• All new and existing tests passed
• I have added a changelog entry. Adding a new entry must be accomplished by running the scripts/new-change script and following the instructions. Commit the new file created by the script in .changes/next-release with your changes.
• My change is to implement 1.11 parity feature and I have updated LaunchChangelog

License

• I confirm that this pull request can be released under the Apache 2 license

[zoewangg]

I guess we can't just include a service response here since it could be QueryResponse and ScanResponse. :(

[cenedhryn]

If we really wanted to, we could make it a metadata field, then we'd get
page.responseMetadata().count() instead of
page.count().

I find the current version a more natural, but if DDB would add many more metadata fields we'd be glad we had a containing object. WDYT?

[zoewangg]

I was thinking about including the whole responsescanResponse, so page.sdkResponse().count(), but that doesn't seem to be possible.

[sonarqubecloud]

SonarCloud Quality Gate failed.   

0 Bugs
0 Vulnerabilities
0 Security Hotspots
10 Code Smells

53.8% Coverage
9.9% Duplication

Catch issues before they fail your Quality Gate with our IDE extension SonarLint