Add deprecation headers to HLRC classes (#79754)

This commit adds the @deprecated annotation and Javadoc to HLRC classes.

Author: dakrone

client/rest-high-level/qa/ssl-enabled/src/javaRestTest/java/org/elasticsearch/client/documentation/EnrollmentDocumentationIT.java

@@ -28,6 +28,7 @@
 
 import static org.hamcrest.Matchers.startsWith;
 
+@SuppressWarnings("removal")
 public class EnrollmentDocumentationIT extends ESRestHighLevelClientTestCase {
     static Path HTTP_TRUSTSTORE;
 

client/rest-high-level/src/main/java/org/elasticsearch/client/AsyncSearchClient.java

@@ -19,6 +19,13 @@
 
 import static java.util.Collections.emptySet;
 
+/**
+ * @deprecated The High Level Rest Client is deprecated in favor of the
+ * <a href="https://www.elastic.co/guide/en/elasticsearch/client/java-api-client/current/introduction.html">
+ * Elasticsearch Java API Client</a>
+ */
+@Deprecated(since = "7.16.0", forRemoval = true)
+@SuppressWarnings("removal")
 public class AsyncSearchClient {
     private final RestHighLevelClient restHighLevelClient;
 

client/rest-high-level/src/main/java/org/elasticsearch/client/CcrClient.java

@@ -39,7 +39,13 @@
  * <p>
  * See the <a href="https://www.elastic.co/guide/en/elasticsearch/reference/current/ccr-apis.html">
  * X-Pack Rollup APIs on elastic.co</a> for more information.
+ *
+ * @deprecated The High Level Rest Client is deprecated in favor of the
+ * <a href="https://www.elastic.co/guide/en/elasticsearch/client/java-api-client/current/introduction.html">
+ * Elasticsearch Java API Client</a>
  */
+@Deprecated(since = "7.16.0", forRemoval = true)
+@SuppressWarnings("removal")
 public final class CcrClient {
 
     private final RestHighLevelClient restHighLevelClient;

client/rest-high-level/src/main/java/org/elasticsearch/client/ClusterClient.java

@@ -34,7 +34,13 @@
  * A wrapper for the {@link RestHighLevelClient} that provides methods for accessing the Cluster API.
  * <p>
  * See <a href="https://www.elastic.co/guide/en/elasticsearch/reference/current/cluster.html">Cluster API on elastic.co</a>
+ *
+ * @deprecated The High Level Rest Client is deprecated in favor of the
+ * <a href="https://www.elastic.co/guide/en/elasticsearch/client/java-api-client/current/introduction.html">
+ * Elasticsearch Java API Client</a>
  */
+@Deprecated(since = "7.16.0", forRemoval = true)
+@SuppressWarnings("removal")
 public final class ClusterClient {
     private final RestHighLevelClient restHighLevelClient;
 

client/rest-high-level/src/main/java/org/elasticsearch/client/EnrichClient.java

@@ -27,7 +27,13 @@
  * <p>
  * See the <a href="https://www.elastic.co/guide/en/elasticsearch/reference/current/enrich-apis.html">
  * X-Pack Enrich Policy APIs on elastic.co</a> for more information.
+ *
+ * @deprecated The High Level Rest Client is deprecated in favor of the
+ * <a href="https://www.elastic.co/guide/en/elasticsearch/client/java-api-client/current/introduction.html">
+ * Elasticsearch Java API Client</a>
  */
+@Deprecated(since = "7.16.0", forRemoval = true)
+@SuppressWarnings("removal")
 public final class EnrichClient {
 
     private final RestHighLevelClient restHighLevelClient;

client/rest-high-level/src/main/java/org/elasticsearch/client/EqlClient.java

@@ -23,7 +23,13 @@
  * <p>
  * See the <a href="https://www.elastic.co/guide/en/elasticsearch/reference/current/eql.html">
  * EQL APIs on elastic.co</a> for more information.
+ *
+ * @deprecated The High Level Rest Client is deprecated in favor of the
+ * <a href="https://www.elastic.co/guide/en/elasticsearch/client/java-api-client/current/introduction.html">
+ * Elasticsearch Java API Client</a>
  */
+@Deprecated(since = "7.16.0", forRemoval = true)
+@SuppressWarnings("removal")
 public final class EqlClient {
 
     private final RestHighLevelClient restHighLevelClient;

client/rest-high-level/src/main/java/org/elasticsearch/client/FeaturesClient.java

@@ -22,7 +22,13 @@
  * A wrapper for the {@link RestHighLevelClient} that provides methods for accessing the Snapshot API.
  * <p>
  * See <a href="https://www.elastic.co/guide/en/elasticsearch/reference/current/features-apis.html">Snapshot API on elastic.co</a>
+ *
+ * @deprecated The High Level Rest Client is deprecated in favor of the
+ * <a href="https://www.elastic.co/guide/en/elasticsearch/client/java-api-client/current/introduction.html">
+ * Elasticsearch Java API Client</a>
  */
+@Deprecated(since = "7.16.0", forRemoval = true)
+@SuppressWarnings("removal")
 public class FeaturesClient {
     private final RestHighLevelClient restHighLevelClient;
 

client/rest-high-level/src/main/java/org/elasticsearch/client/GraphClient.java

@@ -16,7 +16,13 @@
 
 import static java.util.Collections.emptySet;
 
-
+/**
+ * @deprecated The High Level Rest Client is deprecated in favor of the
+ * <a href="https://www.elastic.co/guide/en/elasticsearch/client/java-api-client/current/introduction.html">
+ * Elasticsearch Java API Client</a>
+ */
+@Deprecated(since = "7.16.0", forRemoval = true)
+@SuppressWarnings("removal")
 public class GraphClient {
     private final RestHighLevelClient restHighLevelClient;
 

client/rest-high-level/src/main/java/org/elasticsearch/client/IndexLifecycleClient.java

@@ -40,6 +40,13 @@
 
 import static java.util.Collections.emptySet;
 
+/**
+ * @deprecated The High Level Rest Client is deprecated in favor of the
+ * <a href="https://www.elastic.co/guide/en/elasticsearch/client/java-api-client/current/introduction.html">
+ * Elasticsearch Java API Client</a>
+ */
+@Deprecated(since = "7.16.0", forRemoval = true)
+@SuppressWarnings("removal")
 public class IndexLifecycleClient {
     private final RestHighLevelClient restHighLevelClient;
 

client/rest-high-level/src/main/java/org/elasticsearch/client/IndicesClient.java

@@ -81,7 +81,13 @@
  * A wrapper for the {@link RestHighLevelClient} that provides methods for accessing the Indices API.
  * <p>
  * See <a href="https://www.elastic.co/guide/en/elasticsearch/reference/current/indices.html">Indices API on elastic.co</a>
+ *
+ * @deprecated The High Level Rest Client is deprecated in favor of the
+ * <a href="https://www.elastic.co/guide/en/elasticsearch/client/java-api-client/current/introduction.html">
+ * Elasticsearch Java API Client</a>
  */
+@Deprecated(since = "7.16.0", forRemoval = true)
+@SuppressWarnings("removal")
 public final class IndicesClient {
     private final RestHighLevelClient restHighLevelClient;