我们的应用经常要添加一些检索功能,开源的ElasticSearch是目前全文检索引擎的首选,它可以快速的存储、搜索和分析海量数据。ElasticSearch是一个分布式搜索服务,提供Restful API,底层基于Lucene,采用多shard(分片)的方式保证数据安全,并且提供自动resharding的功能,github等大型站点也是采用ElasticSearch作为其搜索服务。
1、版本对应关系
SpringBoot通过整合Spring Data ElasticSearch为我们提供了非常便捷的检索功能支持,但是注意有版本的要求,官网要求如下:
本篇文章我基于springboot(2.2.0)+ spring-data-elasticsearch(3.2.0)+ elasticsearch(6.8.2)的版本给大家提供开发示例,详细内容参考Spring官方文档https://docs.spring.io/spring-data/elasticsearch/docs/3.2.1.RELEASE/reference/html/#reference
2、下载安装ElasticSearch
关于elasticsearch的知识这里不拓展介绍了,网上资料很多,也可以进入官网https://www.elastic.co/cn学习。进入官网下载页面https://www.elastic.co/cn/downloads/,下载对应系统和版本的二进制包,解压后进入bin目录执行elasticsearch启动脚本即可。访问http://localhost:9200/返回以下页面,说明启动成功
3、通过IntelliJ IDEA(或其它开发工具)搭建SpringBoot框架
- pom.xml的主要依赖包配置如下:
<dependencies>
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-data-elasticsearch</artifactId>
</dependency>
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-web</artifactId>
</dependency>
<dependency>
<groupId>org.springframework.data</groupId>
<artifactId>spring-data-elasticsearch</artifactId>
</dependency>
<dependency>
<groupId>org.elasticsearch</groupId>
<artifactId>elasticsearch</artifactId>
<version>6.8.2</version>
</dependency>
<dependency>
<groupId>org.projectlombok</groupId>
<artifactId>lombok</artifactId>
<optional>true</optional>
</dependency>
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-test</artifactId>
<scope>test</scope>
<exclusions>
<exclusion>
<groupId>org.junit.vintage</groupId>
<artifactId>junit-vintage-engine</artifactId>
</exclusion>
</exclusions>
</dependency>
</dependencies>
- application.properties配置文件如下:
#容器参数配置
server.port=8086
server.servlet.context-path=/building-web
#es参数配置
spring.data.elasticsearch.cluster-name=elasticsearch
spring.data.elasticsearch.cluster-nodes=127.0.0.1:9300
- 创建实体类
@Data
//indexName和type对应ElasticSearch的index和type
@Document(indexName = "all_person_index", type = "all_person_type")
public class Article {
@Id
private String id;
private String result;
private String human_id;
private String gender;
}
- 创建DAO层
@Repository
public interface ArticleRepository extends ElasticsearchRepository<Article, String> {
//根据SpringData语法自定义查询
public List<Article> findByResultLike(String name);
public List<Article> findByIdContainsAndResultContains(String id, String result);
//根据多字段模糊查询
public List<Article> findByIdContainsOrResultContains(String id, String result);
}
- 创建Service层
@Service(value = "humanService")
public class HumanService {
@Autowired
private ArticleRepository articleRepository;
public long getCount() {
return articleRepository.count();
}
public Article save(Article article) {
return articleRepository.index(article);
}
public List<Article> findByResult(String name) {
return articleRepository.findByResultLike(name);
}
public List<Article> findByIdContainsAndResultContains(String id, String result) {
return articleRepository.findByIdContainsOrResultContains(id, result);
}
}
- Controller层
@RestController
public class WebController {
@Autowired
private HumanService humanService;
//索引数据
@GetMapping(value = "/save.do")
public Article save() {
//Article article = new Article();
//article.setId("1");
//article.setGender("男");
//article.setHuman_id("human001");
//article.setResult("张三");
Article article = new Article();
article.setId("2");
article.setGender("女");
article.setHuman_id("human002");
article.setResult("张敏");
return humanService.save(article);
}
@GetMapping(value = "/test.do")
public long testEs() {
return humanService.getCount();
}
@GetMapping(value = "/find.do")
public List<Article> find() {
// return humanService.findByResult("张");
return humanService.findByIdContainsAndResultContains("1", "张");
}
}
调用save.do添加了两条数据后,查询es验证成功: