Merge branch 'main' into non-primitive-shortcuts

elastic · Aug 22, 2024 · 3de9a74 · 3de9a74
2 parents e6b2d26 + bf86580
commit 3de9a74
Show file tree

Hide file tree

Showing 80 changed files with 1,369 additions and 886 deletions.
diff --git a/docs/release-notes/release-highlights.asciidoc b/docs/release-notes/release-highlights.asciidoc
@@ -9,6 +9,45 @@ For a list of detailed changes, including bug fixes, please see the https://gith
 ==== Version 8.16
 * `ElasticsearchClient` is now `Closeable`. Closing a client object also closes the underlying transport - https://github.com/elastic/elasticsearch-java/pull/851[#851]
 
+[discrete]
+==== Version 8.15
+
+* New https://www.elastic.co/guide/en/elasticsearch/reference/current/connector-apis.html[Connector API] available
+* Fixed bug in BulkIngester - https://github.com/elastic/elasticsearch-java/pull/830[#830]
+* Various bug fixes, among which are https://github.com/elastic/elasticsearch-java/pull/844[#844], https://github.com/elastic/elasticsearch-java/pull/847[#847]
+* Changed builders for queries that use generic types, for example:
+
+** Old RangeQuery:
++
+[source,java]
+----
+RangeQuery ra = RangeQuery.of(r -> r  // no distinction between various types (date, term, number)
+    .field("day")
+    .gte(JsonData.of("2024-06-20"))   // must use custom json for fields because there's no defined type
+    .lte(JsonData.of("2024-07-05"))
+    .boost(1.0F)
+    .format("yyyy-MM-dd")
+    .relation(RangeRelation.Contains));
+----
++
+** New RangeQuery:
++
+[source,java]
+----
+RangeQuery ra = RangeQuery.of(r -> r
+    .date(d -> d             // choose query type before
+        .field("day")
+        .gte("20-06-24")    // field now only accepts valid type for the specified query
+        .lte("20-07-24")
+        .boost(1.0F)
+        .format("yyyy-MM-dd")
+        .relation(RangeRelation.Contains)));
+----
+
+[discrete]
+==== Version 8.14
+* No new feature.
+
 [discrete]
 ==== Version 8.13
 

diff --git a/java-client/src/main/java/co/elastic/clients/elasticsearch/cat/AliasesRequest.java b/java-client/src/main/java/co/elastic/clients/elasticsearch/cat/AliasesRequest.java
@@ -62,7 +62,7 @@
  * <p>
  * CAT APIs are only intended for human consumption using the command line or
  * the Kibana console. They are not intended for use by applications. For
- * application consumption, use the /_alias endpoints.
+ * application consumption, use the aliases API.
  * 
  * @see <a href="../doc-files/api-spec.html#cat.aliases.Request">API
  *      specification</a>

diff --git a/...-client/src/main/java/co/elastic/clients/elasticsearch/cat/ComponentTemplatesRequest.java b/...-client/src/main/java/co/elastic/clients/elasticsearch/cat/ComponentTemplatesRequest.java
@@ -59,7 +59,7 @@
  * <p>
  * CAT APIs are only intended for human consumption using the command line or
  * Kibana console. They are not intended for use by applications. For
- * application consumption, use the /_component_template endpoints.
+ * application consumption, use the get component template API.
  * 
  * @see <a href="../doc-files/api-spec.html#cat.component_templates.Request">API
  *      specification</a>

