SpringBoot集成Elasticsearch

1、查询官方文档

1. 阅读官方文档

Elsticsearch官方文档地址Elasticsearch使用文档地址

使用Restful风格文档Restful风格文档地址注意：需要选择对应的版本

使用高级客户端高级客户端文档地址

2、SpringBoot集成Elasticsearch

1. 相关依赖

注意：由于SpringBoot默认整合的事elasticsearch的6.8.6版本，因此需要修改依赖的版本信息为当前elasticsearch对应的版本。

<properties>
    <elasticsearch.version>7.6.1elasticsearch.version>
properties>


<dependency>
    <groupId>org.springframework.bootgroupId>
    <artifactId>spring-boot-starter-data-elasticsearchartifactId>
dependency>

完整的配置信息如下：

<properties>
    <java.version>1.8java.version>
    <elasticsearch.version>7.6.1elasticsearch.version>
    <fastjson.version>1.2.72fastjson.version>
properties>
<dependencies>
    
    <dependency>
        <groupId>org.springframework.bootgroupId>
        <artifactId>spring-boot-starter-data-elasticsearchartifactId>
    dependency>
    
    
    <dependency>
        <groupId>org.springframework.bootgroupId>
        <artifactId>spring-boot-starter-webartifactId>
    dependency>

    
    <dependency>
        <groupId>org.springframework.bootgroupId>
        <artifactId>spring-boot-devtoolsartifactId>
        <scope>runtimescope>
        <optional>trueoptional>
    dependency>

    
    <dependency>
        <groupId>org.projectlombokgroupId>
        <artifactId>lombokartifactId>
        <optional>trueoptional>
    dependency>
    
    
    <dependency>
        <groupId>org.springframework.bootgroupId>
        <artifactId>spring-boot-starter-testartifactId>
        <scope>testscope>
    dependency>

    
    <dependency>
        <groupId>com.alibabagroupId>
        <artifactId>fastjsonartifactId>
        <version>${fastjson.version}version>
    dependency>
dependencies>

2. 初始化

RestHighLevelClient client = new RestHighLevelClient(
        RestClient.builder(
                new HttpHost("localhost", 9200, "http"),
                new HttpHost("localhost", 9201, "http")));

完整ES客户端配置信息类：

@Configuration
public class ElasticsearchConfig {
    @Bean
    public RestHighLevelClient restHighLevelClient() {
        RestHighLevelClient client = new RestHighLevelClient(
                RestClient.builder(
                        new HttpHost("127.0.0.1", 9200, "http")

                        /** 多个节点也是在当前地方配置 */
//                        , new HttpHost("localhost", 9300, "http")
                ));
        return client;
    }
}

3. 主要的API类的方法

1. 创建索引的API

@Autowired
private RestHighLevelClient restHighLevelClient;

/**
 * 功能描述：createIndex 测试索引的创建 

 *
 * @param
 * @return void
 * @Author xununan
 * @Date 2020-08-23 18:53
 * @Version 1.0.0
 */
@Test
void createIndexTest() throws IOException {
    // 1. 创建索引请求
    CreateIndexRequest firstIndex = new CreateIndexRequest("xununan_index");

    // 2. 客户端执行创建索引的请求
    CreateIndexResponse response = restHighLevelClient.indices().create(firstIndex, RequestOptions.DEFAULT);

    System.out.println(response);
}

2. 判断索引是否存在的API

@Autowired
private RestHighLevelClient restHighLevelClient;

/**
 * 功能描述：existsIndexTest 判断索引是否存在 

 *
 * @param
 * @return void
 * @Author xununan
 * @Date 2020-08-23 18:59
 * @Version 1.0.0
 */
@Test
void existsIndexTest() throws IOException {
    // 1. 创建一个get请求获取指定索引的信息
    GetIndexRequest getIndexRequest = new GetIndexRequest("xununan_index");

    // 2. 客户端执行请求判断索引是否存在
    boolean exists = restHighLevelClient.indices().exists(getIndexRequest, RequestOptions.DEFAULT);
    System.out.println(exists);
    if (!exists) {
        System.out.println(">>>>>>>>> 索引不存在。。。。。");
        return;
    }
}

