[2.x] Deprecate public methods and variables that contain 'master' terminology in 'client' directory (#3966)

[tlfeng]

Description

Backport PR #3966 / commit ccf1d15 to 2.x branch

Issues Resolved

To support inclusive language, the master terminology is going to be replaced by cluster manager in the code base.
This PR deprecate public and protected methods/variable that contains master terminology in the name in client directory, and create alternatives.

List of public methods to be renamed in client directory:

public void setMasterTimeout(TimeValue clusterManagerTimeout)
public TimeValue masterNodeTimeout()
public TimeValue getMasterNodeTimeout()
public void setMasterNodeTimeout(@Nullable TimeValue clusterManagerNodeTimeout)
public void setMasterNodeTimeout(String clusterManagerNodeTimeout)
public boolean isMasterEligible()

List of public variables to be renamed in client directory:

public static final TimeValue DEFAULT_MASTER_NODE_TIMEOUT

Other changes:

• 1 String type usage:
  

  OpenSearch/client/rest/src/main/java/org/opensearch/client/NodeSelector.java

  Line 102 in 31f4b7a

  return "SKIP_DEDICATED_MASTERS";

The method Params withMasterTimeout(TimeValue masterTimeout) remains not changed, because master_timeout parameter of the REST APIs is not deprecated in version 2.x

OpenSearch/client/rest-high-level/src/main/java/org/opensearch/client/RequestConverters.java

Line 894 in 79cabaf

Params withMasterTimeout(TimeValue masterTimeout) {

Check List

• New functionality includes testing.
  • All tests pass
• New functionality has been documented.
  • New functionality has javadoc added
• Commits are signed per the DCO using --signoff

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.

[codecov-commenter]

Codecov Report

Merging #3981 (d2fe0ef) into 2.x (0a42e6d) will increase coverage by 0.09%.
The diff coverage is 35.29%.

@@             Coverage Diff              @@
##                2.x    #3981      +/-   ##
============================================
+ Coverage     70.55%   70.64%   +0.09%     
- Complexity    56382    56445      +63     
============================================
  Files          4526     4526              
  Lines        271760   271785      +25     
  Branches      39978    39980       +2     
============================================
+ Hits         191733   192011     +278     
+ Misses        63869    63644     -225     
+ Partials      16158    16130      -28     

Impacted Files	Coverage Δ
...rg/opensearch/client/ClusterRequestConverters.java	44.28% <0.00%> (ø)
...h/client/indices/GetComponentTemplatesRequest.java	0.00% <0.00%> (ø)
...ent/indices/GetComposableIndexTemplateRequest.java	0.00% <0.00%> (ø)
...rest/src/main/java/org/opensearch/client/Node.java	90.74% <0.00%> (-1.72%)	⬇️
...earch/client/indices/GetIndexTemplatesRequest.java	53.84% <22.22%> (-11.16%)	⬇️
...rg/opensearch/client/IndicesRequestConverters.java	70.67% <72.72%> (ø)
.../main/java/org/opensearch/client/NodeSelector.java	78.57% <75.00%> (+3.57%)	⬆️
.../main/java/org/opensearch/client/TimedRequest.java	93.33% <83.33%> (-6.67%)	⬇️
...luster/routing/allocation/RoutingExplanations.java	41.37% <0.00%> (-58.63%)	⬇️
.../admin/cluster/reroute/ClusterRerouteResponse.java	55.00% <0.00%> (-45.00%)	⬇️
... and 473 more

Help us with your feedback. Take ten seconds to tell us how you rate us.

[github-actions]

Gradle Check (Jenkins) Run Completed with:

• RESULT: FAILURE ❌
• URL: https://build.ci.opensearch.org/job/gradle-check/906/
• CommitID: dfc20c545baa40de357c0ca097f055ad2bb286f2

[github-actions]

Gradle Check (Jenkins) Run Completed with:

• RESULT: FAILURE ❌
• URL: https://build.ci.opensearch.org/job/gradle-check/932/
• CommitID: d2fe0ef

[tlfeng]

In build 932, the test failure is reported in issue #3579

[github-actions]

Gradle Check (Jenkins) Run Completed with:

• RESULT: FAILURE ❌
• URL: https://build.ci.opensearch.org/job/gradle-check/933/
• CommitID: d2fe0ef

[tlfeng]

In log 933, the same failure as above.

[github-actions]

Gradle Check (Jenkins) Run Completed with:

• RESULT: SUCCESS ✅
• URL: https://build.ci.opensearch.org/job/gradle-check/934/
• CommitID: d2fe0ef

[opensearch-trigger-bot]

The backport to 2.x failed:

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

To backport manually, run these commands in your terminal:

# Fetch latest updates from GitHub
git fetch
# Create a new working tree
git worktree add .worktrees/backport-2.x 2.x
# Navigate to the new working tree
cd .worktrees/backport-2.x
# Create a new branch
git switch --create backport/backport-3981-to-2.x
# Cherry-pick the merged commit of this pull request and resolve the conflicts
git cherry-pick -x --mainline 1 257e3b8de96533b838ebf4d0c77b2bc1bf9d2ab1
# Push it to GitHub
git push --set-upstream origin backport/backport-3981-to-2.x
# Go back to the original working tree
cd ../..
# Delete the working tree
git worktree remove .worktrees/backport-2.x

Then, create a pull request where the base branch is 2.x and the compare/head branch is backport/backport-3981-to-2.x.