From 2fdba8aff4008817d980492ccf859507170d416e Mon Sep 17 00:00:00 2001 From: Marci W <333176+marciw@users.noreply.github.com> Date: Thu, 25 Sep 2025 12:14:31 -0400 Subject: [PATCH 1/6] Edits for consistency and reverse chron --- docs/release-notes/9-0-0.md | 6 ++-- docs/release-notes/9-0-4.md | 18 ++++++++--- docs/release-notes/9-1-0.md | 6 ++-- docs/release-notes/index.md | 11 +++++-- docs/release-notes/known-issues.md | 51 +++++++++++++++--------------- docs/release-notes/toc.yml | 4 +-- 6 files changed, 55 insertions(+), 41 deletions(-) diff --git a/docs/release-notes/9-0-0.md b/docs/release-notes/9-0-0.md index c7b25a216..baf96623d 100644 --- a/docs/release-notes/9-0-0.md +++ b/docs/release-notes/9-0-0.md @@ -5,7 +5,7 @@ navigation_title: "9.0.0" Discover what changed in the 9.0.0 version of the Java client. -### Breaking changes [elasticsearch-java-client-900-breaking-changes] +## Breaking changes [elasticsearch-java-client-900-breaking-changes] ::::{dropdown} Java version update While previous versions of the client used to target Java 8, from version 9.0 forward the client will target Java 17. @@ -353,7 +353,7 @@ For `DenseVectorProperty`, choose the Enum value that matches the old String. :::: -### Features and enhancements [elasticsearch-java-client-900-features-enhancements] +## Features and enhancements [elasticsearch-java-client-900-features-enhancements] ::::{dropdown} New ElasticsearchClient builder ElasticsearchClient now can be created with just a few lines of code: @@ -465,6 +465,6 @@ Example with `Aggregation`, where the `aggregations` field can now accept `Avera :::: -### Deprecations [elasticsearch-java-client-900-deprecations] +## Deprecations [elasticsearch-java-client-900-deprecations] Nothing was deprecated in this version of the client. diff --git a/docs/release-notes/9-0-4.md b/docs/release-notes/9-0-4.md index 529c2f866..a4bd3c2c5 100644 --- a/docs/release-notes/9-0-4.md +++ b/docs/release-notes/9-0-4.md @@ -3,12 +3,16 @@ navigation_title: "9.0.4" --- # Elasticsearch Java Client 9.0.4 [elasticsearch-java-client-904] -Discover what changed in the 9.0.4 version of the java client. +Discover what changed in the 9.0.4 version of the Java client. -### Features and enhancements [elasticsearch-java-client-904-features-enhancements] +## Breaking changes [elasticsearch-java-client-904-breaking-changes] -::::{dropdown} Added callbacks to Rest5Client builder -Rest5ClientBuilder now has the same level of in depth configuration the Legacy RestClientBuilder has, allowing to customize the underlying Apache HttpClient through callback functions; for example, this is how to configure the IOReactor's thread count: +There are no breaking changes in this version of the client. + +## Features and enhancements [elasticsearch-java-client-904-features-enhancements] + +### Added callbacks to Rest5Client builder +Rest5ClientBuilder now has the same level of in-depth configuration the Legacy RestClientBuilder has, allowing you to customize the underlying Apache HttpClient through callback functions. For example, this is how to configure the IOReactor's thread count: ```java Rest5ClientBuilder builder = Rest5Client .builder(new HttpHost("localhost", 9200)) @@ -18,7 +22,7 @@ Rest5ClientBuilder builder = Rest5Client ) ); ``` -And this is how to customize the response timeout: +Here's how to customize the response timeout: ```java Rest5ClientBuilder builder = Rest5Client .builder(new HttpHost("localhost", 9200)) @@ -29,3 +33,7 @@ Rest5ClientBuilder builder = Rest5Client ); ``` :::: + +## Deprecations [elasticsearch-java-client-904-deprecations] + +Nothing was deprecated in this version of the client. diff --git a/docs/release-notes/9-1-0.md b/docs/release-notes/9-1-0.md index bd74dcbeb..422b45ab8 100644 --- a/docs/release-notes/9-1-0.md +++ b/docs/release-notes/9-1-0.md @@ -5,7 +5,7 @@ navigation_title: "9.1.0" Discover what changed in the 9.1.0 version of the Java client. -### Breaking changes [elasticsearch-java-client-910-breaking-changes] +## Breaking changes [elasticsearch-java-client-910-breaking-changes] ::::{dropdown} Map to NamedValue Highlight.fields `fields` in `Highlight` was wrongly mapped as `List`, but the server doesn't actually accept more than one value, so the type has been changed to `List`. @@ -47,7 +47,7 @@ Example with `SearchRequest`: **Action**
Replace the missing class with the new class name. :::: -### Features and enhancements [elasticsearch-java-client-910-features-enhancements] +## Features and enhancements [elasticsearch-java-client-910-features-enhancements] ::::{dropdown} Opentelemetry update to stable conventions Following the stable release of Opentelemetry's database conventions, the client was updated to use the correct attribute names. @@ -70,6 +70,6 @@ catch (ElasticsearchException e){ More details in the PR: [#1041](https://github.com/elastic/elasticsearch-java/pull/1041) :::: -### Deprecations [elasticsearch-java-client-910-deprecations] +## Deprecations [elasticsearch-java-client-910-deprecations] Nothing was deprecated in this version of the client. diff --git a/docs/release-notes/index.md b/docs/release-notes/index.md index 4aededf2a..0a3b7bcfb 100644 --- a/docs/release-notes/index.md +++ b/docs/release-notes/index.md @@ -8,10 +8,15 @@ mapped_pages: Review the changes, fixes, and more in each version of Elasticsearch Java Client. -To check for security updates, go to [Security announcements for the Elastic stack](https://discuss.elastic.co/c/announcements/security-announcements/31). +To check for security updates, refer to [Security announcements for the Elastic stack](https://discuss.elastic.co/c/announcements/security-announcements/31). -## 9.0.0 -[Release notes](../release-notes/9-0-0.md) +To check for issues, refer to [Known issues](../release-notes/known-issues.md). ## 9.1.0 [Release notes](../release-notes/9-1-0.md) + +## 9.0.4 +[Release notes](../release-notes/9-0-4.md) + +## 9.0.0 +[Release notes](../release-notes/9-0-0.md) diff --git a/docs/release-notes/known-issues.md b/docs/release-notes/known-issues.md index 7529e30ce..5619e3e97 100644 --- a/docs/release-notes/known-issues.md +++ b/docs/release-notes/known-issues.md @@ -5,33 +5,12 @@ navigation_title: "Known issues" # Elasticsearch Java Client known issues [elasticsearch-java-client-known-issues] -We handle all of our issues in our [Github repo](https://github.com/elastic/elasticsearch-java/issues). +For detailed issues, refer to the [Java client repo](https://github.com/elastic/elasticsearch-java/issues). -### 8.16.7 [known-issues-8-16-7] -8.16.7 is the first patch released without a matching rest-client version, so the `elasticsearch-rest-client` dependency is missing, causing the following exception: -``` -Could not resolve dependencies for project -[ERROR] dependency: org.elasticsearch.client:elasticsearch-rest-client:jar:8.16.7 (compile) -[ERROR] Could not find artifact org.elasticsearch.client:elasticsearch-rest-client:jar:8.16.7 in central (https://repo.maven.apache.org/maven2) -``` -To use this version of the client, set the latest available version explicitly in the project: -```kotlin -// gradle -implementation("org.elasticsearch.client:elasticsearch-rest-client:8.16.6") -``` -```xml - - - org.elasticsearch.client - elasticsearch-rest-client - 8.16.6 - -``` - -### 9.0.0 [known-issues-9-0-0] +## 9.0.0 [known-issues-9-0-0] -The latest major version of the client doesn't depend on `elasticsearch-rest-client` anymore, as the new built in Rest5Client is available, but it does depend on the Apache `commons-logging` dependency, which is missing, causing the following exception: +The latest major version of the client uses the new built-in Rest5Client, instead of depending on `elasticsearch-rest-client`. But the client still depends on Apache `commons-logging`, which causes following exception when not available: ``` Exception in thread "main" java.lang.NoClassDefFoundError: org/apache/commons/logging/LogFactory at co.elastic.clients.transport.rest5_client.low_level.Rest5Client.(Rest5Client.java:115) @@ -40,7 +19,7 @@ Exception in thread "main" java.lang.NoClassDefFoundError: org/apache/commons/lo at co.elastic.clients.transport.ElasticsearchTransportConfig$Default.buildTransport(ElasticsearchTransportConfig.java:110) at co.elastic.clients.elasticsearch.ElasticsearchClient.of(ElasticsearchClient.java:190) ``` -To use the new Rest5Client, add the `commons-logging` dependency: +To fix this and use the new Rest5Client, add the `commons-logging` dependency: ```kotlin // gradle implementation("commons-logging:commons-logging:1.3.5") @@ -53,3 +32,25 @@ implementation("commons-logging:commons-logging:1.3.5") 1.3.5 ``` + +## 8.16.7 [known-issues-8-16-7] + +8.16.7 is the first patch released without a matching rest-client version. The `elasticsearch-rest-client` dependency is missing, causing the following exception: +``` +Could not resolve dependencies for project +[ERROR] dependency: org.elasticsearch.client:elasticsearch-rest-client:jar:8.16.7 (compile) +[ERROR] Could not find artifact org.elasticsearch.client:elasticsearch-rest-client:jar:8.16.7 in central (https://repo.maven.apache.org/maven2) +``` +To use this version of the client, set the latest available version explicitly in the project: +```kotlin +// gradle +implementation("org.elasticsearch.client:elasticsearch-rest-client:8.16.6") +``` +```xml + + + org.elasticsearch.client + elasticsearch-rest-client + 8.16.6 + +``` \ No newline at end of file diff --git a/docs/release-notes/toc.yml b/docs/release-notes/toc.yml index f6ce17622..f071ce447 100644 --- a/docs/release-notes/toc.yml +++ b/docs/release-notes/toc.yml @@ -1,6 +1,6 @@ toc: - file: index.md - file: known-issues.md - - file: 9-0-0.md - - file: 9-0-4.md - file: 9-1-0.md + - file: 9-0-4.md + - file: 9-0-0.md From 379585e092b5440a8e222acb400e6d4255374699 Mon Sep 17 00:00:00 2001 From: Marci W <333176+marciw@users.noreply.github.com> Date: Thu, 25 Sep 2025 12:18:24 -0400 Subject: [PATCH 2/6] missing word --- docs/release-notes/known-issues.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/release-notes/known-issues.md b/docs/release-notes/known-issues.md index 5619e3e97..eac4f2273 100644 --- a/docs/release-notes/known-issues.md +++ b/docs/release-notes/known-issues.md @@ -10,7 +10,7 @@ For detailed issues, refer to the [Java client repo](https://github.com/elastic/ ## 9.0.0 [known-issues-9-0-0] -The latest major version of the client uses the new built-in Rest5Client, instead of depending on `elasticsearch-rest-client`. But the client still depends on Apache `commons-logging`, which causes following exception when not available: +The latest major version of the client uses the new built-in Rest5Client, instead of depending on `elasticsearch-rest-client`. But the client still depends on Apache `commons-logging`, which causes the following exception when not available: ``` Exception in thread "main" java.lang.NoClassDefFoundError: org/apache/commons/logging/LogFactory at co.elastic.clients.transport.rest5_client.low_level.Rest5Client.(Rest5Client.java:115) From 5a153149676086c6eafd6bcbd78961946e49a8bf Mon Sep 17 00:00:00 2001 From: Marci W <333176+marciw@users.noreply.github.com> Date: Thu, 25 Sep 2025 12:41:50 -0400 Subject: [PATCH 3/6] spruce all the things --- docs/release-notes/9-0-4.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/release-notes/9-0-4.md b/docs/release-notes/9-0-4.md index a4bd3c2c5..65f1db81e 100644 --- a/docs/release-notes/9-0-4.md +++ b/docs/release-notes/9-0-4.md @@ -11,8 +11,8 @@ There are no breaking changes in this version of the client. ## Features and enhancements [elasticsearch-java-client-904-features-enhancements] -### Added callbacks to Rest5Client builder -Rest5ClientBuilder now has the same level of in-depth configuration the Legacy RestClientBuilder has, allowing you to customize the underlying Apache HttpClient through callback functions. For example, this is how to configure the IOReactor's thread count: +### Added callbacks to Rest5ClientBuilder +`Rest5ClientBuilder` now has the same level of in-depth configuration as the legacy `RestClientBuilder`, allowing you to customize the underlying Apache `HttpClient` through callback functions. For example, here's how to configure the `IOReactor` thread count: ```java Rest5ClientBuilder builder = Rest5Client .builder(new HttpHost("localhost", 9200)) From 639e64c5127e08b14f340854aaf004397e43a070 Mon Sep 17 00:00:00 2001 From: Marci W <333176+marciw@users.noreply.github.com> Date: Thu, 25 Sep 2025 12:43:49 -0400 Subject: [PATCH 4/6] ^^ --- docs/release-notes/known-issues.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/release-notes/known-issues.md b/docs/release-notes/known-issues.md index eac4f2273..29304a07d 100644 --- a/docs/release-notes/known-issues.md +++ b/docs/release-notes/known-issues.md @@ -10,7 +10,7 @@ For detailed issues, refer to the [Java client repo](https://github.com/elastic/ ## 9.0.0 [known-issues-9-0-0] -The latest major version of the client uses the new built-in Rest5Client, instead of depending on `elasticsearch-rest-client`. But the client still depends on Apache `commons-logging`, which causes the following exception when not available: +The latest major version of the client uses the new built-in `Rest5Client`, instead of depending on `elasticsearch-rest-client`. But the client still depends on Apache `commons-logging`, which causes the following exception when not available: ``` Exception in thread "main" java.lang.NoClassDefFoundError: org/apache/commons/logging/LogFactory at co.elastic.clients.transport.rest5_client.low_level.Rest5Client.(Rest5Client.java:115) @@ -19,7 +19,7 @@ Exception in thread "main" java.lang.NoClassDefFoundError: org/apache/commons/lo at co.elastic.clients.transport.ElasticsearchTransportConfig$Default.buildTransport(ElasticsearchTransportConfig.java:110) at co.elastic.clients.elasticsearch.ElasticsearchClient.of(ElasticsearchClient.java:190) ``` -To fix this and use the new Rest5Client, add the `commons-logging` dependency: +To fix this and use the new `Rest5Client`, add the `commons-logging` dependency: ```kotlin // gradle implementation("commons-logging:commons-logging:1.3.5") From 872fcbb50949e2551cc33e3bdef52e2ee49aac86 Mon Sep 17 00:00:00 2001 From: Marci W <333176+marciw@users.noreply.github.com> Date: Thu, 25 Sep 2025 15:58:12 -0400 Subject: [PATCH 5/6] Clarify known issue --- docs/release-notes/known-issues.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/release-notes/known-issues.md b/docs/release-notes/known-issues.md index 29304a07d..a01ce8244 100644 --- a/docs/release-notes/known-issues.md +++ b/docs/release-notes/known-issues.md @@ -10,7 +10,7 @@ For detailed issues, refer to the [Java client repo](https://github.com/elastic/ ## 9.0.0 [known-issues-9-0-0] -The latest major version of the client uses the new built-in `Rest5Client`, instead of depending on `elasticsearch-rest-client`. But the client still depends on Apache `commons-logging`, which causes the following exception when not available: +The 9.0.0 version of the client uses the new built-in `Rest5Client`, instead of depending on `elasticsearch-rest-client`. But the 9.0.0 client still depends on Apache `commons-logging`, which causes the following exception when not available: ``` Exception in thread "main" java.lang.NoClassDefFoundError: org/apache/commons/logging/LogFactory at co.elastic.clients.transport.rest5_client.low_level.Rest5Client.(Rest5Client.java:115) From 009b85a9296559bd5642da9b8f8d41a031a77ba5 Mon Sep 17 00:00:00 2001 From: Marci W <333176+marciw@users.noreply.github.com> Date: Thu, 25 Sep 2025 15:58:39 -0400 Subject: [PATCH 6/6] Clarify dependency issue --- docs/release-notes/known-issues.md | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/docs/release-notes/known-issues.md b/docs/release-notes/known-issues.md index a01ce8244..542818622 100644 --- a/docs/release-notes/known-issues.md +++ b/docs/release-notes/known-issues.md @@ -19,7 +19,9 @@ Exception in thread "main" java.lang.NoClassDefFoundError: org/apache/commons/lo at co.elastic.clients.transport.ElasticsearchTransportConfig$Default.buildTransport(ElasticsearchTransportConfig.java:110) at co.elastic.clients.elasticsearch.ElasticsearchClient.of(ElasticsearchClient.java:190) ``` -To fix this and use the new `Rest5Client`, add the `commons-logging` dependency: +This problem was [fixed](https://github.com/elastic/elasticsearch-java/pull/1010) in 9.0.1. + +To fix this issue in 9.0.0 and use the new `Rest5Client`, add the `commons-logging` dependency: ```kotlin // gradle implementation("commons-logging:commons-logging:1.3.5")