es–基础–08–Spring Data ElasticSearch 使用
代码地址
https://gitee.com/DanShenGuiZu/learnDemo/tree/mysql_mybaties_DB/elasticsearch-learn
1、Spring Data ElasticSearch 简介
- 基于 spring data API 简化 elasticSearch操作,将原始操作elasticSearch的客户端API 进行封装 。
- 为Elasticsearch项目提供集成搜索引擎。Spring Data Elasticsearch POJO的关键功能区域为中心的模型与Elastichsearch交互文档和轻松地编写一个存储库数据访问层。
2、项目结构
3、创建项目
3.1、导入依赖
<!--elasticsearch 依赖 begin-->
<dependencies>
<dependency>
<groupId>org.elasticsearch</groupId>
<artifactId>elasticsearch</artifactId>
<version>5.6.8</version>
</dependency>
<dependency>
<groupId>org.elasticsearch.client</groupId>
<artifactId>transport</artifactId>
<version>5.6.8</version>
</dependency>
<dependency>
<groupId>org.springframework.data</groupId>
<artifactId>spring-data-elasticsearch</artifactId>
<version>3.0.5.RELEASE</version>
<exclusions>
<exclusion>
<groupId>org.elasticsearch.plugin</groupId>
<artifactId>transport-netty4-client</artifactId>
</exclusion>
</exclusions>
</dependency>
<!--elasticsearch 依赖 end-->
<!--测试依赖 begin-->
<dependency>
<groupId>org.springframework</groupId>
<artifactId>spring-test</artifactId>
<version>5.0.4.RELEASE</version>
</dependency>
<dependency>
<groupId>junit</groupId>
<artifactId>junit</artifactId>
<version>4.12</version>
</dependency>
<!--测试依赖 end-->
<dependency>
<groupId>org.projectlombok</groupId>
<artifactId>lombok</artifactId>
version>1.18.16</version>
<scope>provided</scope>
</dependency>
</dependencies>
3.2、创建bean
import lombok.Data;
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 = "blog7", type = "article")
@Data
public class Article {
@Id
// 定义mapping 映射
@Field(type = FieldType.Long, store = true)
private long id;
@Field(type = FieldType.text, store = true, analyzer = "ik_smart")
private String title;
@Field(type = FieldType.text, store = true, analyzer = "ik_smart")
private String content;
}
@Document(indexName = "blog7", type = "article")
indexName:索引的名称(必填项)
type:索引的类型
@Field(index=true,analyzer="ik_smart",store=true,searchAnalyzer="ik_smart",type = FieldType.text)
index:是否设置分词
analyzer:存储时使用的分词器
searchAnalyze:搜索时使用的分词器
store:是否存储
type: 数据类型
3.2、创建dao
import org.springframework.data.elasticsearch.repository.ElasticsearchRepository;
import fei.zhou.bean.Article;
public interface ArticleDao extends ElasticsearchRepository<Article, Long> {
}
3.3、配置文件
<?xml version="1.0" encoding="UTF-8"?>
<beans xmlns="http://www.springframework.org/schema/beans"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:context="http://www.springframework.org/schema/context"
xmlns:elasticsearch="http://www.springframework.org/schema/data/elasticsearch"
xsi:schemaLocation="
http://www.springframework.org/schema/beans
http://www.springframework.org/schema/beans/spring-beans.xsd
http://www.springframework.org/schema/context
http://www.springframework.org/schema/context/spring-context.xsd
http://www.springframework.org/schema/data/elasticsearch
http://www.springframework.org/schema/data/elasticsearch/spring-elasticsearch-1.0.xsd
">
<!--elastic客户对象的配置-->
<elasticsearch:transport-client id="esClient" cluster-name="elasticsearch"
cluster-nodes="60.205.188.229:9301,60.205.188.229:9302,60.205.188.229:9303" client-transport-sniff="false"/>
<!--配置包扫描器,扫描dao的接口-->
<elasticsearch:repositories base-package="fei.zhou.dao"/>
<!---->
<bean id="elasticsearchTemplate" class="org.springframework.data.elasticsearch.core.ElasticsearchTemplate">
<constructor-arg name="client" ref="esClient"/>
</bean>
</beans>
3.4、创建测试类
import org.junit.Test;
import org.junit.runner.RunWith;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.data.elasticsearch.core.ElasticsearchTemplate;
import org.springframework.test.context.ContextConfiguration;
import org.springframework.test.context.junit4.SpringJUnit4ClassRunner;
import fei.zhou.dao.ArticleDao;
@RunWith(SpringJUnit4ClassRunner.class)
@ContextConfiguration("classpath:applicationContext.xml")
public class SpringDataElasticSearchTest {
@Autowired
private ArticleDao articleDao;
@Autowired
private ElasticsearchTemplate template;
@Test
public void createIndex() throws Exception {
}
}
4、验证功能
4.1、 创建索引和映射
@Test
public void t1() throws Exception {
//通过实体类,创建索引,并配置映射关系
template.createIndex(Article.class);
}
4.2、 文档
-
dao 层可以使用的方法
4.2.1、 创建文档
@Test
public void t2() throws Exception {
for (int i = 1; i <= 10; i++) {
//创建一个Article对象
Article article = new Article();
article.setId(i);
article.setTitle("两头婚家庭的喜与忧" + i);
article.setContent("四年前,她和丈夫“两头婚”组建了家庭,不娶不嫁。约定要两个孩子,大的跟爸爸姓,小的跟妈妈姓。婚后,两边父母家轮流住。");
//把文档写入索引库
articleDao.save(article);
}
}
4.2.2、 删除文档
@Test
public void t3() throws Exception {
//通过id删除
articleDao.deleteById(1l);
//全部删除
articleDao.deleteAll();
}
4.2.3、 查询所有
@Test
public void t4() throws Exception {
Iterable<Article> iterator = articleDao.findAll();
iterator.forEach(a-> System.out.println(a));
}
4.2.4、 id查询
@Test
public void t5() throws Exception {
Optional<Article> optional = articleDao.findById(1l);
Article article = optional.get();
System.out.println(article);
}
4.2.5、常用查询命名规则
4.2.5.1、验证
public interface ArticleDao extends ElasticsearchRepository<Article, Long> {
List<Article> findByTitle(String title);
List<Article> findByTitleOrContent(String title, String content);
}
@Test
public void t6() throws Exception {
List<Article> list1 = articleDao.findByTitle("家庭");
for (Article article : list1) {
System.out.println(article);
}
System.out.println("----------------");
List<Article> list2 = articleDao.findByTitleOrContent("家庭", "和丈夫“两头婚”组建了家");
for (Article article : list2) {
System.out.println(article);
}
}
4.2.6、分页
public interface ArticleDao extends ElasticsearchRepository<Article, Long> {
List<Article> findByTitle(String title, Pageable pageable);
}
@Test
public void t7() throws Exception {
Pageable pageable = PageRequest.of(1, 2);
List<Article> list1 = articleDao.findByTitle("家庭",pageable);
for (Article article : list1) {
System.out.println(article);
}
}
4.2.7、使用es的原生查询对象进行查询,和restful请求本质一样
@Test
public void t8() throws Exception {
//创建一个查询对象
NativeSearchQuery query = new NativeSearchQueryBuilder()
.withQuery(QueryBuilders.queryStringQuery("喜与忧").defaultField("title"))
.withPageable(PageRequest.of(1, 5))
.build();
//执行查询
List<Article> articleList = template.queryForList(query, Article.class);
articleList.forEach(a-> System.out.println(a));
}