Springboot整合Elasticsearch

最新推荐文章于 2025-06-27 17:01:38 发布

QAQnullPoint

最新推荐文章于 2025-06-27 17:01:38 发布

阅读量403

点赞数

CC 4.0 BY-SA版权

文章标签： elasticsearch spring boot java

本文链接：https://blog.youkuaiyun.com/QAQnullPoint/article/details/126561987

本文介绍如何在SpringBoot项目中整合Elasticsearch，并通过Java客户端实现索引管理、文档增删改查及搜索等功能。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

Springboot整合Elasticsearch

1 ES客户端

ES提供多种不同的客户端：

1、TransportClient

ES提供的传统客户端，官方计划8.0版本删除此客户端。

2、RestClient

RestClient是官方推荐使用的，它包括两种：REST Low Level Client和 REST High Level Client。ES在6.0之后提供REST High Level Client，两种客户端官方更推荐使用 REST High Level Client，不过当前它还处于完善中，有些功能还没有。

2 搭建工程

2.1 pom.xml


<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0"
         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
    <modelVersion>4.0.0</modelVersion>
    <parent>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-parent</artifactId>
        <version>2.3.2.RELEASE</version>
    </parent>

    <groupId>com.bjpowernode</groupId>
    <artifactId>springboot_elasticsearch</artifactId>
    <version>1.0-SNAPSHOT</version>
    
    <!-- 修改elasticsearch的版本 -->
    <properties>
        <elasticsearch.version>6.2.3</elasticsearch.version>
    </properties>
    
    <dependencies>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-web</artifactId>
        </dependency>
        <dependency>
            <groupId>org.elasticsearch.client</groupId>
            <artifactId>elasticsearch-rest-high-level-client</artifactId>
            <version>${elasticsearch.version}</version>
        </dependency>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-test</artifactId>
        </dependency>
    </dependencies>
</project>

2.2 application.yml

spring:
  elasticsearch:
    rest:
      uris:
        - http://Es的IP地址:9200

2.3 app

import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;

@SpringBootApplication
public class ElasticsearchApp {

	public static void main(String[] args) {
		SpringApplication.run(ElasticsearchApp.class, args);
	}
}

3 索引管理

3.1 创建索引库

在Kibana中的代码（不需要执行）：

PUT /java06
{
  "settings":{
       "number_of_shards" : 2,
       "number_of_replicas" : 0
  }
}

Java Client

	@Autowired
    private RestHighLevelClient restHighLevelClient;

    public void testCreateIndex() throws IOException {

        CreateIndexRequest createIndexRequest = new CreateIndexRequest("java06");
        createIndexRequest.source("{\n" +
                "  \"settings\":{\n" +
                "       \"number_of_shards\" : 2,\n" +
                "       \"number_of_replicas\" : 0\n" +
                "  }\n" +
                "}", XContentType.JSON);
        IndicesClient indices = restHighLevelClient.indices();
        CreateIndexResponse createIndexResponse = indices.create(createIndexRequest);
        System.out.println(createIndexResponse.isShardsAcknowledged());
    }

3.2 删除索引库（Index）

在Kibana中的代码（不需要执行）：

DELETE /java06

JavaClient

	@Autowired
    private RestHighLevelClient restHighLevelClient;
    
    public void testDeleteIndex() throws IOException {
        //创建“删除索引请求”对象
        DeleteIndexRequest deleteRequest = new DeleteIndexRequest("java06");
        //创建索引操作客户端
        IndicesClient indices = restHighLevelClient.indices();
        //创建响应对象
        DeleteIndexResponse delete = indices.delete(deleteRequest);
        System.out.println(delete.isAcknowledged());
    }

3.3 创建映射mapping

在Kibana中的代码（不需要执行）：

POST /java06/course/_mapping
{
  "_source": {
    "excludes":["description"]
  }, 
 	"properties": {
      "name": {
          "type": "text",
          "analyzer":"ik_max_word",
          "search_analyzer":"ik_smart"
      },
      "description": {
          "type": "text",
          "analyzer":"ik_max_word",
          "search_analyzer":"ik_smart"
       },
       "studymodel": {
          "type": "keyword"
       },
       "price": {
          "type": "float"
       },
       "pic":{
		   "type":"text",
		   "index":false
	    }
  }
}