3. 删除索引的API

@Autowired
private RestHighLevelClient restHighLevelClient;

/**
 * 功能描述：deleteIndexTest 删除指定的索引 

 *
 * @param
 * @return void
 * @Author xununan
 * @Date 2020-08-23 19:05
 * @Version 1.0.0
 */
@Test
void deleteIndexTest() throws IOException {
    // 1. 创建一个delete请求，用于删除索引信息
    DeleteIndexRequest deleteIndexRequest = new DeleteIndexRequest("xununan_index");

    // 2. 客户端执行删除请求
    AcknowledgedResponse result = restHighLevelClient.indices().delete(deleteIndexRequest, RequestOptions.DEFAULT);
    System.out.println(JSON.toJSON(result));
}

4. 创建文档的API

@Autowired
private RestHighLevelClient restHighLevelClient;

/**
 * 功能描述：创建文档 

 *
 * @return
 * @Author xununan
 * @Date 2020-08-23 19:11
 * @Version 1.0.0
 */
@Test
void addDocumentTest() throws IOException {
    // 1. 创建对象
    User user = new User("xununan", 27);

    // 2. 创建请求并指定索引
    IndexRequest indexRequest = new IndexRequest("xununan_index");

    // 3. 创建的规则：put /xununan_index/_doc/1
    indexRequest.id("1");            // 设置ID
    indexRequest.timeout("1s");      // 设置超时时间

    // 4. 将数据放入到请求中
    indexRequest.source(JSON.toJSONString(user), XContentType.JSON);

    // 5. 使用客户端发送请求
    IndexResponse index = restHighLevelClient.index(indexRequest, RequestOptions.DEFAULT);

    System.out.println(JSON.toJSONString(index));
}

5. 根据ID获取指定索引的文档信息

@Autowired
private RestHighLevelClient restHighLevelClient;

/**
 * 功能描述：getDocumentTest 获取文档信息 

 * @param
 * @return void
 *
 * @Author xununan
 * @Date 2020-08-23 19:40
 * @Version 1.0.0
 */
@Test
void getDocumentTest() throws IOException {
    // 1. 创建请求信息绑定索引和指定需要查询的文档id
    GetRequest getRequest = new GetRequest("xununan_index", "1");
    // 设置不获取的返回时的_source的上下文，一般情况是不需要设置的
//        getRequest.fetchSourceContext(new FetchSourceContext(false)).storedFields("_none_");

    // 2. 判断指定的索引和id是否存在
    boolean exists = restHighLevelClient.exists(getRequest, RequestOptions.DEFAULT);
    if (!exists) {
        System.out.println(">>>>>>>> 当前索引：xununan_index对应的id：1 不存在");
        return;
    }
    System.out.println(">>>>>>>> 当前索引：xununan_index对应的id：1 存在");
    // 3. 获取指定ID的资源信息
    GetResponse response = restHighLevelClient.get(getRequest, RequestOptions.DEFAULT);
    // 4. 打印获取到的资源信息
    System.out.println(response.getSourceAsString());
    System.out.println(JSON.toJSONString(response));
}

6. 根据ID更新文档信息

@Autowired
private RestHighLevelClient restHighLevelClient;

/**
 * 功能描述：updateDocmentTest 更新文档信息 

 * @param
 * @return void
 *
 * @Author xununan
 * @Date 2020-08-23 21:11
 * @Version 1.0.0
 */
