一.概述

Spring Data Elasticsearch是Spring Data项目下的一个子模块.

简化了原生的Elasticsearch的开放。

Spring Data 的使命是给各种数据访问提供统一的编程接口，不管是关系型数据库（如MySQL），还是非关系数据库（如Redis），或者类似Elasticsearch这样的索引数据库。从而简化开发人员的代码，提高开发效率。

包含很多不同数据操作的模块：

特征：

• 支持Spring的基于@Configuration的java配置方式,只要在yml文件中配置,项目中就可以使用
• 提供了用于操作ES的便捷工具类ElasticsearchTemplate。包括实现文档到POJO之间的自动智能映射。类似于通用Mapper.通过对象操作ES.
• 利用Spring的数据转换服务实现的功能丰富的对象映射
• 基于注解的元数据映射方式，而且可扩展以支持更多不同的数据格式
• 根据持久层接口自动生成对应实现方法，无需人工编写基本操作代码（类似mybatis，根据接口自动得到实现）。当然，也支持人工定制查询

( 今天的正主就要开始了 (^_^)~喵~!! )

二.环境搭建

步骤一 : 首先,我们要修改我们Java项目中的pom 文件 ,在pom文件中添加 我们的依赖

<!--elasticsearch -->
<dependency>
   <groupId>org.springframework.boot</groupId>
   <artifactId>spring-boot-starter-data-elasticsearch</artifactId>
</dependency>

步骤二 : 其次,我们则需要修改我们的yml 文件 ,在yml 文件中添加有关我们 elasticsearch 的相关配置

spring:
  data:
    elasticsearch:
      cluster-name: elasticsearch
      cluster-nodes: 127.0.0.1:9300

 温馨小提示 : 修改我们的yml 文件,一定要确保格式是对的哦! 小喵有着深刻体会  (┭┮﹏┭┮)~.

小喵记得自己当时是这样写的 :

结果,可想而知报了个错....

小喵一开始以为是没注入这个对象,但是查看的时候发现注入了,经过大神帮忙发现是yml 文件 格式有问题

因为那些属性名没高亮 ....

 你们以为错误完了吗?不,看这, 迎面又跑来了一个错误(┭┮﹏┭┮)....

步骤三 :运行时,出现异常 :   Caused by: java.lang.IllegalStateException: availableProcessors is already set to [4], rejecting [4]

小喵网上查了一下这个错误,说是因为 netty冲突的问题 ,

同时,小喵也得到了解决方案 :

就是在项目初始化前设置一下一个属性。

方法有两种 :

两种方式都是用的一段代码 :

System.setProperty("es.set.netty.runtime.available.processors", "false");

   方法1 : 在我们的SpringBoot启动类中加入这段设置:

方法2 : 我们也可以单独为Elasticsearch写一个配置类,在配置类中初始化时设置

加入之后确实不报错了    (^_^) 终于可以敲代码了~~~

三 . 索引操作

步骤一 : 创建映射类 

        我们需要创建映射类, 用于表示java的数据和elasticsearch的数据对应关系。在spring data elasticsearch中使用注解完成。

注解名称	描述
@Document	用于配置Java类与索引/类型对应关系 - indexName：对应索引库名称 - type：对应在索引库中的类型 - shards：分片数量，默认5 - replicas：副本数量，默认1
@Id	唯一标识
@Field	用于配置Java属性和es的字段对应关系 – type：字段类型，枚举：FieldType – analyzer：分词器名称 – index：是否索引，布尔类型，默认是true – store：是否存储，布尔类型，默认是false

步骤二: 创建索引 、添加映射 、删除映射

ElasticsearchTemplate工具类提供对应方法完成以下功能：

• 创建索引： createIndex( 映射类.class )

• 添加映射： putMapping( 映射类.class )

• 删除索引： deleteIndex( 映射类.class )

 1 )创建测试类,在类中直接注入 ElasticsearchTemplate 工具类.

2 ) 调用对应的API方法进行操作

这样就完成了我们的创建索引、 添加映射 和 删除映射了.

四 .文档操作

文档操作的话,我们则需要继承一个接口.

Spring Data Elasticsearch提供了一个顶级接口 Repository，用于对“配置类”进行增删改查操作的。顶级类没有完成具体的功能，具体的功能通过子类完成

         PagingAndSortingRepository：（第二代）完成分页和排序功能

         ElasticsearchCrudRepository：（第三代）增删改查功能

         ElasticsearchRepository：（第四代）完成所有功能

编写：只需要编写子接口，继承 ElasticsearchRepository即可，且spring data自动加载该类。

• 注意：接口在使用时，需要确定2个泛型信息

  • 第一个泛型：映射类，ESBook

  • 第二个泛型：映射类唯一标识的类型，ID的类型 Long

使用：其他位置，直接注入repository子接口即可

 

添加数据

方法名	描述
save(T t )	保存一个数据
saveAll (T t)	保存一组数据

修改数据

        修改和添加我们使用的是同一个方法

        两者的区分标准 : 

                 如果id的值==有==对应的数据，则进行==更新==操作。
                 如果id的值==没有==对应的数据，则进行==添加==操作。

删除数据

 

这就是小喵所学到的SpringData整合Elasticsearch的文档操作!

后期也会更新查询操作哦!

(^_^)~喵~!!