Elasticsearch 在 Java 中的使用示例教程

更新時間：2024年08月20日 12:22:20 作者：boydoy1987

本文介紹了如何在Java中使用Elasticsearch,涵蓋了連接、基本CRUD 操作、復雜查詢、索引管理和聚合操作等方面的內容,通過示例,開發(fā)者可以一步步地掌握如何在 Java 項目中集成 Elasticsearch,并利用其強大的搜索和分析功能來構建高效的應用程序,感興趣的朋友一起看看吧

1. Elasticsearch 簡介

Elasticsearch 是一個分布式搜索和分析引擎，基于 Apache Lucene 構建，能夠實現(xiàn)實時數(shù)據(jù)的存儲、搜索、和分析。它廣泛應用于全文搜索、日志分析、性能監(jiān)控等領域。Elasticsearch 的核心概念包括文檔（document）、索引（index）、和分片（shard）。

2. 環(huán)境準備

2.1 安裝 Elasticsearch

從 Elasticsearch 官方網(wǎng)站下載并安裝適合你操作系統(tǒng)的版本。

安裝完成后，通過以下命令啟動 Elasticsearch 服務：

./bin/elasticsearch

默認情況下，Elasticsearch 運行在 http://localhost:9200。

2.2 Java 開發(fā)環(huán)境配置

安裝 Java SDK（JDK 11 或更高版本）。
安裝 Maven 或 Gradle。
創(chuàng)建一個 Maven 項目，添加 Elasticsearch Java 客戶端的依賴。

2.3 添加 Elasticsearch 客戶端依賴

在 Maven 項目的 pom.xml 文件中添加以下依賴：

<dependencies>
    <!-- Elasticsearch Java Client -->
    <dependency>
        <groupId>co.elastic.clients</groupId>
        <artifactId>elasticsearch-java</artifactId>
        <version>8.10.0</version>
    </dependency>
</dependencies>

如果你使用 Gradle，可以在 build.gradle 文件中添加以下依賴：

dependencies {
    implementation 'co.elastic.clients:elasticsearch-java:8.10.0'
}

添加依賴后，確保項目能夠正常編譯。

3. 使用 Java 連接 Elasticsearch

接下來，我們將編寫一個簡單的 Java 程序來連接 Elasticsearch。

3.1 編寫連接代碼

創(chuàng)建一個 Java 類，例如 ElasticsearchConnection.java，并編寫以下代碼：

import co.elastic.clients.elasticsearch.ElasticsearchClient;
import co.elastic.clients.elasticsearch.core.InfoResponse;
import co.elastic.clients.transport.rest_client.RestClientTransport;
import co.elastic.clients.json.jackson.JacksonJsonpMapper;
import org.apache.http.HttpHost;
import org.elasticsearch.client.RestClient;
public class ElasticsearchConnection {
    public static void main(String[] args) throws Exception {
        // 創(chuàng)建 REST 客戶端
        RestClient restClient = RestClient.builder(
                new HttpHost("localhost", 9200, "http")).build();
        // 創(chuàng)建傳輸層
        RestClientTransport transport = new RestClientTransport(
                restClient, new JacksonJsonpMapper());
        // 創(chuàng)建 Elasticsearch 客戶端
        ElasticsearchClient client = new ElasticsearchClient(transport);
        // 獲取集群信息
        InfoResponse info = client.info();
        System.out.println("Connected to Elasticsearch cluster: " + info.clusterName());
        // 關閉客戶端
        transport.close();
    }
}

3.2 運行代碼

編譯并運行這個程序，如果成功，你將看到類似如下的輸出：

Connected to Elasticsearch cluster: elasticsearch

這表明你已經(jīng)成功連接到了 Elasticsearch。

4. 基本 CRUD 操作

Elasticsearch 的 CRUD 操作主要涉及對索引中的文檔進行增（Create）、查（Read）、改（Update）、刪（Delete）操作。

4.1 創(chuàng)建索引和插入文檔