JavaClient

	@Autowired
	private RestHighLevelClient restHighLevelClient;
    
	public void testCreateMapping() throws IOException {

        CreateIndexRequest createIndexRequest = new CreateIndexRequest("java06");
        createIndexRequest.source("{\n" +
                "  \"settings\":{\n" +
                "       \"number_of_shards\" : 2,\n" +
                "       \"number_of_replicas\" : 0\n" +
                "  }\n" +
                "}", XContentType.JSON);
        createIndexRequest.mapping("course","{\n" +
                "  \"_source\": {\n" +
                "    \"excludes\":[\"description\"]\n" +
                "  }, \n" +
                " \t\"properties\": {\n" +
                "      \"name\": {\n" +
                "          \"type\": \"text\",\n" +
                "          \"analyzer\":\"ik_max_word\",\n" +
                "          \"search_analyzer\":\"ik_smart\"\n" +
                "      },\n" +
                "      \"description\": {\n" +
                "          \"type\": \"text\",\n" +
                "          \"analyzer\":\"ik_max_word\",\n" +
                "          \"search_analyzer\":\"ik_smart\"\n" +
                "       },\n" +
                "       \"studymodel\": {\n" +
                "          \"type\": \"keyword\"\n" +
                "       },\n" +
                "       \"price\": {\n" +
                "          \"type\": \"float\"\n" +
                "       },\n" +
                "       \"pic\":{\n" +
                "\t\t   \"type\":\"text\",\n" +
                "\t\t   \"index\":false\n" +
                "\t    }\n" +
                "  }\n" +
                "}",XContentType.JSON);
        IndicesClient indices = restHighLevelClient.indices();
        CreateIndexResponse createIndexResponse = indices.create(createIndexRequest);
        System.out.println(createIndexResponse.isShardsAcknowledged());
    }

3.4 添加文档（doc）

在Kibana中的代码（不需要执行）：

POST /java06/course/1
{
 "name":"spring cloud实战",
 "description":"本课程主要从四个章节进行讲解： 1.微服务架构入门 2.spring cloud 基础入门 3.实战Spring Boot 4.注册中心eureka。",
 "studymodel":"201001",
 "price":5.6
}

JavaClient

	@Autowired
	private RestHighLevelClient restHighLevelClient;
	
	public void testAddDoc() throws IOException {
        IndexRequest indexRequest = new IndexRequest("java06", "course", "1");
        indexRequest.source("{\n" +
                " \"name\":\"spring cloud实战\",\n" +
                " \"description\":\"本课程主要从四个章节进行讲解： 1.微服务架构入门 2.spring cloud 基础入门 3.实战Spring Boot 4.注册中心eureka。\",\n" +
                " \"studymodel\":\"201001\",\n" +
                " \"price\":5.6\n" +
                "}",XContentType.JSON);
        IndexResponse response = restHighLevelClient.index(indexRequest);
        System.out.println(response.toString());
    }

3.4 修改文档（doc）

在Kibana中的代码（不需要执行）：

PUT /java06/course/1
{
 "price":66.6
}

JavaClient

	@Autowired
	private RestHighLevelClient restHighLevelClient;
	
	public void testUpdataDoc() throws IOException {
        UpdateRequest updateRequest = new UpdateRequest("java06","course","1");
        updateRequest.doc("{\n" +
                " \"price\":66.6\n" +
                "}",XContentType.JSON);
        UpdateResponse response = restHighLevelClient.update(updateRequest);
        System.out.println(response.toString());
    }

3.4 删除文档（doc）

在Kibana中的代码（不需要执行）：

DELETE /java06/coures/1

JavaClient

	@Autowired
	private RestHighLevelClient restHighLevelClient;

	public void testDeleteDoc() throws IOException {
        DeleteRequest deleteRequest = new DeleteRequest("java06", "course", "1");
        DeleteResponse response = restHighLevelClient.delete(deleteRequest);
        System.out.println(response.toString());
    }

4 文档搜索（doc）

4.1 准备环境

向索引库中插入以下数据（直接使用Kibana整）：

