Skip to content

Add 9.1 docs #1043

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 1 commit into from
Jul 29, 2025
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
6 changes: 5 additions & 1 deletion docs/reference/release-highlights.md
Original file line number Diff line number Diff line change
Expand Up @@ -9,6 +9,10 @@ These are the important new features and changes in minor releases. Every releas

For a list of detailed changes, including bug fixes, see the [GitHub project release notes](https://github.com/elastic/elasticsearch-java/releases).

## 9.1.0 [release-highlights-910]

[Release notes](/release-notes/9-1-0.md)

## 9.0.0 [release-highlights-900]

[Release notes](/release-notes/9-0-0.md)
Expand Down Expand Up @@ -36,4 +40,4 @@ To view release notes for earlier versions, use the version dropdown in the top

#### 8.15 [_version_8_15]

[Release notes](https://www.elastic.co/guide/en/elasticsearch/client/java-api-client/8.15/release-highlights.html)
[Release notes](https://www.elastic.co/guide/en/elasticsearch/client/java-api-client/8.15/release-highlights.html)
2 changes: 1 addition & 1 deletion docs/release-notes/9-0-4.md
Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,7 @@ navigation_title: "9.0.4"

Discover what changed in the 9.0.4 version of the java client.

### Features and enhancements [elasticsearch-java-client-900-features-enhancements]
### Features and enhancements [elasticsearch-java-client-904-features-enhancements]

::::{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:
Expand Down
75 changes: 75 additions & 0 deletions docs/release-notes/9-1-0.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,75 @@
---
navigation_title: "9.1.0"
---
# Elasticsearch Java Client 9.1.0 [elasticsearch-java-client-910]

Discover what changed in the 9.1.0 version of the Java client.

### Breaking changes [elasticsearch-java-client-910-breaking-changes]

::::{dropdown} Map to NamedValue Highlight.fields
`fields` in `Highlight` was wrongly mapped as `List<Map>`, but the server doesn't actually accept more than one value, so the type has been changed to `List<NamedValue>`.

**Action**<br> Change the builder to use the correct type.
Example with `SearchRequest`:
- Old
```java
esClient.search(s -> s
.index("*")
.highlight(h -> h
.fields(Map.of("highlighter-field", HighlightField.of(hf -> hf...)))
)
,Void.class);
```
- New
```java
esClient.search(s -> s
.index("*")
.highlight(h -> h
.fields(NamedValue.of("highlighter-field", HighlightField.of(hf -> hf...)))
)
,Void.class);
```

::::

::::{dropdown} Map to List<Map> WeightedTokensQuery.tokens
`tokens` in `WeightedTokensQuery` was mapped as `Map`, but the server can actually accept more than one map, so the type has been changed to `List<Map>`.

**Action**<br> Nothing should be changed since the builders for List also accept a single value.
::::

::::

::::{dropdown} Class name change: IndicesBlockStatus -> AddIndicesBlockStatus in AddBlockResponse
`IndicesBlockStatus` was renamed to `AddIndicesBlockStatus` to avoid confusion with the new `RemoveIndicesBlockStatus`

**Action**<br> Replace the missing class with the new class name.
::::

### 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.
More details in the PR: https://github.com/elastic/elasticsearch-java/pull/1017
::::

::::{dropdown} GetAliasResponse exception bug fix
`GetAliasesResponse` is a special case because it can return both an exception and the actual response, in case 2 aliases, 1 present and 1 missing, are added to `GetAliasesRequest`. The java client was unable to parse the response and used to throw a `TransportException`, this was fixed by adding the additional alias information to the `metadata` field in `ErrorCause`:
```java
try{
client.indices().getAlias(a -> a.name("test","test2"));
}
catch (ElasticsearchException e){
Map<String, JsonData> metadata = e.error().metadata();
JsonData index = metadata.get("example-index");
Map aliases = index.to(Map.class);
assertEquals("test", aliases.keySet().iterator().next());
}
```
More details in the PR: https://github.com/elastic/elasticsearch-java/pull/1041
::::

### Deprecations [elasticsearch-java-client-910-deprecations]

Nothing was deprecated in this version of the client.
3 changes: 3 additions & 0 deletions docs/release-notes/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -12,3 +12,6 @@ To check for security updates, go to [Security announcements for the Elastic sta

## 9.0.0
[Release notes](../release-notes/9-0-0.md)

## 9.0.1
[Release notes](../release-notes/9-1-0.md)
1 change: 1 addition & 0 deletions docs/release-notes/toc.yml
Original file line number Diff line number Diff line change
Expand Up @@ -3,3 +3,4 @@ toc:
- file: known-issues.md
- file: 9-0-0.md
- file: 9-0-4.md
- file: 9-1-0.md
Loading