java 连接 ES

Java 连接 Elasticsearch 的指南

Elasticsearch（简称 ES）是一个开源的分布式搜索引擎，广泛应用于实时数据分析和全文本搜索。在许多 Java 应用程序中，连接和操作 Elasticsearch 是非常常见的需求。本文将详细介绍如何在 Java 中连接 Elasticsearch，并提供代码示例。

环境准备

在开始之前，请确认你的开发环境中已经包含了 Java 和 Maven。我们将使用 Elasticsearch 的官方 Java 客户端库来进行连接。

添加 Maven 依赖

在你的 Maven 项目的 pom.xml 文件中添加以下依赖项：

<dependency>
    <groupId>org.elasticsearch.client</groupId>
    <artifactId>elasticsearch-rest-high-level-client</artifactId>
    <version>7.17.0</version> <!-- 请根据需要检查最新版本 -->
</dependency>

连接 Elasticsearch

接下来的步骤是编写 Java 代码以连接到 Elasticsearch 集群。

import org.elasticsearch.client.RestClient;
import org.elasticsearch.client.RestHighLevelClient;

public class ElasticsearchConnection {
    private static RestHighLevelClient client;

    public static void main(String[] args) {
        client = new RestHighLevelClient(
                RestClient.builder(
                        new HttpHost("localhost", 9200, "http"))); // 替换为你的 Elasticsearch 地址

        System.out.println("Elasticsearch 连接成功!");

        // 关闭客户端
        try {
            client.close();
        } catch (IOException e) {
            e.printStackTrace();
        }
    }
}

代码解析

• 首先，导入相关的类。
• 然后，使用 RestClient.builder() 方法创建一个 RestHighLevelClient 实例。
• 最后，运行代码以测试连接，并在完成后关闭客户端。

执行基本操作

一旦连接成功，你可以开始执行基本的索引和搜索操作。以下是一个简单的索引文档的示例：

import org.elasticsearch.action.index.IndexRequest;
import org.elasticsearch.client.RequestOptions;
import org.elasticsearch.client.RestHighLevelClient;

import java.io.IOException;
import java.util.HashMap;
import java.util.Map;

public class IndexDocument {
    public static void main(String[] args) {
        RestHighLevelClient client = new RestHighLevelClient(
                RestClient.builder(new HttpHost("localhost", 9200, "http")));

        Map<String, Object> jsonMap = new HashMap<>();
        jsonMap.put("user", "kimchy");
        jsonMap.put("postDate", "2023-10-01");
        jsonMap.put("message", "Elasticsearch: cool. bonsai cool!");

        IndexRequest indexRequest = new IndexRequest("posts").id("1").source(jsonMap);

        try {
            client.index(indexRequest, RequestOptions.DEFAULT);
            System.out.println("文档索引成功!");
        } catch (IOException e) {
            e.printStackTrace();
        } finally {
            try {
                client.close();
            } catch (IOException e) {
                e.printStackTrace();
            }
        }
    }
}

代码解析

• 我们创建了一个 IndexRequest 实例，将文档的 ID 和内容传入。
• 使用 client.index() 方法将文档索引到指定的 Elasticsearch 索引中。

查询数据

除了索引数据，通常我们还需要查询数据。以下是一个简单的查询示例：

import org.elasticsearch.action.get.GetRequest;
import org.elasticsearch.client.RequestOptions;
import org.elasticsearch.client.RestHighLevelClient;
import org.elasticsearch.action.get.GetResponse;

public class GetDocument {
    public static void main(String[] args) {
        RestHighLevelClient client = new RestHighLevelClient(
                RestClient.builder(new HttpHost("localhost", 9200, "http")));

        GetRequest getRequest = new GetRequest("posts", "1");

        try {
            GetResponse getResponse = client.get(getRequest, RequestOptions.DEFAULT);
            System.out.println("文档内容: " + getResponse.getSourceAsString());
        } catch (IOException e) {
            e.printStackTrace();
        } finally {
            try {
                client.close();
            } catch (IOException e) {
                e.printStackTrace();
            }
        }
    }
}

结论

通过本指南，您已经学习了如何在 Java 中连接 Elasticsearch，执行基本的索引和查询操作。随着对 Elasticsearch 的深入了解，您将能够更好地利用文档存储、搜索和数据分析的强大功能。

以下是本次学习过程的旅行图，帮助您理清思路：

journey
    title Java 连接 Elasticsearch 旅程
    section 环境准备
      添加 Maven 依赖: 5: 陌生人
      创建 Java 类: 4: 陌生人
    section 连接 ES
      创建 RestHighLevelClient: 4: 陌生人
      测试连接: 3: 陌生人
    section 执行基本操作
      索引文档: 5: 陌生人
      查询文档: 4: 陌生人

希望这篇文章对你有所帮助，让你在 Java 和 Elasticsearch 的旅程中走得更远！