Support Panache Sort Null Handling

[Sgitario]

Allow users sorting by either nulls first or nulls last.
Example of usage:

Sort.by("foo", Sort.Direction.Ascending, Sort.NullPrecedence.NULLS_FIRST);

(See more examples in tests)

This PR also adds support of nulls handling for the Spring Data JPA Quarkus extension: it translates the Spring Sort object to the new Panache Sort object.

Finally, as the Panache Sort API is also used by the Mongo Quarkus extension and Mongo does not easily support sorting by nulls, I decided to simply print a WARNING message if users try to use it.

Fix #26172

[geoand]

I like the idea!

@loicmathieu WDYT?

[loicmathieu]

I like the idea, I'll try to review the PR tomorrow or Friday.

On Mongo, we should not create methods that allow to set the NullHandling if not supported, or we should throw an error not log a warning as it's a developer mistake.

[Sgitario]

I like the idea, I'll try to review the PR tomorrow or Friday.

On Mongo, we should not create methods that allow to set the NullHandling if not supported, or we should throw an error not log a warning as it's a developer mistake.

The methods are common for the non-Mongo extensions, but it makes sense to throw an exception instead. PR updated.

[gastaldi]

LGTM

[gastaldi]

I think it would be nice to have this new feature documented in the Panache guides too.

[gastaldi]

Also don't forget to change the snippet in the commit to use NullPrecendence instead of NullHandling 😉

[loicmathieu]

Can you also add some tests for MongoDB ? In existing test cases.

[Sgitario]

| Can you also add some tests for MongoDB ? In existing test cases.

@loicmathieu do you mean to verify that the exception is thrown when using NullPrecedence in MongoDB ?

[loicmathieu]

@Sgitario yes

[Sgitario]

I've just updated the PR's changes with:

• documentation
• integration tests in reactive, orm and mongodb

[loicmathieu]

I added a bunch of JavaDoc suggestions, mainly due to the renaming of handlin -> precedence but overall looks good to me.

Can you please also update the Hibernate reactive guide Sort section: https://quarkus.io/guides/hibernate-reactive-panache#sorting

[Sgitario]

Documentation for Panache Reactive also updated.

[loicmathieu]

LGTM, thanks for your contribution