How elastic/elasticsearch-java works
This is the official Elasticsearch Java client: applications build typed API requests, invoke client methods, and receive typed responses or errors over an HTTP transport. Its documented API coverage spans document and index operations, search, inference, and cluster-management APIs; helper branches include bulk ingestion and ESQL adapters. The excerpts establish the shared client, transport, endpoint, and JSON-mapping responsibilities. Several product subsystems are represented by paths from the tree and README capabilities, but their internal calls were not sampled, so uncertain links are omitted.
Main entry points: ElasticsearchClient.java Elasticsearch client · Transport.java Transport interface · Endpoint.java Request endpoints · ApiClient.java API client base
Components 22
Typed API
- Elasticsearch client
java-client/src/main/java/co/elastic/clients/elasticsearch/ElasticsearchClient.java - Async client
java-client/src/main/java/co/elastic/clients/elasticsearch/ElasticsearchAsyncClient.java - API client base
java-client/src/main/java/co/elastic/clients/ApiClient.java - Request endpoints
java-client/src/main/java/co/elastic/clients/transport/Endpoint.java - Typed API models
java-client/src/main/java/co/elastic/clients/elasticsearch/_types
Transport
- Transport interface
java-client/src/main/java/co/elastic/clients/transport/Transport.java - REST transport
rest5-client/src/main/java/co/elastic/clients/transport/rest5_client/low_level/Rest5Client.java - Netty transport
example-transports/src/main/java/co/elastic/clients/transport/netty/NettyElasticsearchTransport.java
JSON Mapping
- JSON mapper
java-client/src/main/java/co/elastic/clients/json/JsonpMapper.java - JSON deserializers
java-client/src/main/java/co/elastic/clients/json/JsonpDeserializer.java - Object deserializer
java-client/src/main/java/co/elastic/clients/json/ObjectDeserializer.java - Error responses
java-client/src/main/java/co/elastic/clients/elasticsearch/_types/ErrorResponse.java
Client Helpers
- Bulk ingester
java-client/src/main/java/co/elastic/clients/elasticsearch/_helpers/bulk/BulkIngester.java - ESQL adapters
java-client/src/main/java/co/elastic/clients/elasticsearch/_helpers/esql - Vector helpers
java-client/src/main/java/co/elastic/clients/elasticsearch/_helpers/vector/AbstractBase64VectorDocument.java
API Domains
- Search and documents
java-client/src/main/java/co/elastic/clients/elasticsearch/ElasticsearchClient.java - Inference APIs
java-client/src/main/java/co/elastic/clients/elasticsearch/inference/ElasticsearchInferenceClient.java - Ingest APIs
java-client/src/main/java/co/elastic/clients/elasticsearch/ingest/ElasticsearchIngestClient.java - Query rules APIs
java-client/src/main/java/co/elastic/clients/elasticsearch/query_rules/ElasticsearchQueryRulesClient.java - Other API clients
java-client/src/main/java/co/elastic/clients/elasticsearch
Other components
- Java application
- Elasticsearch
Connections 23
- Java application → Elasticsearch client: calls
README.md - Elasticsearch client → API client base: extends
java-client/src/main/java/co/elastic/clients/elasticsearch/ElasticsearchClient.java - Async client → API client base: extends
- API client base → Transport interface: uses
java-client/src/main/java/co/elastic/clients/ApiClient.java - Elasticsearch client → Request endpoints: dispatches
- Async client → Request endpoints: dispatches
- Transport interface → Elasticsearch: sends HTTP
README.md - Transport interface → REST transport: implemented by
README.md - Transport interface → Netty transport: implemented by
- Transport interface → JSON mapper: provides
java-client/src/main/java/co/elastic/clients/transport/Transport.java - JSON mapper → JSON deserializers: deserializes
java-client/src/main/java/co/elastic/clients/json/JsonpDeserializer.java - JSON deserializers → Object deserializer: supports
java-client/src/main/java/co/elastic/clients/json/ObjectDeserializer.java - Request endpoints → Typed API models: encodes requests
- Request endpoints → JSON mapper: defines decoding
java-client/src/main/java/co/elastic/clients/transport/Endpoint.java - Error responses → Typed API models: contains error
java-client/src/main/java/co/elastic/clients/elasticsearch/_types/ErrorResponse.java - Elasticsearch client → Search and documents: supports
README.md - Elasticsearch client → Inference APIs: supports
- Elasticsearch client → Ingest APIs: supports
- Elasticsearch client → Query rules APIs: supports
- Elasticsearch client → Other API clients: supports
README.md - Bulk ingester → Elasticsearch client: assists writes
- ESQL adapters → Elasticsearch client: adapts results
- Vector helpers → Elasticsearch client: supports vectors