SpringBoot入门建站全系列(二十五)结合Spring-data-elasticsearch进行全文检索
本文主要讲述spring-data-elasticsearch的简单使用。
一、概述
ElasticSearch是一个基于Lucene的搜索服务器。它提供了一个分布式多用户能力的全文搜索引擎,基于RESTful web接口。Elasticsearch是用Java开发的,并作为Apache许可条款下的开放源码发布,是当前流行的企业级搜索引擎。
ES是ElasticSearch的缩写;
ELK是三个开源软件的缩写,分别表示:Elasticsearch , Logstash, Kibana , 它们都是开源软件。
一般公司都是用ELK做日志分析,社区搜索之类的,很少单独使用ElasticSearch。但是单独使用ElasticSearch也很广泛,没有ELK的时候都是这样玩的。
比如我的社区网站(https://www.pomit.cn)就用了ElasticSearch做社区搜索,一开始做搜索的时候,曾有三种方案:
- Mysql的全文搜索,据说很慢,而且我的mysql版本也不支持中文,还要升级。
- 搜索引擎的支持,搜索引擎可以传入keyword、site对网站的某个网页做搜索,但是依赖于搜索引擎的收录情况。特别是百度渣渣,求它收录都难,必应还是蛮快的。但是都不够快。
- ElasticSearch做社区搜索,需要安装ElasticSearch。用了一段时间,感觉还可以。
首发地址: 品茗IT-同步发布
如果大家正在寻找一个java的学习环境,或者在开发中遇到困难,可以加入我们的java学习圈,点击即可加入,共同学习,节约学习时间,减少很多在学习中遇到的难题。
二、配置
本文假设你已经引入spring-boot-starter-web。已经是个SpringBoot项目了,如果不会搭建,可以打开这篇文章看一看《SpringBoot入门建站全系列(一)项目建立》。
2.1 Maven依赖
使用elasticsearch需要引入spring-data-elasticsearch,spring-data-elasticsearch的版本要和安装的elasticsearch保持一致。
版本对应如下:
最新的版本情况可以查看https://github.com/spring-projects/spring-data-elasticsearch.
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-web</artifactId>
</dependency>
<dependency>
<groupId>org.springframework.data</groupId>
<artifactId>spring-data-elasticsearch</artifactId>
<version>3.1.6.RELEASE</version>
</dependency>
<dependency>
<groupId>org.springframework.data</groupId>
<artifactId>spring-data-commons</artifactId>
<version>2.1.6.RELEASE</version>
</dependency>
如果spring-data-commons版本不适配当前的spring-data-elasticsearch,还需要额外引入spring-data-commons。
2.2 配置文件
在application.properties 中需要配置elasticsearch的信息,如:
spring.data.elasticsearch.cluster-name=elasticsearch
spring.data.elasticsearch.cluster-nodes=127.0.0.1:9300
spring.data.elasticsearch.repositories.enabled=true
我这里只用了一个elasticsearch节点。这里面,
- spring.data.elasticsearch.cluster-name是elasticsearch的名称。
- spring.data.elasticsearch.cluster-nodes是集群地址。
- spring.data.elasticsearch.repositories.enabled开启SpringData的常用写法(类似于Spring-Data-Jpa)
三、Elasticsearch访问数据层
我们直接使用Spring-data-elasticsearch, 一切都会变的特别简单。Spring-data-elasticsearch支持快速查询,也支持@Query之定义查询,要注意它的写法,和elasticsearch原生写法略有不同。
QuestionElasticsearchRepository :
package com.cff.springbootwork.elasticsearch.dao;
import org.springframework.data.domain.Page;
import org.springframework.data.domain.Pageable;
import org.springframework.data.elasticsearch.annotations.Query;
import org.springframework.data.elasticsearch.repository.ElasticsearchRepository;
import com.cff.springbootwork.elasticsearch.domain.FQuestionElasticssearch;
public interface QuestionElasticsearchRepository extends ElasticsearchRepository<FQuestionElasticssearch, Long> {
Page<FQuestionElasticssearch> findByCatory(String catory, Pageable pageable);
@Query("{ "bool":{ "must":[ { "multi_match": { "query": "?0", "type": "most_fields", "fields": [ "title", "content" ] } }, { "match": { "catory": "?1" } } ] } } ")
Page<FQuestionElasticssearch> searchByKeyWordsAndCatory(String keyword, String catory, Pageable pageable);
}
这个写法和Spring-data-jpa基本上一样,应该说Spring-data系列的写法都是类同的。
注意,FQuestionElasticssearch实体需要加上@Document注解指明Elasticssearch中的index和type。
四、测试Elasticssearch
我们定义一个service和web接口来做测试。
QuestionElasticsearchService:
package com.cff.springbootwork.elasticsearch.service;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.data.domain.Page;
import org.springframework.data.domain.PageRequest;
import org.springframework.data.domain.Pageable;
import org.springframework.stereotype.Service;
import org.springframework.util.StringUtils;
import com.cff.springbootwork.elasticsearch.dao.QuestionElasticsearchRepository;
import com.cff.springbootwork.elasticsearch.domain.FQuestionElasticssearch;
@Service
public class QuestionElasticsearchService {
@Autowired
QuestionElasticsearchRepository questionElasticsearchRepository;
public Page<FQuestionElasticssearch> pageByOpenAndCatory(Integer page, Integer size, String catory,
String keyWord) {
Pageable pageable = PageRequest.of(page, size);
if (StringUtils.isEmpty(keyWord)) {
return questionElasticsearchRepository.findByCatory(catory, pageable);
} else {
return questionElasticsearchRepository.searchByKeyWordsAndCatory(keyWord, catory, pageable);
}
}
}
ElasticsearchRest:
package com.cff.springbootwork.elasticsearch.web;
import java.util.List;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RequestMethod;
import org.springframework.web.bind.annotation.RequestParam;
import org.springframework.web.bind.annotation.RestController;
import com.cff.springbootwork.elasticsearch.domain.FQuestionElasticssearch;
import com.cff.springbootwork.elasticsearch.service.QuestionElasticsearchService;
@RestController
@RequestMapping("/elsearch")
public class ElasticsearchRest {
@Autowired
QuestionElasticsearchService questionElasticsearchService;
@RequestMapping(value = "/test", method = { RequestMethod.GET })
public List<FQuestionElasticssearch> test(@RequestParam(value = "value", required = false) String value) {
return questionElasticsearchService.pageByOpenAndCatory(0, 10, "Spring专题", value).getContent();
}
}
五、过程中用到的实体
FQuestionElasticssearch:
package com.cff.springbootwork.elasticsearch.domain;
import org.springframework.data.annotation.Id;
import org.springframework.data.elasticsearch.annotations.Document;
@Document(indexName = "pomit", type = "issue", createIndex = false)
public class FQuestionElasticssearch {
@Id
private Long id;
private String title;
private String catory;
private String content;
public FQuestionElasticssearch() {
}
public Long getId() {
return id;
}
public void setId(Long id) {
this.id = id;
}
public void setCatory(String catory) {
this.catory = catory;
}
public String getCatory() {
return catory;
}
public String getTitle() {
return title;
}
public void setTitle(String title) {
this.title = title;
}
public String getContent() {
return content;
}
public void setContent(String content) {
this.content = content;
}
}
快速构建项目
Spring项目快速开发工具:
一键快速构建Spring项目工具
一键快速构建SpringBoot项目工具
一键快速构建SpringCloud项目工具
一站式Springboot项目生成
Mysql一键生成Mybatis注解Mapper
Spring组件化构建
SpringBoot组件化构建
SpringCloud服务化构建
喜欢这篇文章么,喜欢就加入我们一起讨论SpringBoot使用吧!