CAMEL-19304: camel-jpa implement paging

[jacekszymanski]

Description

Camel JPA endpoint supports option maximumResults, but this is not enough to implement paging. Also, there is no way to specify offset apart from nativeQuery.

maximumResults is static on the endpoint; it may be specified dynamically only using toD, but this means creating dynamic endpoints.

This PR addresses the above:

• adds support for firstResult
• both maximumResults and firstResult may be specified in message headers, these override values specified on the endpoint, if any

Target

• I checked that the commit is targeting the correct branch (note that Camel 3 uses camel-3.x, whereas Camel 4 uses the main branch)

Tracking

• If this is a large change, bug fix, or code improvement, I checked there is a JIRA issue filed for the change (usually before you start working on it).

Apache Camel coding standards and style

• I checked that each commit in the pull request has a meaningful subject line and body.

• I formatted the code using mvn -Pformat,fastinstall install && mvn -Psourcecheck

[github-actions]

🌟 Thank you for your contribution to the Apache Camel project! 🌟

⚠️ Please note that the changes on this PR may be tested automatically.

If necessary Apache Camel Committers may access logs and test results in the job summaries!

[jacekszymanski]

Thanks, corrected.

[github-actions]

Components tested:

Total	Tested	Failed ❌	Passed ✅
1	1	1	0

[github-actions]

Components tested:

Total	Tested	Failed ❌	Passed ✅
1	1	0	1