diff --git a/java-client/src/main/java/co/elastic/clients/elasticsearch/cat/CountRequest.java b/java-client/src/main/java/co/elastic/clients/elasticsearch/cat/CountRequest.java
@@ -57,13 +57,13 @@
 
 /**
  * Get a document count. Provides quick access to a document count for a data
- * stream, an index, or an entire cluster.n/ The document count only includes
- * live documents, not deleted documents which have not yet been removed by the
- * merge process.
+ * stream, an index, or an entire cluster. The document count only includes live
+ * documents, not deleted documents which have not yet been removed by the merge
+ * process.
  * <p>
  * CAT APIs are only intended for human consumption using the command line or
  * Kibana console. They are not intended for use by applications. For
- * application consumption, use /_count endpoints.
+ * application consumption, use the count API.
  * 
  * @see <a href="../doc-files/api-spec.html#cat.count.Request">API
  *      specification</a>

diff --git a/...lient/src/main/java/co/elastic/clients/elasticsearch/cat/ElasticsearchCatAsyncClient.java b/...lient/src/main/java/co/elastic/clients/elasticsearch/cat/ElasticsearchCatAsyncClient.java
@@ -72,7 +72,7 @@ public ElasticsearchCatAsyncClient withTransportOptions(@Nullable TransportOptio
 	 * <p>
 	 * CAT APIs are only intended for human consumption using the command line or
 	 * the Kibana console. They are not intended for use by applications. For
-	 * application consumption, use the /_alias endpoints.
+	 * application consumption, use the aliases API.
 	 * 
 	 * @see <a href=
 	 *      "https://www.elastic.co/guide/en/elasticsearch/reference/8.16/cat-alias.html">Documentation
@@ -92,7 +92,7 @@ public CompletableFuture<AliasesResponse> aliases(AliasesRequest request) {
 	 * <p>
 	 * CAT APIs are only intended for human consumption using the command line or
 	 * the Kibana console. They are not intended for use by applications. For
-	 * application consumption, use the /_alias endpoints.
+	 * application consumption, use the aliases API.
 	 * 
 	 * @param fn
 	 *            a function that initializes a builder to create the
@@ -113,7 +113,7 @@ public final CompletableFuture<AliasesResponse> aliases(
 	 * <p>
 	 * CAT APIs are only intended for human consumption using the command line or
 	 * the Kibana console. They are not intended for use by applications. For
-	 * application consumption, use the /_alias endpoints.
+	 * application consumption, use the aliases API.
 	 * 
 	 * @see <a href=
 	 *      "https://www.elastic.co/guide/en/elasticsearch/reference/8.16/cat-alias.html">Documentation
@@ -189,7 +189,7 @@ public CompletableFuture<AllocationResponse> allocation() {
 	 * <p>
 	 * CAT APIs are only intended for human consumption using the command line or
 	 * Kibana console. They are not intended for use by applications. For
-	 * application consumption, use the /_component_template endpoints.
+	 * application consumption, use the get component template API.
 	 * 
 	 * @see <a href=
 	 *      "https://www.elastic.co/guide/en/elasticsearch/reference/master/cat-component-templates.html">Documentation
@@ -210,7 +210,7 @@ public CompletableFuture<ComponentTemplatesResponse> componentTemplates(Componen
 	 * <p>
 	 * CAT APIs are only intended for human consumption using the command line or
 	 * Kibana console. They are not intended for use by applications. For
-	 * application consumption, use the /_component_template endpoints.
+	 * application consumption, use the get component template API.
 	 * 
 	 * @param fn
 	 *            a function that initializes a builder to create the
@@ -232,7 +232,7 @@ public final CompletableFuture<ComponentTemplatesResponse> componentTemplates(
 	 * <p>
 	 * CAT APIs are only intended for human consumption using the command line or
 	 * Kibana console. They are not intended for use by applications. For
-	 * application consumption, use the /_component_template endpoints.
+	 * application consumption, use the get component template API.
 	 * 
 	 * @see <a href=
 	 *      "https://www.elastic.co/guide/en/elasticsearch/reference/master/cat-component-templates.html">Documentation
@@ -248,13 +248,13 @@ public CompletableFuture<ComponentTemplatesResponse> componentTemplates() {
 
 	/**
 	 * Get a document count. Provides quick access to a document count for a data
-	 * stream, an index, or an entire cluster.n/ The document count only includes
-	 * live documents, not deleted documents which have not yet been removed by the
-	 * merge process.
+	 * stream, an index, or an entire cluster. The document count only includes live
+	 * documents, not deleted documents which have not yet been removed by the merge
+	 * process.
 	 * <p>
 	 * CAT APIs are only intended for human consumption using the command line or
 	 * Kibana console. They are not intended for use by applications. For
-	 * application consumption, use /_count endpoints.
+	 * application consumption, use the count API.
 	 * 
 	 * @see <a href=
 	 *      "https://www.elastic.co/guide/en/elasticsearch/reference/8.16/cat-count.html">Documentation
@@ -270,13 +270,13 @@ public CompletableFuture<CountResponse> count(CountRequest request) {
 
 	/**
 	 * Get a document count. Provides quick access to a document count for a data
-	 * stream, an index, or an entire cluster.n/ The document count only includes
-	 * live documents, not deleted documents which have not yet been removed by the
-	 * merge process.
+	 * stream, an index, or an entire cluster. The document count only includes live
+	 * documents, not deleted documents which have not yet been removed by the merge
+	 * process.
 	 * <p>
 	 * CAT APIs are only intended for human consumption using the command line or
 	 * Kibana console. They are not intended for use by applications. For
-	 * application consumption, use /_count endpoints.
+	 * application consumption, use the count API.
 	 * 
 	 * @param fn
 	 *            a function that initializes a builder to create the
@@ -293,13 +293,13 @@ public final CompletableFuture<CountResponse> count(
 
 	/**
 	 * Get a document count. Provides quick access to a document count for a data
-	 * stream, an index, or an entire cluster.n/ The document count only includes
-	 * live documents, not deleted documents which have not yet been removed by the
-	 * merge process.
+	 * stream, an index, or an entire cluster. The document count only includes live
+	 * documents, not deleted documents which have not yet been removed by the merge
+	 * process.
 	 * <p>
 	 * CAT APIs are only intended for human consumption using the command line or
 	 * Kibana console. They are not intended for use by applications. For
-	 * application consumption, use /_count endpoints.
+	 * application consumption, use the count API.
 	 * 
 	 * @see <a href=
 	 *      "https://www.elastic.co/guide/en/elasticsearch/reference/8.16/cat-count.html">Documentation
@@ -480,7 +480,7 @@ public CompletableFuture<HelpResponse> help() {
 	 * These metrics are retrieved directly from Lucene, which Elasticsearch uses
 	 * internally to power indexing and search. As a result, all document counts
 	 * include hidden nested documents. To get an accurate count of Elasticsearch
-	 * documents, use the /_cat/count or _count endpoints.
+	 * documents, use the cat count or count APIs.
 	 * <p>
 	 * CAT APIs are only intended for human consumption using the command line or
 	 * Kibana console. They are not intended for use by applications. For
@@ -515,7 +515,7 @@ public CompletableFuture<IndicesResponse> indices(IndicesRequest request) {
 	 * These metrics are retrieved directly from Lucene, which Elasticsearch uses
 	 * internally to power indexing and search. As a result, all document counts
 	 * include hidden nested documents. To get an accurate count of Elasticsearch
-	 * documents, use the /_cat/count or _count endpoints.
+	 * documents, use the cat count or count APIs.
 	 * <p>
 	 * CAT APIs are only intended for human consumption using the command line or
 	 * Kibana console. They are not intended for use by applications. For
@@ -551,7 +551,7 @@ public final CompletableFuture<IndicesResponse> indices(
 	 * These metrics are retrieved directly from Lucene, which Elasticsearch uses
 	 * internally to power indexing and search. As a result, all document counts
 	 * include hidden nested documents. To get an accurate count of Elasticsearch
-	 * documents, use the /_cat/count or _count endpoints.
+	 * documents, use the cat count or count APIs.
 	 * <p>
 	 * CAT APIs are only intended for human consumption using the command line or
 	 * Kibana console. They are not intended for use by applications. For
@@ -592,7 +592,7 @@ public CompletableFuture<MasterResponse> master() {
 	 * <p>
 	 * CAT APIs are only intended for human consumption using the Kibana console or
 	 * command line. They are not intended for use by applications. For application
-	 * consumption, use the /_ml/data_frame/analytics endpoints.
+	 * consumption, use the get data frame analytics jobs statistics API.
 	 * 
 	 * @see <a href=
 	 *      "https://www.elastic.co/guide/en/elasticsearch/reference/8.16/cat-dfanalytics.html">Documentation
@@ -612,7 +612,7 @@ public CompletableFuture<MlDataFrameAnalyticsResponse> mlDataFrameAnalytics(MlDa
 	 * <p>
 	 * CAT APIs are only intended for human consumption using the Kibana console or
 	 * command line. They are not intended for use by applications. For application
-	 * consumption, use the /_ml/data_frame/analytics endpoints.
+	 * consumption, use the get data frame analytics jobs statistics API.
 	 * 
 	 * @param fn
 	 *            a function that initializes a builder to create the
@@ -633,7 +633,7 @@ public final CompletableFuture<MlDataFrameAnalyticsResponse> mlDataFrameAnalytic
 	 * <p>
 	 * CAT APIs are only intended for human consumption using the Kibana console or
 	 * command line. They are not intended for use by applications. For application
-	 * consumption, use the /_ml/data_frame/analytics endpoints.
+	 * consumption, use the get data frame analytics jobs statistics API.
 	 * 
 	 * @see <a href=
 	 *      "https://www.elastic.co/guide/en/elasticsearch/reference/8.16/cat-dfanalytics.html">Documentation
@@ -656,7 +656,7 @@ public CompletableFuture<MlDataFrameAnalyticsResponse> mlDataFrameAnalytics() {
 	 * <p>
 	 * CAT APIs are only intended for human consumption using the Kibana console or
 	 * command line. They are not intended for use by applications. For application
-	 * consumption, use the /_ml/datafeeds endpoints.
+	 * consumption, use the get datafeed statistics API.
 	 * 
 	 * @see <a href=
 	 *      "https://www.elastic.co/guide/en/elasticsearch/reference/8.16/cat-datafeeds.html">Documentation
@@ -679,7 +679,7 @@ public CompletableFuture<MlDatafeedsResponse> mlDatafeeds(MlDatafeedsRequest req
 	 * <p>
 	 * CAT APIs are only intended for human consumption using the Kibana console or
 	 * command line. They are not intended for use by applications. For application
-	 * consumption, use the /_ml/datafeeds endpoints.
+	 * consumption, use the get datafeed statistics API.
 	 * 
 	 * @param fn
 	 *            a function that initializes a builder to create the
@@ -703,7 +703,7 @@ public final CompletableFuture<MlDatafeedsResponse> mlDatafeeds(
 	 * <p>
 	 * CAT APIs are only intended for human consumption using the Kibana console or
 	 * command line. They are not intended for use by applications. For application
-	 * consumption, use the /_ml/datafeeds endpoints.
+	 * consumption, use the get datafeed statistics API.
 	 * 
 	 * @see <a href=
 	 *      "https://www.elastic.co/guide/en/elasticsearch/reference/8.16/cat-datafeeds.html">Documentation
@@ -726,7 +726,7 @@ public CompletableFuture<MlDatafeedsResponse> mlDatafeeds() {
 	 * <p>
 	 * CAT APIs are only intended for human consumption using the Kibana console or
 	 * command line. They are not intended for use by applications. For application
-	 * consumption, use the /_ml/anomaly_detectors endpoints.
+	 * consumption, use the get anomaly detection job statistics API.
 	 * 
 	 * @see <a href=
 	 *      "https://www.elastic.co/guide/en/elasticsearch/reference/8.16/cat-anomaly-detectors.html">Documentation
@@ -749,7 +749,7 @@ public CompletableFuture<MlJobsResponse> mlJobs(MlJobsRequest request) {
 	 * <p>
 	 * CAT APIs are only intended for human consumption using the Kibana console or
 	 * command line. They are not intended for use by applications. For application
-	 * consumption, use the /_ml/anomaly_detectors endpoints.
+	 * consumption, use the get anomaly detection job statistics API.
 	 * 
 	 * @param fn
 	 *            a function that initializes a builder to create the
@@ -773,7 +773,7 @@ public final CompletableFuture<MlJobsResponse> mlJobs(
 	 * <p>
 	 * CAT APIs are only intended for human consumption using the Kibana console or
 	 * command line. They are not intended for use by applications. For application
-	 * consumption, use the /_ml/anomaly_detectors endpoints.
+	 * consumption, use the get anomaly detection job statistics API.
 	 * 
 	 * @see <a href=
 	 *      "https://www.elastic.co/guide/en/elasticsearch/reference/8.16/cat-anomaly-detectors.html">Documentation
@@ -793,7 +793,7 @@ public CompletableFuture<MlJobsResponse> mlJobs() {
 	 * <p>
 	 * CAT APIs are only intended for human consumption using the Kibana console or
 	 * command line. They are not intended for use by applications. For application
-	 * consumption, use the /_ml/trained_models endpoints.
+	 * consumption, use the get trained models statistics API.
 	 * 
 	 * @see <a href=
 	 *      "https://www.elastic.co/guide/en/elasticsearch/reference/8.16/cat-trained-model.html">Documentation
@@ -813,7 +813,7 @@ public CompletableFuture<MlTrainedModelsResponse> mlTrainedModels(MlTrainedModel
 	 * <p>
 	 * CAT APIs are only intended for human consumption using the Kibana console or
 	 * command line. They are not intended for use by applications. For application
-	 * consumption, use the /_ml/trained_models endpoints.
+	 * consumption, use the get trained models statistics API.
 	 * 
 	 * @param fn
 	 *            a function that initializes a builder to create the
@@ -834,7 +834,7 @@ public final CompletableFuture<MlTrainedModelsResponse> mlTrainedModels(
 	 * <p>
 	 * CAT APIs are only intended for human consumption using the Kibana console or
 	 * command line. They are not intended for use by applications. For application
-	 * consumption, use the /_ml/trained_models endpoints.
+	 * consumption, use the get trained models statistics API.
 	 * 
 	 * @see <a href=
 	 *      "https://www.elastic.co/guide/en/elasticsearch/reference/8.16/cat-trained-model.html">Documentation
@@ -1388,7 +1388,7 @@ public CompletableFuture<ThreadPoolResponse> threadPool() {
 	 * <p>
 	 * CAT APIs are only intended for human consumption using the Kibana console or
 	 * command line. They are not intended for use by applications. For application
-	 * consumption, use the /_transform endpoints.
+	 * consumption, use the get transform statistics API.
 	 * 
 	 * @see <a href=
 	 *      "https://www.elastic.co/guide/en/elasticsearch/reference/8.16/cat-transforms.html">Documentation
@@ -1407,7 +1407,7 @@ public CompletableFuture<TransformsResponse> transforms(TransformsRequest reques
 	 * <p>
 	 * CAT APIs are only intended for human consumption using the Kibana console or
 	 * command line. They are not intended for use by applications. For application
-	 * consumption, use the /_transform endpoints.
+	 * consumption, use the get transform statistics API.
 	 * 
 	 * @param fn
 	 *            a function that initializes a builder to create the
@@ -1427,7 +1427,7 @@ public final CompletableFuture<TransformsResponse> transforms(
 	 * <p>
 	 * CAT APIs are only intended for human consumption using the Kibana console or
 	 * command line. They are not intended for use by applications. For application
-	 * consumption, use the /_transform endpoints.
+	 * consumption, use the get transform statistics API.
 	 * 
 	 * @see <a href=
 	 *      "https://www.elastic.co/guide/en/elasticsearch/reference/8.16/cat-transforms.html">Documentation