import co.elastic.clients.elasticsearch.ElasticsearchClient;
import co.elastic.clients.elasticsearch.core.IndexResponse;
import co.elastic.clients.transport.rest_client.RestClientTransport;
import co.elastic.clients.json.jackson.JacksonJsonpMapper;
import org.apache.http.HttpHost;
import org.elasticsearch.client.RestClient;
import co.elastic.clients.elasticsearch.core.IndexRequest;
public class ElasticsearchCRUD {
    public static void main(String[] args) throws Exception {
        // 創(chuàng)建 REST 客戶端
        RestClient restClient = RestClient.builder(
                new HttpHost("localhost", 9200, "http")).build();
        // 創(chuàng)建傳輸層
        RestClientTransport transport = new RestClientTransport(
                restClient, new JacksonJsonpMapper());
        // 創(chuàng)建 Elasticsearch 客戶端
        ElasticsearchClient client = new ElasticsearchClient(transport);
        // 創(chuàng)建文檔
        String json = "{ \"name\": \"John Doe\", \"age\": 30, \"city\": \"New York\" }";
        // 插入文檔到索引
        IndexRequest<Object> request = new IndexRequest.Builder<>()
            .index("users")
            .id("1")
            .document(json)
            .build();
        IndexResponse response = client.index(request);
        System.out.println("Document inserted with ID: " + response.id());
        // 關閉客戶端
        transport.close();
    }
}

4.2 查詢文檔

import co.elastic.clients.elasticsearch.ElasticsearchClient;
import co.elastic.clients.elasticsearch.core.GetResponse;
import co.elastic.clients.transport.rest_client.RestClientTransport;
import co.elastic.clients.json.jackson.JacksonJsonpMapper;
import org.apache.http.HttpHost;
import org.elasticsearch.client.RestClient;
import co.elastic.clients.elasticsearch.core.GetRequest;
public class ElasticsearchRead {
    public static void main(String[] args) throws Exception {
        RestClient restClient = RestClient.builder(
                new HttpHost("localhost", 9200, "http")).build();
        RestClientTransport transport = new RestClientTransport(
                restClient, new JacksonJsonpMapper());
        ElasticsearchClient client = new ElasticsearchClient(transport);
        // 查詢文檔
        GetRequest getRequest = new GetRequest.Builder()
                .index("users")
                .id("1")
                .build();
        GetResponse<Object> response = client.get(getRequest, Object.class);
        if (response.found()) {
            System.out.println("Document found: " + response.source());
        } else {
            System.out.println("Document not found");
        }
        transport.close();
    }
}

4.3 更新文檔

import co.elastic.clients.elasticsearch.ElasticsearchClient;
import co.elastic.clients.elasticsearch.core.UpdateResponse;
import co.elastic.clients.transport.rest_client.RestClientTransport;
import co.elastic.clients.json.jackson.JacksonJsonpMapper;
import org.apache.http.HttpHost;
import org.elasticsearch.client.RestClient;
import co.elastic.clients.elasticsearch.core.UpdateRequest;
import java.util.Map;
public class ElasticsearchUpdate {
    public static void main(String[] args) throws Exception {
        RestClient restClient = RestClient.builder(
                new HttpHost("localhost", 9200, "http")).build();
        RestClientTransport transport = new RestClientTransport(
                restClient, new JacksonJsonpMapper());
        ElasticsearchClient client = new ElasticsearchClient(transport);
        // 更新文檔
        Map<String, Object> updateJson = Map.of(
                "age", 31,
                "city", "San Francisco"
        );
        UpdateRequest<Object, Map<String, Object>> updateRequest = new UpdateRequest.Builder<>()
                .index("users")
                .id("1")
                .doc(updateJson)
                .build();
        UpdateResponse<Object> updateResponse = client.update(updateRequest, Object.class);
        System.out.println("Document updated: " + updateResponse.result());
        transport.close();
    }
}

4.4 刪除文檔