@Test
void updateDocmentTest() throws IOException {
    // 1. 创建一个更新请求的信息，绑定索引名称和需要更新的文档ID
    UpdateRequest updateRequest = new UpdateRequest("xununan_index", "1");
    updateRequest.timeout("1s");     // 设置超时时间
    User user = new User("小明", 28);
    // 2. 封装需要更新的文档信息
    updateRequest.doc(JSON.toJSONString(user), XContentType.JSON);

    // 3. 使用update更新文档
    UpdateResponse updateResponse = restHighLevelClient.update(updateRequest, RequestOptions.DEFAULT);

    System.out.println(JSON.toJSONString(updateResponse));
}

7. 根据ID删除文档信息

@Autowired
private RestHighLevelClient restHighLevelClient;

/**
 * 功能描述：deleteDocmentTest 删除文档信息 

 * @param
 * @return void
 *
 * @Author xununan
 * @Date 2020-08-23 21:31
 * @Version 1.0.0
 */
@Test
void deleteDocmentTest() throws IOException {
    // 1. 创建一个删除的请求，绑定索引名和需要删除的文档ID
    DeleteRequest deleteRequest = new DeleteRequest("xununan_index", "1");


    // 2. 发起删除请求
    DeleteResponse response = restHighLevelClient.delete(deleteRequest, RequestOptions.DEFAULT);

    System.out.println(JSON.toJSONString(response));
}

8. 批量创建文档

@Autowired
private RestHighLevelClient restHighLevelClient;

/**
 * 功能描述：addDocmentByBatchTest 批量创建文档 

 * @param
 * @return void
 *
 * @Author xununan
 * @Date 2020-08-23 22:36
 * @Version 1.0.0
 */
@Test
void addDocmentByBatchTest() throws IOException {
    // 1. 创建批量的请求
    BulkRequest bulkRequest = new BulkRequest();
    bulkRequest.timeout("10s");     //  设置超时时间

    List<User> list = new ArrayList<>();
    User user = null;
    for (int i = 1; i <= 10; i++) {
        user = new User("姓名" + i, 20+i);
        list.add(user);
    }

    // 2. 将多条数据批量的放入bulkRequest中
    for (int i = 0; i <list.size(); i++) {
        // 批量更新和批量删除在这里修改对应的请求即可
        bulkRequest.add(new IndexRequest("xununan_index")
                .id("" + i)
                .source(JSON.toJSONString(list.get(i)), XContentType.JSON)
        );
    }
    
    // 3. 执行批量创建文档
    BulkResponse responses = restHighLevelClient.bulk(bulkRequest, RequestOptions.DEFAULT);
    System.out.println(responses.hasFailures());    // 是否失败，如果false则表示全部成功
    System.out.println(JSON.toJSONString(responses));
}

9. 指定条件模糊查询多条数据

@Autowired
private RestHighLevelClient restHighLevelClient;

/**
 * 功能描述：searchTest 批量搜索，可以设置高亮等信息 

 * @param
 * @return void
 *
 * @Author xununan
 * @Date 2020-08-23 22:58
 * @Version 1.0.0
 */
@Test
void searchTest() throws IOException {

    // 1. 创建批量搜索请求，并绑定索引
    SearchRequest searchRequest = new SearchRequest("xununan_index");

    // 2. 构建搜索条件
    SearchSourceBuilder sourceBuilder = new SearchSourceBuilder();
    // 【注意：这里有个坑，当中文查询时，如果使用ik分词器会查询不到数据，属性需要使用xxx.keyword才能查询到数据】
    TermQueryBuilder termQueryBuilder = QueryBuilders.termQuery("name.keyword", "姓名7"); // 设置精确查询
//        QueryBuilders.matchAllQuery();
    sourceBuilder.query(termQueryBuilder).timeout(new TimeValue(60, TimeUnit.SECONDS));

    // 3. 将查询条件放入搜索请求request中
    searchRequest.source(sourceBuilder);

    // 4. 发起查询请求获取数据
    SearchResponse response = restHighLevelClient.search(searchRequest, RequestOptions.DEFAULT);
    System.out.println(JSON.toJSONString(response));
    System.out.println(JSON.toJSONString(response.getHits().getHits()));
}