Get started with the serverless Java client
editGet started with the serverless Java client
edit[preview] This functionality is in technical preview and may be changed or removed in a future release. Elastic will work to fix any issues, but features in technical preview are not subject to the support SLA of official GA features.
This page guides you through the installation process of the Java client for Elasticsearch Serverless, shows you how to initialize the client, and how to perform basic Elasticsearch operations with it.
Requirements
edit- Java 8 or later.
- A JSON object mapping library to allow seamless integration of your application classes with the Elasticsearch API. The examples below show usage with Jackson.
Installation
editYou can add the Java client to your Java project using either Gradle or Maven.
Using Gradle
editYou can install the Java client as a Gradle dependency:
dependencies { implementation 'co.elastic.clients:elasticsearch-java-serverless:1.0.0-20231031' implementation 'com.fasterxml.jackson.core:jackson-databind:2.17.0' }
Using Maven
editYou can install the Java client as a Maven dependency, add
the following to the pom.xml
of your project:
<project> <dependencies> <dependency> <groupId>co.elastic.clients</groupId> <artifactId>elasticsearch-java-serverless</artifactId> <version>1.0.0-20231031</version> </dependency> <dependency> <groupId>com.fasterxml.jackson.core</groupId> <artifactId>jackson-databind</artifactId> <version>2.17.0</version> </dependency> </dependencies> </project>
Initialize the client
editInitialize the client using your API key and Elasticsearch Endpoint:
// URL and API key String serverUrl = "https://...elastic.cloud"; String apiKey = "VnVhQ2ZHY0JDZGJrU..."; // Create the low-level client RestClient restClient = RestClient .builder(HttpHost.create(serverUrl)) .setDefaultHeaders(new Header[]{ new BasicHeader("Authorization", "ApiKey " + apiKey) }) .build(); // Create the transport with a Jackson mapper ElasticsearchTransport transport = new RestClientTransport( restClient, new JacksonJsonpMapper()); // And create the API client ElasticsearchClient esClient = new ElasticsearchClient(transport);
To get API keys or the Elasticsearch Endpoint for a project, see Get started.
Using the API
editAfter you initialized the client, you can start ingesting documents.
Creating an index and ingesting documents
editThe following is an example of indexing a document, here a Product
application
object in the products
index:
Product product = new Product("bk-1", "City bike", 123.0); IndexResponse response = esClient.index(i -> i .index("products") .id(product.getSku()) .document(product) ); logger.info("Indexed with version " + response.version());
Searching
editNow that some data is available, you can search your documents using the
search
API:
String searchText = "bike"; SearchResponse<Product> response = esClient.search(s -> s .index("products") .query(q -> q .match(t -> t .field("name") .query(searchText) ) ), Product.class );
A few things to note in the above example:
- The search query is built using a hierarchy of lambda expressions that closely follows the Elasticsearch HTTP API. Lambda expressions allows you to be guided by your IDE’s autocompletion, without having to import (or even know!) the actual classes representing a query.
-
The last parameter
Product.class
instructs the client to return results asProduct
application objects instead of raw JSON.
Updating
editYou can update your documents using the update
API:
Product product = new Product("bk-1", "City bike", 123.0); esClient.update(u -> u .index("products") .id("bk-1") .upsert(product), Product.class );
Delete
editYou can also delete documents:
esClient.delete(d -> d.index("products").id("bk-1"));
Deleting an index
editesClient.indices().delete(d -> d.index("products"));