Spring Boot 集成 Elasticsearch 全攻略
nanshan 2025-07-03 18:19 4 浏览 0 评论
在当今大数据和高并发的时代背景下,高效的数据检索和分析成为众多应用系统的核心需求。Elasticsearch(简称 ES)作为一款开源的分布式搜索引擎,以其强大的全文检索、实时分析和水平扩展能力,受到了开发者们的广泛青睐。而 Spring Boot 凭借其快速构建、自动配置的特性,极大地简化了 Java 应用的开发过程。将 Spring Boot 与 Elasticsearch 集成,能够充分发挥两者的优势,为应用系统提供高效、灵活的数据检索解决方案。接下来,我们就详细介绍如何在 Spring Boot 项目中集成 Elasticsearch。
一、环境准备
在开始集成之前,确保你已经安装好了以下环境:
- JDK:推荐使用 JDK 8 及以上版本。
- Elasticsearch:下载并安装合适版本的 Elasticsearch,安装完成后启动 ES 服务。可以通过访问http://localhost:9200/,若能看到 ES 的欢迎信息,说明 ES 服务正常运行。
- Spring Boot 项目:可以通过 Spring Initializr(https://start.spring.io/)创建一个基础的 Spring Boot 项目,在创建时勾选Spring Data Elasticsearch依赖,方便后续集成。
二、添加依赖
如果在创建 Spring Boot 项目时没有勾选Spring Data Elasticsearch依赖,也可以在项目的pom.xml文件中手动添加:
<dependencies> <!-- Spring Data Elasticsearch 依赖 --> <dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-data-elasticsearch</artifactId> </dependency> <!-- Spring Boot 测试依赖 --> <dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-test</artifactId> <scope>test</scope> </dependency> </dependencies> |
添加完依赖后,Maven 会自动下载相关的 jar 包。
三、配置 Elasticsearch 连接
在application.properties或application.yml文件中配置 Elasticsearch 的连接信息。以application.yml为例:
spring: data: elasticsearch: cluster-name: elasticsearch # ES集群名称,默认为elasticsearch cluster-nodes: localhost:9300 # ES节点地址,9300为传输端口,若使用默认配置可不修改 # 或者使用以下配置方式,适用于REST API连接 # uri: http://localhost:9200 |
如果使用的是 Elasticsearch 的 REST API 进行交互,也可以使用uri配置项,直接指定 ES 的 HTTP 访问地址。
四、创建实体类
创建一个 Java 实体类,用于映射 Elasticsearch 中的文档。假设我们有一个简单的博客文章实体类Blog:
import org.springframework.data.annotation.Id; import org.springframework.data.elasticsearch.annotations.Document; import org.springframework.data.elasticsearch.annotations.Field; import org.springframework.data.elasticsearch.annotations.FieldType; @Document(indexName = "blog", type = "_doc", shards = 1, replicas = 0) public class Blog { @Id private String id; @Field(type = FieldType.Text) private String title; @Field(type = FieldType.Text) private String content; // 省略getter和setter方法 } |
在上述代码中:
- @Document注解用于定义该实体类对应的 Elasticsearch 索引名称、文档类型、分片数和副本数。
- @Id注解标识该字段为文档的唯一标识。
- @Field注解用于指定字段的类型等属性,这里将title和content字段定义为Text类型,适合进行全文检索。
五、创建 Repository 接口
创建一个继承自ElasticsearchRepository的接口,用于对 Elasticsearch 进行数据操作:
import org.springframework.data.elasticsearch.repository.ElasticsearchRepository; import java.util.List; public interface BlogRepository extends ElasticsearchRepository<Blog, String> { List<Blog> findByTitleContaining(String keyword); } |
在这个接口中,我们定义了一个自定义方法findByTitleContaining,它会根据方法名的约定,自动生成查询语句,用于查找标题中包含指定关键字的博客文章。同时,ElasticsearchRepository已经提供了许多常用的 CRUD 操作方法,如save、findById、delete等,可以直接使用。
六、编写业务逻辑和测试代码
在服务类中注入BlogRepository,并编写业务逻辑方法。例如,创建一个BlogService类:
import org.springframework.stereotype.Service; import java.util.List; import java.util.Optional; @Service public class BlogService { private final BlogRepository blogRepository; public BlogService(BlogRepository blogRepository) { this.blogRepository = blogRepository; } public Blog saveBlog(Blog blog) { return blogRepository.save(blog); } public Optional<Blog> findBlogById(String id) { return blogRepository.findById(id); } public List<Blog> searchBlogs(String keyword) { return blogRepository.findByTitleContaining(keyword); } public void deleteBlogById(String id) { blogRepository.deleteById(id); } } |
接下来,可以编写测试代码对集成功能进行验证。在src/test/java目录下的测试类中编写如下测试方法:
import org.junit.jupiter.api.Test; import org.springframework.beans.factory.annotation.Autowired; import org.springframework.boot.test.context.SpringBootTest; import java.util.Optional; import static org.junit.jupiter.api.Assertions.*; @SpringBootTest public class BlogServiceTest { @Autowired private BlogService blogService; @Test public void testSaveAndFindBlog() { Blog blog = new Blog(); blog.setTitle("Spring Boot集成ES测试文章"); blog.setContent("这是一篇用于测试的文章内容"); Blog savedBlog = blogService.saveBlog(blog); assertNotNull(savedBlog.getId()); Optional<Blog> retrievedBlog = blogService.findBlogById(savedBlog.getId()); assertTrue(retrievedBlog.isPresent()); assertEquals("Spring Boot集成ES测试文章", retrievedBlog.get().getTitle()); } @Test public void testSearchBlogs() { Blog blog1 = new Blog(); blog1.setTitle("Spring Boot入门教程"); blog1.setContent("详细介绍Spring Boot入门知识"); blogService.saveBlog(blog1); Blog blog2 = new Blog(); blog2.setTitle("Elasticsearch实战"); blog2.setContent("分享Elasticsearch的实战经验"); blogService.saveBlog(blog2); List<Blog> searchResults = blogService.searchBlogs("Spring Boot"); assertEquals(1, searchResults.size()); assertEquals("Spring Boot入门教程", searchResults.get(0).getTitle()); } } |
运行这些测试方法,如果都能顺利通过,说明 Spring Boot 与 Elasticsearch 的集成基本成功。
七、高级配置与优化
1. 自定义 ElasticsearchTemplate
除了使用ElasticsearchRepository,还可以通过ElasticsearchTemplate进行更灵活的操作。在配置类中注入ElasticsearchTemplate:
import org.springframework.context.annotation.Bean; import org.springframework.context.annotation.Configuration; import org.springframework.data.elasticsearch.core.ElasticsearchTemplate; import org.springframework.data.elasticsearch.repository.config.EnableElasticsearchRepositories; @Configuration @EnableElasticsearchRepositories(basePackages = "com.example.demo.repository") public class ElasticsearchConfig { @Bean public ElasticsearchTemplate elasticsearchTemplate() { return new ElasticsearchTemplate(elasticsearchClient()); } // 省略elasticsearchClient方法的定义,根据实际连接方式编写 } |
然后在业务类中注入ElasticsearchTemplate,就可以使用它执行复杂的查询、聚合等操作。
2. 性能优化
- 索引设置优化:合理设置索引的分片数和副本数,根据数据量和查询负载进行调整。一般来说,分片数在创建索引后不能轻易修改,而副本数可以动态调整。
- 批量操作:对于大量数据的插入或更新,可以使用ElasticsearchRepository的批量操作方法,或者通过ElasticsearchTemplate执行批量请求,减少与 ES 的交互次数,提高性能。
- 缓存策略:对于一些不经常变化的数据,可以在应用层添加缓存,减少对 Elasticsearch 的查询压力。
八、常见问题与解决
1. 连接超时问题
如果出现连接 Elasticsearch 超时的情况,可能是 ES 服务未正常启动,或者网络配置有误。检查 ES 服务状态,确保cluster-nodes或uri配置的地址和端口正确。如果 ES 设置了安全认证,还需要在连接配置中添加用户名和密码。
2. 映射冲突问题
当实体类的字段类型与 Elasticsearch 索引的映射不匹配时,会出现映射冲突。可以通过手动创建索引并定义映射,或者使用ElasticsearchTemplate的putMapping方法动态更新映射。
3. 依赖版本兼容问题
Spring Data Elasticsearch 与 Elasticsearch 的版本需要保持兼容,否则可能会出现各种异常。在选择依赖版本时,参考官方文档的版本兼容性说明。
通过以上步骤,我们完成了 Spring Boot 与 Elasticsearch 的集成,并实现了基本的数据操作和查询功能。在实际项目中,可以根据具体需求进一步扩展和优化,利用 Elasticsearch 强大的搜索和分析能力,为应用系统提供更高效的数据服务。
以上就是 Spring Boot 集成 ES 的完整流程与要点。若你在实践中遇到特定问题,或想了解某部分的拓展内容,欢迎随时和我说。
相关推荐
- 在 Ubuntu 上安装 Zabbix(以 Zabbix 6.4 LTS 版本为例)
-
Zabbix是一个流行的开源监控解决方案,能够监控各种网络参数和服务器健康状态。一、环境准备系统要求Ubuntu20.04/22.04LTS至少2GBRAM(生产环境建议4GB+)至少1...
- 如何在 Ubuntu 24.04 服务器上安装 Apache Solr
-
ApacheSolr是一个免费、开源的搜索平台,广泛应用于实时索引。其强大的可扩展性和容错能力使其在高流量互联网场景下表现优异。Solr基于Java开发,提供了分布式索引、复制、负载均衡及自...
- 如何在 Ubuntu 24.04 LTS 或 22.04/20.04 上安装 Apache Maven
-
Maven是由Apache托管的开源工具,用于管理Java项目。它包含一个项目对象模型(POM):一个配置文件(XML),其中包含项目的基本信息,包括配置、项目依赖项等。Maven可以处理...
- Cursor的终极对手——Trae Pro最新系统提示词
-
前段时间,字节的AI编程神器Trae国际版,终于甩出了Pro订阅计划!很多对它又爱又恨的小伙伴,直呼:终于等到你。爱它,是因为Trae长期免费+体验真香;恨它?还不是那该死的排队等待,...
- AI系统提示词:V0(ai代码提示)
-
以下是对V0系统提示词(SystemPrompt)的分部分讲解与解读,帮助你理解其核心内容和设计意图。V0系统提示词##CoreIdentity-Youarev0,Vercel&...
- 8岁男童失踪第13天,搜救人员发现可疑水库,更恶心的事情发生了
-
Lookingatyourrequest,Ineedtorewritethearticleaboutthe8-year-oldmissingboywhilemaking...
- docker常用指令及安装rabbitMQ(docker安装zabbix)
-
一、docker常用指令启动docker:systemctlstartdocker停止docker:systemctlstopdocker重启docker:systemctlrestart...
- 三步教你用Elasticsearch+PyMuPDF实现PDF大文件秒搜!
-
面对100页以上的大型PDF文件时,阅读和搜索往往效率低下。传统关系型数据库在处理此类数据时容易遇到性能瓶颈,而Elasticsearch凭借其强大的全文检索和分布式架构,成为理想解决方案。通过...
- ElasticSearch中文分词插件(IK)安装
-
坚持原创,共同进步!请关注我,后续分享更精彩!!!前言ElasticSearch默认的分词插件对中文支持很不友好。一段话按规则会以每个中文字符来拆解,再分别建立倒排索引。如"中华人民共和国国歌...
- SpringBoot使用ElasticSearch做文档对象的持久化存储?
-
ElasticSearch是一个基于Lucene的开源搜索引擎,广泛应用于日志分析、全文搜索、复杂查询等领域,在有些场景中使用ElasticSearch进行文档对象的持久化存储是一个很不错的选择...
- Elasticsearch数据迁移方案(elasticsearch copyto)
-
前言最近小编要去给客户部署一套系统涉及到了Mysql和ES数据的迁移,下面就给大家分享一下ES数据迁移的几套方案,根据具体的使用场景来选择不同的迁移方案能使你事倍功半,话多说下面就一一介绍。Elast...
- Rancher部署单体ElasticSearch(rancher2.5部署)
-
Rancher是k8s图形管理界面,之前曾有写文章介绍如何安装。ElasticSearch是热门搜索引擎,很多地方都有用到,常规安装部署略显繁琐,本文介绍在k8s下用rancher简易部署ES。1.在...
- Elasticsearch在Java项目的搜索实践:从零开始构建高效搜索系统
-
Elasticsearch在Java项目中的搜索实践:从零开始构建高效搜索系统在现代的Java项目中,数据量激增,传统的数据库查询方式已经无法满足快速检索的需求。这时,Elasticsearch(E...
- 小白入门-Kibana安装(kibana安装配置)
-
一Kibana基础1.1介绍Kibana是一款免费且开放的前端应用程序,其基础是ElasticStack,可以为Elasticsearch中索引的数据提供搜索和数据可视化功能。Kiban...
- Docker上使用Elasticsearch,Logstash,Kibana
-
在对一个项目做性能测试时我需要处理我们web服务器的访问日志来分析当前用户的访问情况。因此,我想这是试用ELK的一个好机会。ELK栈首先要注意的是使用它是非常简单的。从决定使用ELK到在本机上搭一个...
你 发表评论:
欢迎- 一周热门
-
-
极空间如何无损移机,新Z4 Pro又有哪些升级?极空间Z4 Pro深度体验
-
UOS服务器操作系统防火墙设置(uos20关闭防火墙)
-
如何修复用户配置文件服务在 WINDOWS 上登录失败的问题
-
手机如何设置与显示准确时间的详细指南
-
如何在安装前及安装后修改黑群晖的Mac地址和Sn系列号
-
爱折腾的特斯拉车主必看!手把手教你TESLAMATE的备份和恢复
-
日本海上自卫队的军衔制度(日本海上自卫队的军衔制度是什么)
-
10个免费文件中转服务站,分享文件简单方便,你知道几个?
-
FANUC 0i-TF数据备份方法(fanuc系统备份教程)
-
NAS:DS video/DS file/DS photo等群晖移动端APP远程访问的教程
-
- 最近发表
-
- 在 Ubuntu 上安装 Zabbix(以 Zabbix 6.4 LTS 版本为例)
- 如何在 Ubuntu 24.04 服务器上安装 Apache Solr
- 如何在 Ubuntu 24.04 LTS 或 22.04/20.04 上安装 Apache Maven
- Cursor的终极对手——Trae Pro最新系统提示词
- AI系统提示词:V0(ai代码提示)
- 8岁男童失踪第13天,搜救人员发现可疑水库,更恶心的事情发生了
- docker常用指令及安装rabbitMQ(docker安装zabbix)
- 三步教你用Elasticsearch+PyMuPDF实现PDF大文件秒搜!
- ElasticSearch中文分词插件(IK)安装
- SpringBoot使用ElasticSearch做文档对象的持久化存储?
- 标签列表
-
- linux 查询端口号 (58)
- docker映射容器目录到宿主机 (66)
- 杀端口 (60)
- yum更换阿里源 (62)
- internet explorer 增强的安全配置已启用 (65)
- linux自动挂载 (56)
- 禁用selinux (55)
- sysv-rc-conf (69)
- ubuntu防火墙状态查看 (64)
- windows server 2022激活密钥 (56)
- 无法与服务器建立安全连接是什么意思 (74)
- 443/80端口被占用怎么解决 (56)
- ping无法访问目标主机怎么解决 (58)
- fdatasync (59)
- 405 not allowed (56)
- 免备案虚拟主机zxhost (55)
- linux根据pid查看进程 (60)
- dhcp工具 (62)
- mysql 1045 (57)
- 宝塔远程工具 (56)
- ssh服务器拒绝了密码 请再试一次 (56)
- ubuntu卸载docker (56)
- linux查看nginx状态 (63)
- tomcat 乱码 (76)
- 2008r2激活序列号 (65)