import co.elastic.clients.elasticsearch.ElasticsearchClient;
import co.elastic.clients.elasticsearch.core.DeleteResponse;
import co.elastic.clients.transport.rest_client.RestClientTransport;
import co.elastic.clients.json.jackson.JacksonJsonpMapper;
import org.apache.http.HttpHost;
import org.elasticsearch.client.RestClient;
import co.elastic.clients.elasticsearch.core.DeleteRequest;
public class ElasticsearchDelete {
    public static void main(String[] args) throws Exception {
        RestClient restClient = RestClient.builder(
                new HttpHost("localhost", 9200, "http")).build();
        RestClientTransport transport = new RestClientTransport(
                restClient, new JacksonJsonpMapper());
        ElasticsearchClient client = new ElasticsearchClient(transport);
        // 刪除文檔
        DeleteRequest deleteRequest = new DeleteRequest.Builder()
                .index("users")
                .id("1")
                .build();
        DeleteResponse deleteResponse = client.delete(deleteRequest);
        System.out.println("Document deleted: " + deleteResponse.result());
        transport.close();
    }
}

5. 復雜查詢操作

Elasticsearch 提供了強大的查詢 DSL（Domain Specific Language），支持布爾查詢、范圍查詢、聚合查詢等。

5.1 布爾查詢

import co.elastic.clients.elasticsearch.ElasticsearchClient;
import co.elastic.clients.elasticsearch.core.SearchResponse;
import co.elastic.clients.elasticsearch.core.search.Hit;
import co.elastic.clients.transport.rest_client.RestClientTransport;
import co.elastic.clients.json.jackson.JacksonJsonpMapper;
import org.apache.http.HttpHost;
import org.elasticsearch.client.RestClient;
import co.elastic.clients.elasticsearch.core.SearchRequest;
import co.elastic.clients.elasticsearch.core.search.Query;
public class ElasticsearchBooleanQuery {
    public static void main(String[] args) throws Exception {
        RestClient restClient = RestClient.builder(
                new HttpHost("localhost", 9200, "http")).build();
        RestClientTransport transport = new RestClientTransport(
                restClient, new JacksonJsonpMapper());
        ElasticsearchClient client = new ElasticsearchClient(transport);
        // 布爾查詢
        SearchRequest searchRequest = new SearchRequest.Builder()
                .index("users")
                .query(Query
                .bool(b -> b
                    .must(m -> m.match(match -> match.field("name").query("John Doe")))
                    .filter(f -> f.range(r -> r.field("age").gte(30)))
                ))
                .build();
        SearchResponse<Object> searchResponse = client.search(searchRequest, Object.class);
        for (Hit<Object> hit : searchResponse.hits().hits()) {
            System.out.println("Document found: " + hit.source());
        }
        transport.close();
    }
}

5.2 范圍查詢

import co.elastic.clients.elasticsearch.ElasticsearchClient;
import co.elastic.clients.elasticsearch.core.SearchResponse;
import co.elastic.clients.elasticsearch.core.search.Hit;
import co.elastic.clients.transport.rest_client.RestClientTransport;
import co.elastic.clients.json.jackson.JacksonJsonpMapper;
import org.apache.http.HttpHost;
import org.elasticsearch.client.RestClient;
import co.elastic.clients.elasticsearch.core.SearchRequest;
import co.elastic.clients.elasticsearch.core.search.Query;
public class ElasticsearchRangeQuery {
    public static void main(String[] args) throws Exception {
        RestClient restClient = RestClient.builder(
                new HttpHost("localhost", 9200, "http")).build();
        RestClientTransport transport = new RestClientTransport(
                restClient, new JacksonJsonpMapper());
        ElasticsearchClient client = new ElasticsearchClient(transport);
        // 范圍查詢：查詢 age 在 25 到 35 之間的文檔
        SearchRequest searchRequest = new SearchRequest.Builder()
                .index("users")
                .query(Query.range(r -> r.field("age").gte(25).lte(35)))
                .build();
        SearchResponse<Object> searchResponse = client.search(searchRequest, Object.class);
        for (Hit<Object> hit : searchResponse.hits().hits()) {
            System.out.println("Document found: " + hit.source());
        }
        transport.close();
    }
}

6. 索引管理與優(yōu)化

在 Elasticsearch 中，索引管理是非常重要的操作，合理的索引設置和優(yōu)化可以大幅提升查詢性能。

6.1 創(chuàng)建索引并設置映射

