HHH-15125 - Add ANTLR-based SQL formatter implementation

[jrenaat]

Implement TokenBasedFormatterImpl as an improved SQL formatter using
ANTLR for tokenization.

---

By submitting this pull request, I confirm that my contribution is made under the terms of the Apache 2.0 license
and can be relicensed under the terms of the LGPL v2.1 license in the future at the maintainers' discretion.
For more information on licensing, please check here.

---

---

Please make sure that the following tasks are completed:
Tasks specific to HHH-20415 (Improvement):

• Add tests for feature/improvement
• Update documentation as relevant: javadoc for changed API, documentation/src/main/asciidoc/userguide for all features, documentation/src/main/asciidoc/introduction for main features, links from existing documentation
• Add entries as relevant to migration-guide.adoc (breaking changes) and whats-new.adoc (new features/improvements)

Tasks specific to HHH-20412 (Remove Feature):

• Add test OR check there is no need for a test
• Update documentation as relevant: javadoc for changed API, documentation/src/main/asciidoc/userguide for all features, documentation/src/main/asciidoc/introduction for main features, links from existing documentation
• Add entries as relevant to migration-guide.adoc (breaking changes) and whats-new.adoc (new features/improvements)

Tasks specific to HHH-20375 (Task):

• Add test OR check there is no need for a test
• Update documentation as relevant: javadoc for changed API, documentation/src/main/asciidoc/userguide for all features, documentation/src/main/asciidoc/introduction for main features, links from existing documentation
• Add entries as relevant to migration-guide.adoc (breaking changes) and whats-new.adoc (new features/improvements)

Tasks specific to HHH-20374 (New Feature):

• Add tests for feature/improvement
• Update documentation as relevant: javadoc for changed API, documentation/src/main/asciidoc/userguide for all features, documentation/src/main/asciidoc/introduction for main features, links from existing documentation
• Add entries as relevant to migration-guide.adoc (breaking changes) and whats-new.adoc (new features/improvements)

Tasks specific to HHH-20369 (New Feature):

• Add tests for feature/improvement
• Update documentation as relevant: javadoc for changed API, documentation/src/main/asciidoc/userguide for all features, documentation/src/main/asciidoc/introduction for main features, links from existing documentation
• Add entries as relevant to migration-guide.adoc (breaking changes) and whats-new.adoc (new features/improvements)

Tasks specific to HHH-20368 (New Feature):

• Add tests for feature/improvement
• Update documentation as relevant: javadoc for changed API, documentation/src/main/asciidoc/userguide for all features, documentation/src/main/asciidoc/introduction for main features, links from existing documentation
• Add entries as relevant to migration-guide.adoc (breaking changes) and whats-new.adoc (new features/improvements)

Tasks specific to HHH-20362 (New Feature):

• Add tests for feature/improvement
• Update documentation as relevant: javadoc for changed API, documentation/src/main/asciidoc/userguide for all features, documentation/src/main/asciidoc/introduction for main features, links from existing documentation
• Add entries as relevant to migration-guide.adoc (breaking changes) and whats-new.adoc (new features/improvements)

Tasks specific to HHH-20295 (Improvement):

• Add tests for feature/improvement
• Update documentation as relevant: javadoc for changed API, documentation/src/main/asciidoc/userguide for all features, documentation/src/main/asciidoc/introduction for main features, links from existing documentation
• Add entries as relevant to migration-guide.adoc (breaking changes) and whats-new.adoc (new features/improvements)

Tasks specific to HHH-20141 (Improvement):

• Add tests for feature/improvement
• Update documentation as relevant: javadoc for changed API, documentation/src/main/asciidoc/userguide for all features, documentation/src/main/asciidoc/introduction for main features, links from existing documentation
• Add entries as relevant to migration-guide.adoc (breaking changes) and whats-new.adoc (new features/improvements)

Tasks specific to HHH-20139 (Improvement):

• Add tests for feature/improvement
• Update documentation as relevant: javadoc for changed API, documentation/src/main/asciidoc/userguide for all features, documentation/src/main/asciidoc/introduction for main features, links from existing documentation
• Add entries as relevant to migration-guide.adoc (breaking changes) and whats-new.adoc (new features/improvements)

Tasks specific to HHH-20135 (Improvement):

• Add tests for feature/improvement
• Update documentation as relevant: javadoc for changed API, documentation/src/main/asciidoc/userguide for all features, documentation/src/main/asciidoc/introduction for main features, links from existing documentation
• Add entries as relevant to migration-guide.adoc (breaking changes) and whats-new.adoc (new features/improvements)

Tasks specific to HHH-20134 (Improvement):

• Add tests for feature/improvement
• Update documentation as relevant: javadoc for changed API, documentation/src/main/asciidoc/userguide for all features, documentation/src/main/asciidoc/introduction for main features, links from existing documentation
• Add entries as relevant to migration-guide.adoc (breaking changes) and whats-new.adoc (new features/improvements)

Tasks specific to HHH-20097 (Improvement):

