The official Java client for Elasticsearch.

Note: this project is still a work in progress. This client is meant to replace the existing Java High Level Client and remove all dependencies to the Elasticsearch server code base.

The Java client for Elasticsearch provides strongly typed requests and responses for all Elasticsearch APIs. It delegates protocol handling to an http client such as the Elasticsearch Low Level REST client that takes care of all transport-level concerns (http connection establishment and pooling, retries, etc).

The docs/design folder contains records of the major decisions in the design of the API. Most notably:

• Object construction is based on the fluent builder pattern.
• Nested objects can be constructed with builder lambdas, allowing for clean and expressive DSL-like code.
• Optional values are represented as null with @Nullable annotations instead of the newer Optional, the Java ecosystem being still very null-based.

While it's a work in progress, snapshots of this library are published on a Maven repository hosted on GitHub Packages.

Along with this library, you also need a JSON/object mapping library. elasticsearch-java has built-in support for Jackson and JSON-B implementations such as Eclipse Yasson.

This library requires at least Java 8.

Gradle project (Groovy flavor) setup using Jackson:

repositories { mavenCentral() maven { name = "GitHubPackages" url = uri("https://maven.pkg.github.com/elastic/elasticsearch-java") } } dependencies { implementation 'co.elastic.clients:elasticsearch-java:8.0.0-SNAPSHOT' implementation 'com.fasterxml.jackson.core:jackson-databind:2.12.3' }

// Create the low-level client RestClient restClient = RestClient.builder(new HttpHost("localhost", 9200)).build(); // Create the transport that provides JSON and http services to API clients Transport transport = new RestClientTransport(restClient, new JacksonJsonpMapper()); // And create our API client ElasticsearchClient client = new ElasticsearchClient(transport); // Search all items in an index that contains documents of type AppData SearchResponse search = client.search(s -> s .index("test-index"), AppData.class ); if (search.hits().hits().isEmpty()) { System.out.println("No match"); } else { for (Hit<AppData> hit : search.hits().hits()) { processAppData(hit._source()); } }

The main branch targets the upcoming Elasticsearch 8.0. Support is still incomplete as the API code is generated from the Elasticsearch Specification that is also still a work in progress.

As the work on the specification comes to completion, an additional 7.x branch will provide support for the corresponding versions of Elasticsearch.

While not complete, this library is already fairly usable. What's missing falls in two main categories, related to the Elasticsearch specification:

• incomplete support for some data types used in specification (e.g. unions). Until they have been implemented in the code generator, they are represented as raw JsonValue objects.
• incomplete APIs: as the API specification is still incomplete, so are their implementations in this library since their code is entirely generated from the spec.

See CONTRIBUTING.md

This software is licensed under the Apache License 2.0.