import co.elastic.clients.elasticsearch.ElasticsearchClient;
import co.elastic.clients.elasticsearch.indices.CreateIndexResponse;
import co.elastic.clients.transport.rest_client.RestClientTransport;
import co.elastic.clients.json.jackson.JacksonJsonpMapper;
import org.apache.http.HttpHost;
import org.elasticsearch.client.RestClient;
import co.elastic.clients.elasticsearch.indices.CreateIndexRequest;
public class ElasticsearchCreateIndex {
    public static void main(String[] args) throws Exception {
        RestClient restClient = RestClient.builder(
                new HttpHost("localhost", 9200, "http")).build();
        RestClientTransport transport = new RestClientTransport(
                restClient, new JacksonJsonpMapper());
        ElasticsearchClient client = new ElasticsearchClient(transport);
        // 創(chuàng)建索引并設置映射
        CreateIndexRequest createIndexRequest = new CreateIndexRequest.Builder()
                .index("users")
                .mappings(m -> m
                    .properties("name", p -> p.text(t -> t))
                    .properties("age", p -> p.integer(i -> i))
                    .properties("city", p -> p.text(t -> t))
                )
                .build();
        CreateIndexResponse createIndexResponse = client.indices().create(createIndexRequest);
        if (createIndexResponse.acknowledged()) {
            System.out.println("Index created successfully!");
        }
        transport.close();
    }
}

6.2 刪除索引

import co.elastic.clients.elasticsearch.ElasticsearchClient;
import co.elastic.clients.elasticsearch.indices.DeleteIndexResponse;
import co.elastic.clients.transport.rest_client.RestClientTransport;
import co.elastic.clients.json.jackson.JacksonJsonpMapper;
import org.apache.http.HttpHost;
import org.elasticsearch.client.RestClient;
import co.elastic.clients.elasticsearch.indices.DeleteIndexRequest;
public class ElasticsearchDeleteIndex {
    public static void main(String[] args) throws Exception {
        RestClient restClient = RestClient.builder(
                new HttpHost("localhost", 9200, "http")).build();
        RestClientTransport transport = new RestClientTransport(
                restClient, new JacksonJsonpMapper());
        ElasticsearchClient client = new ElasticsearchClient(transport);
        // 刪除索引
        DeleteIndexRequest deleteIndexRequest = new DeleteIndexRequest.Builder()
                .index("users")
                .build();
        DeleteIndexResponse deleteIndexResponse = client.indices().delete(deleteIndexRequest);
        if (deleteIndexResponse.acknowledged()) {
            System.out.println("Index deleted successfully!");
        }
        transport.close();
    }
}

7. 聚合操作

Elasticsearch 的聚合功能非常強大，能夠對數(shù)據(jù)進行分組統(tǒng)計、計算平均值、最大值、最小值等操作。

7.1 聚合查詢：計算年齡的平均值

import co.elastic.clients.elasticsearch.ElasticsearchClient;
import co.elastic.clients.elasticsearch.core.SearchResponse;
import co.elastic.clients.elasticsearch.core.search.Hit;
import co.elastic.clients.elasticsearch.core.search.Aggregation;
import co.elastic.clients.elasticsearch.core.search.Bucket;
import co.elastic.clients.transport.rest_client.RestClientTransport;
import co.elastic.clients.json.jackson.JacksonJsonpMapper;
import org.apache.http.HttpHost;
import org.elasticsearch.client.RestClient;
import co.elastic.clients.elasticsearch.core.SearchRequest;
public class ElasticsearchAggregation {
    public static void main(String[] args) throws Exception {
        RestClient restClient = RestClient.builder(
                new HttpHost("localhost", 9200, "http")).build();
        RestClientTransport transport = new RestClientTransport(
                restClient, new JacksonJsonpMapper());
        ElasticsearchClient client = new ElasticsearchClient(transport);
        // 聚合查詢：計算年齡的平均值
        SearchRequest searchRequest = new SearchRequest.Builder()
                .index("users")
                .size(0)  // 不返回文檔，只返回聚合結果
                .aggregations("average_age", a -> a.avg(avg -> avg.field("age")))
                .build();
        SearchResponse<Object> searchResponse = client.search(searchRequest, Object.class);
        double averageAge = searchResponse.aggregations().get("average_age").avg().value();
        System.out.println("Average age: " + averageAge);
        transport.close();
    }
}