PUT /java06/course/1
{
  "name": "Bootstrap开发",
  "description": "Bootstrap是由Twitter推出的一个前台页面开发css框架，是一个非常流行的开发框架，此框架集成了多种页面效果。此开发框架包含了大量的CSS、JS程序代码，可以帮助开发者（尤其是不擅长css页面开发的程序人员）轻松的实现一个css，不受浏览器限制的精美界面css效果。",
  "studymodel": "201002",
  "price":38.6,
  "pic":"group1/M00/00/00/wKhlQFs6RCeAY0pHAAJx5ZjNDEM428.jpg"
}

PUT /java06/course/2
{
  "name": "java编程基础",
  "description": "java语言是世界第一编程语言，在软件开发领域使用人数最多。",
  "studymodel": "201001",
  "price":68.6,
  "pic":"group1/M00/00/00/wKhlQFs6RCeAY0pHAAJx5ZjNDEM428.jpg"
}

PUT /java06/course/3
{
  "name": "spring开发基础",
  "description": "spring 在java领域非常流行，java程序员都在用。",
  "studymodel": "201001",
  "price":88.6,
  "pic":"group1/M00/00/00/wKhlQFs6RCeAY0pHAAJx5ZjNDEM428.jpg"
}

4.2 简单搜索

简单搜索就是通过url进行查询，以get方式请求ES。

在Kibana中的代码（不需要执行）：

GET /java06/course/1

JavaClient

	@Autowired
	private RestHighLevelClient restHighLevelClient;

	public void testGetDoc() throws IOException {
        GetRequest getRequest = new GetRequest("java06", "course", "1");
        GetResponse getResponse = restHighLevelClient.get(getRequest);
        System.out.println(getResponse.getSource());
    }

5 DSL搜索

 DSL(Domain Specific Language)是ES提出的基于json的搜索方式，在搜索时传入特定的json格式的数据来完成不同的搜索需求，
 DSL比URI搜索方式功能强大，在项目中建议使用DSL方式来完成搜索。

语法：

GET /index_name/type_name/_search
	{
		"commond":{
			"parameter_name" : "parameter_value"
		}
	}

5.1 match_all查询

在Kibana中的代码（不需要执行）：

GET /java06/course/_search
{
  "query" : { 
    "match_all" : {}
  }
}

JavaClient

	@Autowired
	private RestHighLevelClient restHighLevelClient;

	public void testSearch() throws IOException {
        SearchRequest searchRequest = new SearchRequest();
        searchRequest.indices("java06");
        searchRequest.types("course");

        SearchSourceBuilder searchSourceBuilder = new SearchSourceBuilder();
        searchSourceBuilder.query(QueryBuilders.matchAllQuery());

        searchRequest.source(searchSourceBuilder);
        SearchResponse response = restHighLevelClient.search(searchRequest);
        SearchHits hits = response.getHits();
        SearchHit[] hitsArr = hits.getHits();
        for (SearchHit hit : hitsArr) {
            System.out.println(hit.getSourceAsString());
        }
    }

5.2 分页查询

在Kibana中的代码（不需要执行）：

GET /java06/course/_search
{
  "query" : { "match_all" : {} },
  "from" : 1, # 从第几条数据开始查询，从0开始计数
  "size" : 3, # 查询多少数据
  "sort" : [
    { "price" : "asc" }
  ]
}

JavaClient

	@Autowired
	private RestHighLevelClient restHighLevelClient;

 public void testPage() throws IOException {
        SearchRequest searchRequest = new SearchRequest();
        searchRequest.indices("java06");
        searchRequest.types("course");

        SearchSourceBuilder searchSourceBuilder = new SearchSourceBuilder();
        searchSourceBuilder.query(QueryBuilders.matchAllQuery());
        searchSourceBuilder.from(1);
        searchSourceBuilder.size(3);
        searchSourceBuilder.sort("price", SortOrder.DESC);

        searchRequest.source(searchSourceBuilder);
        SearchResponse response = restHighLevelClient.search(searchRequest);
        SearchHits hits = response.getHits();
        SearchHit[] hitsArr = hits.getHits();
        for (SearchHit hit : hitsArr) {
            System.out.println(hit.getSourceAsString());
        }
    }

分割线暂停一下，有空更新===============================

5.1 match_all查询

在Kibana中的代码（不需要执行）：

JavaClient

	@Autowired
	private RestHighLevelClient restHighLevelClient;

5.1 match_all查询

在Kibana中的代码（不需要执行）：

JavaClient

	@Autowired
	private RestHighLevelClient restHighLevelClient;