• Add tests for feature/improvement
• Update documentation as relevant: javadoc for changed API, documentation/src/main/asciidoc/userguide for all features, documentation/src/main/asciidoc/introduction for main features, links from existing documentation
• Add entries as relevant to migration-guide.adoc (breaking changes) and whats-new.adoc (new features/improvements)

Tasks specific to HHH-20083 (Remove Feature):

• Add test OR check there is no need for a test
• Update documentation as relevant: javadoc for changed API, documentation/src/main/asciidoc/userguide for all features, documentation/src/main/asciidoc/introduction for main features, links from existing documentation
• Add entries as relevant to migration-guide.adoc (breaking changes) and whats-new.adoc (new features/improvements)

Tasks specific to HHH-20062 (Improvement):

• Add tests for feature/improvement
• Update documentation as relevant: javadoc for changed API, documentation/src/main/asciidoc/userguide for all features, documentation/src/main/asciidoc/introduction for main features, links from existing documentation
• Add entries as relevant to migration-guide.adoc (breaking changes) and whats-new.adoc (new features/improvements)

Tasks specific to HHH-20028 (Task):

• Add test OR check there is no need for a test
• Update documentation as relevant: javadoc for changed API, documentation/src/main/asciidoc/userguide for all features, documentation/src/main/asciidoc/introduction for main features, links from existing documentation
• Add entries as relevant to migration-guide.adoc (breaking changes) and whats-new.adoc (new features/improvements)

Tasks specific to HHH-19951 (Improvement):

• Add tests for feature/improvement
• Update documentation as relevant: javadoc for changed API, documentation/src/main/asciidoc/userguide for all features, documentation/src/main/asciidoc/introduction for main features, links from existing documentation
• Add entries as relevant to migration-guide.adoc (breaking changes) and whats-new.adoc (new features/improvements)

Tasks specific to HHH-19933 (Improvement):

• Add tests for feature/improvement
• Update documentation as relevant: javadoc for changed API, documentation/src/main/asciidoc/userguide for all features, documentation/src/main/asciidoc/introduction for main features, links from existing documentation
• Add entries as relevant to migration-guide.adoc (breaking changes) and whats-new.adoc (new features/improvements)

Tasks specific to HHH-19567 (Bug):

• Add test reproducing the bug
• Add entries as relevant to migration-guide.adoc OR check there are no breaking changes

Tasks specific to HHH-19509 (Improvement):

• Add tests for feature/improvement
• Update documentation as relevant: javadoc for changed API, documentation/src/main/asciidoc/userguide for all features, documentation/src/main/asciidoc/introduction for main features, links from existing documentation
• Add entries as relevant to migration-guide.adoc (breaking changes) and whats-new.adoc (new features/improvements)

Tasks specific to HHH-15125 (New Feature):

• Add tests for feature/improvement
• Update documentation as relevant: javadoc for changed API, documentation/src/main/asciidoc/userguide for all features, documentation/src/main/asciidoc/introduction for main features, links from existing documentation
• Add entries as relevant to migration-guide.adoc (breaking changes) and whats-new.adoc (new features/improvements)

Tasks specific to HHH-9912 (Bug):

• Add test reproducing the bug
• Add entries as relevant to migration-guide.adoc OR check there are no breaking changes

https://hibernate.atlassian.net/browse/HHH-15125

[sonarqubecloud]

Quality Gate failed

Failed conditions
66.0% Coverage on New Code (required ≥ 80%)

See analysis details on SonarQube Cloud

[hibernate-github-bot]

Thanks for your pull request!

This pull request does not follow the contribution rules. Could you have a look?

❌ All commit messages should start with a JIRA issue key matching pattern HHH-\d+
    ↳ Offending commits: [49b0e19, 9b7bc42, 7565cce, 3f866bd, a115b24, 68b7f5b, bf2bebf, b377c5e, d62b3e1, 6c795a8, 6351790, 9d97189, e887577, b684788]

› This message was automatically generated.

[hibernate-github-bot]

Thanks for your pull request!

This pull request does not follow the contribution rules. Could you have a look?

❌ All commit messages should start with a JIRA issue key matching pattern HHH-\d+
    ↳ Offending commits: [49b0e19, 9b7bc42, 7565cce, 3f866bd, a115b24, 68b7f5b, bf2bebf, b377c5e, d62b3e1, 6c795a8, 6351790, 9d97189, e887577, b684788]
❌ The PR title or body should list the keys of all JIRA issues mentioned in the commits
    ↳ Issue keys mentioned in commits but missing from the PR title or body: [HHH-20028, HHH-20134, HHH-20083, HHH-19951, HHH-19567, HHH-20097, HHH-20135, HHH-20062, HHH-9912, HHH-20141, HHH-20139, HHH-20295, HHH-20375, HHH-20368, HHH-20362, HHH-20369, HHH-20374, HHH-19933, HHH-20412, HHH-20415, HHH-19509]

› This message was automatically generated.

[jrenaat]

Messed up in a rebase somewhere. Will recreate the PR.