8. 總結

本教程詳細介紹了如何在 Java 中使用 Elasticsearch，涵蓋了連接、基本 CRUD 操作、復雜查詢、索引管理和聚合操作等方面的內容。通過這些示例，開發(fā)者可以一步步地掌握如何在 Java 項目中集成 Elasticsearch，并利用其強大的搜索和分析功能來構建高效的應用程序。

到此這篇關于Elasticsearch 在 Java 中的使用教程的文章就介紹到這了,更多相關Java 使用Elasticsearch內容請搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關文章希望大家以后多多支持腳本之家！

您可能感興趣的文章:

spring boot+spring cache實現(xiàn)兩級緩存(redis+caffeine)
這篇文章主要介紹了spring boot+spring cache實現(xiàn)兩級緩存(redis+caffeine)，小編覺得挺不錯的，現(xiàn)在分享給大家，也給大家做個參考。一起跟隨小編過來看看吧
2018-02-02
Java Persistence對象關系映射的基礎與應用
這篇文章主要介紹了Java Persistence對象關系映射的基礎與應用,Persistence API是Java平臺提供的對象關系映射標準,旨在簡化關系型數(shù)據(jù)庫的持久化操作,它在Java EE和Java SE環(huán)境中均可使用,為開發(fā)者提供了統(tǒng)一的數(shù)據(jù)訪問方式,需要的朋友可以參考下
2025-05-05
java線程池中線程數(shù)量到底是幾
本文主要介紹了java線程池中線程數(shù)量到底是幾，文中通過示例代碼介紹的非常詳細，對大家的學習或者工作具有一定的參考學習價值，需要的朋友們下面隨著小編來一起學習學習吧
2022-08-08
Java線程池中execute()和submit()兩個方法的區(qū)別(源碼&實戰(zhàn)全解析)
線程池是現(xiàn)代多線程編程中的重要工具,它能顯著提升任務處理效率并優(yōu)化系統(tǒng)資源,這篇文章主要介紹了Java線程池中execute()和submit()兩個方法區(qū)別的相關資料,文中通過代碼介紹的非常詳細,需要的朋友可以參考下
2026-03-03
SpringBoot引入swagger報錯處理的解決方法
這篇文章主要給大家介紹SpringBoot引入swagger是會出現(xiàn)報錯的處理解決方法，文中有詳細的解決過程，感興趣的小伙伴可以跟著小編一起來學習吧
2023-06-06
詳解定時任務框架Quartz的使用
Quartz是OpenSymphony開源組織在Job?scheduling領域又一個開源項目，完全由Java開發(fā)，可以用來執(zhí)行定時任務，本文就來帶大家聊聊它的具體使用
2023-02-02
Springboot整合activemq的方法步驟
這篇文章主要介紹了Springboot整合activemq的方法步驟，文中通過示例代碼介紹的非常詳細，對大家的學習或者工作具有一定的參考學習價值，需要的朋友們下面隨著小編來一起學習學習吧
2019-01-01
Spring Security OAuth 自定義授權方式實現(xiàn)手機驗證碼
這篇文章主要介紹了Spring Security OAuth 自定義授權方式實現(xiàn)手機驗證碼，文中通過示例代碼介紹的非常詳細，對大家的學習或者工作具有一定的參考學習價值，需要的朋友們下面隨著小編來一起學習學習吧
2021-02-02
Java在Excel中創(chuàng)建透視表方法解析
這篇文章主要介紹了Java在Excel中創(chuàng)建透視表方法解析,文中通過示例代碼介紹的非常詳細，對大家的學習或者工作具有一定的參考學習價值,需要的朋友可以參考下
2020-05-05
Tomcat?8.5?+mysql?5.7+jdk1.8開發(fā)JavaSE的金牌榜小項目
這篇文章主要介紹了Tomcat?8.5?+mysql?5.7+jdk1.8開發(fā)JavaSE的金牌榜小項目,本文通過圖文實例相結合給大家介紹的非常詳細，對大家的學習或工作具有一定的參考借鑒價值，需要的朋友可以參考下
2022-05-05