SpringBoot中整合ElasticSearch实现增删改查等操作

场景

SpringBoot中整合ElasticSearch快速入门以及踩坑记录:

https://blog.csdn.net/BADAO_LIUMANG_QIZHI/article/details/135599698

在上面进行集成的基础上,实现对ES数据的增删改查等操作。

注:

博客:
霸道流氓气质-CSDN博客

实现

1、ElastciSearch的对象映射

Spring Data Elasticsearch - Reference Documentation

Spring Data Elasticsearch 对象映射是将 Java 对象(域实体)映射到存储在 Elasticsearch 中的 JSON 表示并返回的过程。

可用注解参考官网明细:

@Document:在类级别应用,以指示此类是映射到数据库的候选项。 最重要的属性是:

indexName:要存储此实体的索引的名称。 这可以包含一个 SpEL 模板表达式,例如"log-#{T(java.time.LocalDate).now().toString()}"

type:映射类型。 如果未设置,则使用类的小写简单名称。(自 4.0 版起已弃用)

shards:索引的分片数。

replicas:索引的副本数。

refreshIntervall:索引的刷新间隔。 用于创建索引。 默认值为“1s”。

indexStoreType:索引的索引存储类型。 用于创建索引。 默认值为“fs”。

createIndex:标记是否在存储库引导时创建索引。 默认值为 true。 请参阅使用相应映射自动创建索引

versionType:版本管理的配置。 默认值为 EXTERNAL。

@Id:在字段级别应用以标记用于标识目的的字段。

@Transient:默认情况下,所有字段在存储或检索文档时都映射到文档,此注释不包括该字段。

@PersistenceConstructor:标记给定的构造函数(甚至是受包保护的构造函数)以在从数据库实例化对象时使用。 构造函数参数按名称映射到检索到的 Document 中的键值。

@Field:应用于字段级别并定义字段的属性,大部分属性映射到相应的 Elasticsearch Mapping 定义(以下列表不完整,请查看注解 Javadoc 以获取完整参考):

name:将在 Elasticsearch 文档中表示的字段名称,如果未设置,则使用 Java 字段名称。

type:字段类型,可以是 Text、Keyword、Long、Integer、Short、Byte、Double、Float、Half_Float、Scaled_Float、Date、Date_Nanos、Boolean、Binary、Integer_Range、Float_Range、Long_Range、Double_Range、Date_Range、Ip_Range、Object、Nested、Ip、TokenCount、Percolator、Flattened、Search_As_You_Type之一。 请参阅 Elasticsearch 映射类型

format以及 Date 类型的定义。pattern

store:标记是否应将原始字段值存储在 Elasticsearch 中,默认值为 false。

analyzer、 ,用于指定自定义分析器和规范化程序。searchAnalyzernormalizer

@GeoPoint:将字段标记为geo_point数据类型。 如果字段是类的实例,则可以省略。GeoPoint

当然也可以自定义转换规则:

按照以上注解说明,新建实体类

import lombok.AllArgsConstructor;
import lombok.Builder;
import lombok.Data;
import lombok.NoArgsConstructor;
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="books",createIndex = true)
@Data
@Builder
@NoArgsConstructor
@AllArgsConstructor
public class ElasticBook {
    @Id
    private Integer id;

    @Field(type = FieldType.Text)
    private String name;

    @Field(type = FieldType.Text)
    private String summary;

    @Field(type = FieldType.Integer)
    private Integer price;
}

这里createIndex 默认就是true,可以不写,代表如果索引不存在则创建。

2、增删改查实现

新建接口Repository,使其继承ElasticsearchRepository

import com.ruoyi.system.domain.study.ElasticBook;
import org.springframework.data.elasticsearch.repository.ElasticsearchRepository;
import org.springframework.stereotype.Repository;
import java.util.List;

@Repository
public interface ElasticSearchRepository extends ElasticsearchRepository {
    List findByName(String name);
}

则可以直接使用其自带的各种方法

SpringBoot中整合ElasticSearch实现增删改查等操作_第1张图片

也可以自定义方法,比如findByName就是根据书名模糊搜索

