[ElasticSearch系列四] spring & elasticSearch (linux) 整合【附图解说】

前言 : 本章内容教会你如何在spring项目中整合 elasticSearch(数据库) 的相关配置

Es中数据存储的两种方式

• ElasticsearchTemplate

ElasticsearchTemplate 是 Spring 对 ElasticSearch 的 Java api 进行的封装，提供了大量的相关的类来完成各种各样的查询。

•  ElasticsearchRepository 

ElasticSearch Repository<T, ID extends Serializable> 继承 ElasticsearchCrudRepository<T, ID extends Serializable>,封装了对esCRUD操作的一系列方法,用户便可以通过自定义的Repository可以继承这两个类来完成对es的CRUD操作

• T指索引实体类
• ID指索引主键Id类型

---

spring 整合 elasticSearch 整体操作

1、引入Maven 依赖

• maven仓库中的spring-data-elasticsearch 依赖版本链接：https://mvnrepository.com/artifact/org.springframework.data/spring-data-elasticsearch

 <dependency>
        <groupId>org.springframework.data</groupId>
        <artifactId>spring-data-elasticsearch</artifactId>
        <version>3.1.5.RELEASE</version>
 </dependency>

2、添加 spring-es.xml 配置文件

<?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-4.3.xsd
		http://www.springframework.org/schema/data/elasticsearch http://www.springframework.org/schema/data/elasticsearch/spring-elasticsearch-1.0.xsd">
    <!--ElasticsearchRepository-->
    <!-- 扫描我们自定义的仓库所继承 ElasticsearchRepository类所在包(一般dao层)位置,spring-data是我们用来操作es的增删改查-->
    <elasticsearch:repositories base-package="com.cxl.dao" />
    <!--项目路径扫描 , 包裹住你所要使用es的包即可-->
    <context:component-scan base-package="com.cxl"></context:component-scan>
    <!-- 声明elasticsearchTemplate -->
    <bean name="elasticsearchTemplate"
          class="org.springframework.data.elasticsearch.core.ElasticsearchTemplate">
        <constructor-arg name="client" ref="client" />
    </bean>
    <!-- 声明elasticsearch客户端, cluster-nodes 对应的是你的Linux系统中的IP地址即java端口号-->
    <elasticsearch:transport-client id="client" cluster-nodes="192.168.182.130:9300" />
</beans>

3.声明一个接口继承Repository或者它的一个子接口来完成对es的CRUD操作

• T 指索引实体类
• ID 指索引主键Id类型

import com.cxl.entity.Orders;
import org.springframework.data.elasticsearch.repository.ElasticsearchRepository;

public interface OrdersRepository extends ElasticsearchRepository<T,ID> {
    
    //这里可以自定义方法,后面有介绍
}

 CrudRepository主要方法介绍

public interface CrudRepository<T, ID extends Serializable>
    extends Repository<T, ID> {

    // 将实体对应索引保存es中
    <S extends T> S save(S entity); 

    // 根据id查询实体索引
    T findOne(ID primaryKey);       

    // 返回所有实体类
    Iterable<T> findAll();          

    // 返回es中现有所有实体类的数量
    Long count();                   

    // 删除指定的实体类
    void delete(T entity);          

    // 根据指定的id判断某个实体是否存在
    boolean exists(ID primaryKey);  

    //根据主键ID删除对应实体
    void deleteById(ID id);

}

4、创建实体类及添加es索引注解

• indexName：对应索引库名称,相当于数据库名称
• type：对应在索引库中的类型，相当于表名称
• @Id：作用在成员变量，标记一个字段为id主键

import org.springframework.data.annotation.Id;
import org.springframework.data.elasticsearch.annotations.Document;
import org.springframework.format.annotation.DateTimeFormat;

import java.util.Date;

@Document(indexName = "index_orders",type = "orders")
public class Orders {
  
  @Id
  private String oid;            
  private String agename;    
  private String tel;
  @DateTimeFormat(pattern = "yyyy-MM-dd")
  private Date ordate;        //预约时间

  //get和set方法
  //toString()方法

这里仅对必要索引注解做了解释说明，如需深入了解看下文：

[ElasticSearch系列五] Spring Data Elasticsearch 实体类注解说明【专攻系】

---

Thanks