Improves Java API signatures maintaining back compatibility

[lordofthejars]

Describe your changes

Issue ticket number and link

Checklist before requesting a review

• [ x] I have performed a self-review of my code.
• [ x] If it is a core feature, I have added thorough tests.
• [ x] I have added thorough documentation for my code.
• I have tagged PR with relevant project labels. I acknowledge that a PR without labels may be dismissed.
• If this PR addresses a bug, I have provided both a screenshot/video of the original bug and the working solution.

Demo

Steps to Reproduce

Notes