Adding WithFieldName interface for QueryBuilders with fieldName

[dzane17]

Description

Adding WithFieldName interface and update QueryBuilder classes that conform - have a fieldName() implementation.

In the Query-Insights plugin, we would like to append fieldName and fieldType data during query shape construction. Some *QueryBuilder classes already provide a fieldName() method, but not all query types necessarily operate on a single field. Adding the WithFieldName interface provides a uniform way to type-check any *QueryBuilder instance and get a singular fieldName when possible. Also once fieldName is known, we can lookup fieldType via index mappings.

Related Issues

Related RFC opensearch-project/query-insights#69

Check List

• Functionality includes testing.
• API changes companion pull request created, if applicable.
• Public documentation issue/PR created, if applicable.

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]

❌ Gradle check result for 089eede: 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?

[jainankitk]

@msfroh - Can you also provide your feedback on this PR?

[jainankitk]

@dzane17 - Can you add CHANGELOG.md for this change?

[opensearch-trigger-bot]

The backport to 2.17 failed:

The process '/usr/bin/git' failed with exit code 1

To backport manually, run these commands in your terminal:

# Navigate to the root of your repository
cd $(git rev-parse --show-toplevel)
# Fetch latest updates from GitHub
git fetch
# Create a new working tree
git worktree add ../.worktrees/OpenSearch/backport-2.17 2.17
# Navigate to the new working tree
pushd ../.worktrees/OpenSearch/backport-2.17
# Create a new branch
git switch --create backport/backport-15705-to-2.17
# Cherry-pick the merged commit of this pull request and resolve the conflicts
git cherry-pick -x --mainline 1 f5c897cf1db3d413c6ccd9bcad1284a7873a1556
# Push it to GitHub
git push --set-upstream origin backport/backport-15705-to-2.17
# Go back to the original working tree
popd
# Delete the working tree
git worktree remove ../.worktrees/OpenSearch/backport-2.17

Then, create a pull request where the base branch is 2.17 and the compare/head branch is backport/backport-15705-to-2.17.

[codecov]

Codecov Report

All modified and coverable lines are covered by tests ✅

Project coverage is 71.97%. Comparing base (6f2ea39) to head (e59c4d9).
Report is 5 commits behind head on main.

Additional details and impacted files

@@             Coverage Diff              @@
##               main   #15705      +/-   ##
============================================
+ Coverage     71.95%   71.97%   +0.01%     
- Complexity    64196    64204       +8     
============================================
  Files          5271     5271              
  Lines        300171   300171              
  Branches      43380    43380              
============================================
+ Hits         215990   216037      +47     
+ Misses        66476    66401      -75     
- Partials      17705    17733      +28     

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.