自定义派生的方法不用实现,只要符合其关键字和规则可自动实现。

这块可参考官网从方法名称创建查询说明:

Spring Data Elasticsearch - Reference Documentation

3、新建Service接口

import java.util.List;

public interface IElasticSearchService {

    void save(ElasticBook book);

    ElasticBook findById(Integer id);

    void update(ElasticBook book);

    void deleteById(Integer id);

    List findByName(String name);
}

4、新建service实现

import com.ruoyi.system.repository.ElasticSearchRepository;
import com.ruoyi.system.service.IElasticSearchService;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.stereotype.Service;
import java.util.List;

@Service
public class ElasticSearchServiceImpl implements IElasticSearchService {

    @Autowired
    private ElasticSearchRepository repository;

    @Override
    public void save(ElasticBook book) {
        repository.save(book);
    }

    @Override
    public ElasticBook findById(Integer id) {
        return repository.findById(id).get();
    }

    @Override
    public void update(ElasticBook book) {
        repository.save(book);
    }

    @Override
    public void deleteById(Integer id) {
        repository.deleteById(id);
    }

    @Override
    public List findByName(String name) {
        return repository.findByName(name);
    }
}

5、编写单元测试

@RunWith(SpringRunner.class)
@SpringBootTest(classes = RuoYiApplication.class,webEnvironment = SpringBootTest.WebEnvironment.RANDOM_PORT)
public class ElasticSearchTest {

    @Autowired
    @Qualifier("elasticsearchClient")
    public RestHighLevelClient highLevelClient;

    @Autowired
    private IElasticSearchService iElasticSearchService;

    @Test
    public void connecTest() throws IOException {
        CreateIndexRequest request = new CreateIndexRequest("test");
        CreateIndexResponse response = highLevelClient.indices().create(request, RequestOptions.DEFAULT);
        // 查看是否创建成功
        System.out.println(response.isAcknowledged());
        highLevelClient.close();
    }

    //保存
    @Test
    public void saveTest() throws IOException {
        ElasticBook book = ElasticBook.builder().id(1).name("书名1").summary("霸道的程序猿").price(100).build();
        iElasticSearchService.save(book);
        highLevelClient.close();
        System.out.println("保存成功");
    }

    //根据主键查询
    @Test
    public void findTest() throws IOException {
        ElasticBook book = ElasticBook.builder().id(2).name("书名2").summary("霸道的程序猿").price(80).build();
        iElasticSearchService.save(book);
        ElasticBook book1 = iElasticSearchService.findById(2);
        highLevelClient.close();
        System.out.println("查询成功");
        System.out.println(book1);
    }

    //根据主键更新
    @Test
    public void updateTest() throws IOException {
        ElasticBook book = ElasticBook.builder().id(2).name("书名2更新").summary("霸道的程序猿").price(80).build();
        iElasticSearchService.update(book);
        ElasticBook book1 = iElasticSearchService.findById(2);
        highLevelClient.close();
        System.out.println("更新成功");
        System.out.println(book1);
    }

    //根据主键删除
    @Test
    public void deleteTest() throws IOException {
        iElasticSearchService.deleteById(1);
        highLevelClient.close();
        System.out.println("删除成功");
    }

    //派生查询
    @Test
    public void findByNameTest() throws IOException {
        List bookList = iElasticSearchService.findByName("书名");
        highLevelClient.close();
        System.out.println("查询成功");
        System.out.println(bookList);
    }
}

6、单元测试运行结果

保存结果

SpringBoot中整合ElasticSearch实现增删改查等操作_第2张图片

根据主键查询结果

SpringBoot中整合ElasticSearch实现增删改查等操作_第3张图片

更新结果

SpringBoot中整合ElasticSearch实现增删改查等操作_第4张图片

模糊搜索

SpringBoot中整合ElasticSearch实现增删改查等操作_第5张图片

7、关于查询与扩展

通过上面简单入门后,关于查询还有计数、排序、分页、条件等高级用法,这里可以在需要用到时再查询官方文档查看

你可能感兴趣的:(SpringBoot,spring,boot,elasticsearch,jenkins)