SpringBoot中使用Elasticsearch入门教程（上）

最新推荐文章于 2025-10-09 15:31:34 发布

原创

最新推荐文章于 2025-10-09 15:31:34 发布 · 2.2k 阅读

7 ·

CC 4.0 BY-SA版权

文章标签：

#elasticsearch #spring boot #大数据

本文介绍了在Spring Boot中使用Spring Data Elasticsearch 4.0进行Elasticsearch集成的基础步骤，包括环境搭建、配置ES连接信息、创建DAO层以及进行CRUD操作的示例。文章分为简易版JPA形式使用和进阶版原生API使用两部分，适合初学者快速入门。

微信公众号：Java编程之道

Spring Data全家桶中对Elasticsearch也做了集成，本文接下来会基于最新的Spring Data Elasticsearch 4.0介绍在spring中对ES的基本使用。

本文分为上下两部分，分别为
- 简易版的Spring Boot JPA形式的使用
- 进阶版ES原生API的使用

前言

1. 新版本特性

既然是基于最新的Spring Data Elasticsearch 4.0来学习，那么首先得弄清楚4.0具有哪些特性，贴上官方文档
在这里插入图片描述从图中可以看到，4.0对应支持ES版本为7.6.2，并且弃用了对TransportClient的使用，实际上ES从7.x版本开始就弃用了对TransportClient的使用，并将会在8.0版本开始完全删除TransportClient，这意味着后续我们在使用客户端连接ES时得和9300告别了。
详细的新版本特性请参考官方文档(https://sohu.gg/X3lyLU)

2. 环境搭建

ES7.6.2及以上版本的安装，如果还没安装，可以参考之前的安装文章。
JDK请确认1.8及以上版本
项目初始化：使用spring的快速开始功能即可(https://start.spring.io/)，记得勾选图中插件哦。

简易版的JPA形式使用

1.配置ES连接信息

##在application.properties配置连接地址，IP自行更换
spring.elasticsearch.rest.uris=http://127.0.0.1:9200
##如果启动配置文件时application.yml，则相应配置为
spring:
  elasticsearch:
    rest:
      uris:
        - http://127.0.0.1:9200

##小提示：spring默认安装的是7.6.2版本的ES，若你安装的是7.6.2以上的版本，可在pom中的<properties>标签中手动替换ES的版本
<elasticsearch.version>7.7.1</elasticsearch.version>

2.创建DAO层

对ES操作的DAO类是通过继承Spring已经封装好对ES基本的CRUD及分页操作的ElasticsearchRepository类并进行扩展操作接口来实现。

a.创建Document实体类

学习了Elasticsearch基本概念的同学都知道ES中的存储结构有Index、Document，那在Spring中我们如何实现及定义呢，别担心，Spring已为我们提供了@Document注解，使用方式如下：

/**
 * <h3>spring-data-elasticsearch-demo</h3>
 * <p></p>
 *
 * @author yingKang
 * @date 2020-06-05 17:57
 */
@Data
@ToString
@Builder
@NoArgsConstructor