Query shape representation class structure

[deshsidd]

Changes part of Grouping Top N queries by similarity (https://github.com/opensearch-project/OpenSearch/issues/13419), to create the query shape representation class structure.

RFC: https://github.com/opensearch-project/OpenSearch/issues/13357

Description

As part of grouping Top N queries by similarity (https://github.com/opensearch-project/OpenSearch/issues/13357), the first set of changes are defining a class structure to represent the "Query Shape".

The following should be kept in mind when designing the class structure:

• Should be flexible and extensible in the future
• Should capture the 4 components of a query shape (https://github.com/opensearch-project/OpenSearch/issues/13357)
• Should be hashable taking required normalization into consideration
• Should be easy to export the query shape as a string, json if required

Related Issues

https://github.com/opensearch-project/OpenSearch/issues/13419

Check List

• [x] New functionality includes testing.
  • [x] All tests pass
• [x] New functionality has been documented.
  • [x] New functionality has javadoc added
• [x] Failing checks are inspected and point to the corresponding known issue(s) (See: Troubleshooting Failing Builds)
• [x] Commits are signed per the DCO using --signoff
• [x] Commit changes are listed out in CHANGELOG.md file (See: Changelog)
• [x] Public documentation issue/PR created

By submitting this pull request, I confirm that my contribution is made under the terms of the Apache 2.0 license. For more information on following Developer Certificate of Origin and signing off your commits, please check here.

[github-actions[bot]]

:x: Gradle check result for d56c5fe3a79222fa5a9dcd612f9a9f2dbe1fbace: FAILURE

Please examine the workflow log, locate, and copy-paste the failure(s) below, then iterate to green. Is the failure a flaky test unrelated to your change?

[github-actions[bot]]

:x: Gradle check result for 5ab6e6821acefb9be16429dc1af68667f948a676: FAILURE

Please examine the workflow log, locate, and copy-paste the failure(s) below, then iterate to green. Is the failure a flaky test unrelated to your change?

[github-actions[bot]]

:x: Gradle check result for 74f058a619ab8f705580d1bb5f1522bfb4d01f67: FAILURE

Please examine the workflow log, locate, and copy-paste the failure(s) below, then iterate to green. Is the failure a flaky test unrelated to your change?

[deshsidd]

Discussed this with @msfroh and it makes sense to have a wrapper around the original query builder classes rather than creating a new parallel hierarchy. This will not be maintainable and will be hard to handle new querybuilders and querybuilders defined in plugins. Will close this for now and open up a new PR.