Elasticsearch7.10搜索引擎RestHighLevelClient高级客户端整合Springboot基础教程

本文主要是介绍Elasticsearch7.10搜索引擎RestHighLevelClient高级客户端整合Springboot基础教程,希望对大家解决编程问题提供一定的参考价值,需要的开发者们随着小编来一起学习吧!

目录

一. 基本概念介绍

二. Elasticsearch服务端安装

三. Http rest api简单使用介绍

四. 整合到Springboot及使用RestHighLevelClient高级客户端

五. 后续


网络上关于Elasticsearch搜索引擎的教程不少, 但大多数都是比较老旧的, 甚至包括Elasticsearch官网的教程也是很久没有更新, 再加上Elasticsearch本身升级过程中不断的抛弃老旧概念, 新版本完全不兼容旧版本, 所以老旧教程给新入门的童鞋带来很多困惑.

这里使用当前Elasticsearch最新版本7.10.2结合Springboot2.X版本, 使用http rest api接口和RestHighLevelClient高级客户端封装的一些常用接口给新到的童鞋一些参考.

一. 基本概念介绍

本文侧重于讲述Elasticsearch的基本使用, 关于它的特性和基本概念, 您可以通过官网或其他网络文章了解. 这里只指出与本文有关的一些重要概念.

  • index:索引
    在7.0以前的版本中类似于数据库中的database概念, 由于在7.0版本后移除了type(或者或type只能为_doc这一种类型), 现在的index类似于数据库中的表(table).
  • document:文档
    类似于数据库中的一条记录
  • mapping:映射
    类似于数据库中的表结构, es中mapping可以支持动态映射, dynamic属性有true, false, strict 3种类型的值
  • field:字段
    类似于数据库中的column字段, 字段类型后面会介绍

二. Elasticsearch服务端安装

Elasticsearch官网下载相应操作系统最新版本压缩包, 解压即可, 无需任何额外配置. Elasticsearch运行环境依赖java, 必须先配置好java环境.

以Windows为例: 解压至D:\Apps\elasticsearch-7.10.2

启动: 执行bin目录下的.\elasticsearch.bat 即可启动. 默认http端口为9200, tcp端口为9300

启动成功后在浏览器地址栏输入 localhost:9200, 出现以下信息:

从GitHub上下载相同版本号的ik分词器插件: https://github.com/medcl/elasticsearch-analysis-ik, 解压后复制到elasticsearch/plugins目录下, 重启elasticsearch即可生效.

三. Http rest api简单使用介绍

elasticsearch.rest

### 查看索引 ${index}
GET {{esClusterNode}}/index_user
Accept: application/json### 创建索引 ${index} 指定设置和映射 address字段使用IK分词器分词
### analyzer和search_analyzer的区别:
### 在创建索引,指定analyzer,ES在创建时会先检查是否设置了analyzer字段,如果没定义就用ES预设的
### 在查询时,指定search_analyzer,ES查询时会先检查是否设置了search_analyzer字段,
### 如果没有设置,还会去检查创建索引时是否指定了analyzer,还是没有还设置才会去使用ES预设的
### ES分析器主要有两种情况会被使用:
### 1. 插入文档时,将text类型的字段做分词然后插入倒排索引,此时就可能用到analyzer指定的分词器
### 2. 在查询时,先对要查询的text类型的输入做分词,再去倒排索引搜索,此时就可能用到search_analyzer指定的分词器
PUT {{esClusterNode}}/index_user
Content-Type: application/json{"settings": {"number_of_shards": 3,"number_of_replicas": 2},"mappings": {"properties": {"id": {"type": "keyword"},"name": {"type": "keyword"},"age": {"type": "integer"},"sex": {"type": "keyword"},"email": {"type": "keyword"},"address": {"type": "text","analyzer": "ik_max_word","search_analyzer": "ik_max_word"}}}
}### 删除索引 ${index}
DELETE {{esClusterNode}}/index_user
Content-Type: application/x-www-form-urlencoded### 查看映射 ${index}/_mapping
GET {{esClusterNode}}/index_user/_mapping
Content-Type: application/x-www-form-urlencoded### 新增映射 ${index}/_mapping
PUT {{esClusterNode}}/index_user/_mapping
Content-Type: application/json{"properties": {"score": {"type": "float"}}
}### 新增文档 ${index}/_doc 自动生成ID(不推荐) 这里的ID是指es注解_id, 不是自定义的id字段
POST {{esClusterNode}}/index_user/_doc
Content-Type: application/json{"id": "100001","name": "张三","age": 23,"sex": "男","email": "zhangsan@163.com","address": "广东省深圳市龙华新区民治工业园29号"
}### 搜索文档 ${index}/_search 查询全部文档
GET {{esClusterNode}}/index_user/_search
Content-Type: application/json{"query": {"match_all": {}}
}### 查看文档 ${index}/_doc/${_id}
GET {{esClusterNode}}/index_user/_doc/-MVMlXcBnpDI88FS39oA
Accept: application/json### 新增文档 ${index}/_doc/${_id} 指定ID 推荐
POST {{esClusterNode}}/index_user/_doc/100002
Content-Type: application/json{"id": "100002","name": "李四","age": 45,"sex": "男","email": "lisi@163.com","address": "广东省深圳市龙华新区民治工业园27号"
}### 查看文档 ${index}/_doc/${_id}
GET {{esClusterNode}}/index_user/_doc/100002
Accept: application/json### 更新文档 ${index}/_doc/${_id} ID不存在则新增
PUT {{esClusterNode}}/index_user/_doc/100002
Content-Type: application/json{"id": "100002","name": "李四","age": 35,"sex": "男","email": "lisi666@163.com","address": "广东省广州市越秀区中心工业园81号"
}### 删除文档 ${index}/_doc/${_id}
DELETE {{esClusterNode}}/index_user/_doc/6WoDdncBA_HwaxaTfHFC
Content-Type: application/json### 搜索文档 ${index}/_search 查询全部文档
GET {{esClusterNode}}/index_user/_search
Content-Type: application/json{"query": {"match_all": {}}
}### 搜索文档 ${index}/_search 查询关键字
GET {{esClusterNode}}/index_user/_search
Content-Type: application/json{"query": {"match": {"address": "广东省"}}
}### 搜索文档 ${index}/_search 查询关键字
GET {{esClusterNode}}/index_user/_search
Content-Type: application/json{"query": {"match": {"age": "23"}}
}### 搜索文档 ${index}/_search 查询关键字 关键字也会被分词 例如, 输入深圳市, 匹配市会按 深圳市 深圳 市 进行搜索
GET {{esClusterNode}}/index_user/_search
Content-Type: application/json{"query": {"match": {"address": "深圳市"}}
}### 搜索文档 ${index}/_search 查询关键字 模糊查找 query match 高亮显示
GET {{esClusterNode}}/index_user/_search
Content-Type: application/json{"query": {"match": {"address": "广东省深圳市龙华新区民治工业园"}},"highlight": {"fields": {"address": {}}}
}### 搜索文档 ${index}/_search 查询关键字 精确查找 query term 高亮显示
GET {{esClusterNode}}/index_user/_search
Content-Type: application/json{"query": {"term": {"address": "广州"}},"highlight": {"fields": {"address": {}}}
}### 查看分词结果GET /${index}/_doc/${id}/_termvectors?fields=${fields_name}
GET {{esClusterNode}}/index_user/_doc/100002/_termvectors?fields=address
Accept: application/json

四. 整合到Springboot及使用RestHighLevelClient高级客户端

1. 为Springboot项目pom.xml添加elasticsearch及RestHighLevelClient高级客户端依赖

        <dependency><groupId>org.elasticsearch.client</groupId><artifactId>elasticsearch-rest-high-level-client</artifactId><version>${elasticsearch.version}</version></dependency><dependency><groupId>org.elasticsearch.client</groupId><artifactId>elasticsearch-rest-client</artifactId><version>${elasticsearch.version}</version></dependency><dependency><groupId>org.elasticsearch</groupId><artifactId>elasticsearch</artifactId><version>${elasticsearch.version}</version></dependency>

版本均选择7.10.2 这里不推荐使用spring-boot-starter-data-elasticsearch, starter难以控制elasticsearch及其依赖项的版本号.

elasticsearch-rest-high-level-client高级客户端依赖于elasticsearch-rest-client低级客户端, 由于elasticsearch版本间的兼容性非常差, 所以为避免出现一些意向不到的问题, 请保证elasticsearch, elasticsearch-rest-high-level-client, elasticsearch-rest-client, 如果后续需要使用ik分词器, kibana, logstash 使用同一个版本号.

2. 配置RestHighLevelClient高级客户端

  • 添加集群配置文件
    多个集群节点之间以英文逗号 , 分隔, 如 cluster-nodes: localhost:9200,localhost:9201
# es搜索引擎
elasticsearch:cluster-nodes: localhost:9200
  • RestHighLevelClient实例配置
    elasticsearch已经实现了负载均衡功能, 具体如何实现的, 资料很少.
    ElasticSearchConfig.java
import lombok.extern.slf4j.Slf4j;
import org.apache.http.HttpHost;
import org.elasticsearch.client.RestClient;
import org.elasticsearch.client.RestHighLevelClient;
import org.springframework.beans.factory.annotation.Value;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;import java.util.Arrays;/*** Elasticsearch配置** @author Aylvn* @date 2021-02-03*/
@Slf4j
@Configuration
public class ElasticSearchConfig {@Value("${elasticsearch.cluster-nodes}")private String clusterNodes;@Beanpublic RestHighLevelClient restHighLevelClient() {String[] nodes = clusterNodes.split(",");return new RestHighLevelClient(RestClient.builder(Arrays.stream(nodes).map(this::buildHttpHost).toArray(HttpHost[]::new)));}private HttpHost buildHttpHost(String node) {String[] nodeInfo = node.split(":");return new HttpHost(nodeInfo[0].trim(), Integer.parseInt(nodeInfo[1].trim()), "http");}
}

3. 常用的接口类

索引有关的操作
elasticsearch数据存取使用json格式进行交互的, 由于字段的不确定性, 这里使用Map<String, Object>的key-value键值对作为与elasticsearch交互的参数类型.
常量定义: EsConstant.java


import org.elasticsearch.client.RequestOptions;public class EsConstant {public static final RequestOptions DEFAULT_OPTIONS = RequestOptions.DEFAULT;public static final String ID = "id";public static final String INDEX_MAPPING_PROPERTIES = "properties";public static final String INDEX_MAPPING_DYNAMIC = "dynamic";public static final String INDEX_MAPPING_DYNAMIC_STRICT = "strict";public static final String INDEX_COMPANY = "index_company";public static final String DATE_FORMAT = "format&#

这篇关于Elasticsearch7.10搜索引擎RestHighLevelClient高级客户端整合Springboot基础教程的文章就介绍到这儿,希望我们推荐的文章对编程师们有所帮助!



http://www.chinasem.cn/article/1141517

相关文章

Spring Boot结成MyBatis-Plus最全配置指南

《SpringBoot结成MyBatis-Plus最全配置指南》本文主要介绍了SpringBoot结成MyBatis-Plus最全配置指南,包括依赖引入、配置数据源、Mapper扫描、基本CRUD操... 目录前言详细操作一.创建项目并引入相关依赖二.配置数据源信息三.编写相关代码查zsRArly询数据库数

SpringBoot实现MD5加盐算法的示例代码

《SpringBoot实现MD5加盐算法的示例代码》加盐算法是一种用于增强密码安全性的技术,本文主要介绍了SpringBoot实现MD5加盐算法的示例代码,文中通过示例代码介绍的非常详细,对大家的学习... 目录一、什么是加盐算法二、如何实现加盐算法2.1 加盐算法代码实现2.2 注册页面中进行密码加盐2.

一文详解如何从零构建Spring Boot Starter并实现整合

《一文详解如何从零构建SpringBootStarter并实现整合》SpringBoot是一个开源的Java基础框架,用于创建独立、生产级的基于Spring框架的应用程序,:本文主要介绍如何从... 目录一、Spring Boot Starter的核心价值二、Starter项目创建全流程2.1 项目初始化(

Spring Boot3虚拟线程的使用步骤详解

《SpringBoot3虚拟线程的使用步骤详解》虚拟线程是Java19中引入的一个新特性,旨在通过简化线程管理来提升应用程序的并发性能,:本文主要介绍SpringBoot3虚拟线程的使用步骤,... 目录问题根源分析解决方案验证验证实验实验1:未启用keep-alive实验2:启用keep-alive扩展建

SpringBoot配置Ollama实现本地部署DeepSeek

《SpringBoot配置Ollama实现本地部署DeepSeek》本文主要介绍了在本地环境中使用Ollama配置DeepSeek模型,并在IntelliJIDEA中创建一个Sprin... 目录前言详细步骤一、本地配置DeepSeek二、SpringBoot项目调用本地DeepSeek前言随着人工智能技

SpringBoot启动报错的11个高频问题排查与解决终极指南

《SpringBoot启动报错的11个高频问题排查与解决终极指南》这篇文章主要为大家详细介绍了SpringBoot启动报错的11个高频问题的排查与解决,文中的示例代码讲解详细,感兴趣的小伙伴可以了解一... 目录1. 依赖冲突:NoSuchMethodError 的终极解法2. Bean注入失败:No qu

Java异常架构Exception(异常)详解

《Java异常架构Exception(异常)详解》:本文主要介绍Java异常架构Exception(异常),具有很好的参考价值,希望对大家有所帮助,如有错误或未考虑完全的地方,望不吝赐教... 目录1. Exception 类的概述Exception的分类2. 受检异常(Checked Exception)

使用Java实现通用树形结构构建工具类

《使用Java实现通用树形结构构建工具类》这篇文章主要为大家详细介绍了如何使用Java实现通用树形结构构建工具类,文中的示例代码讲解详细,感兴趣的小伙伴可以跟随小编一起学习一下... 目录完整代码一、设计思想与核心功能二、核心实现原理1. 数据结构准备阶段2. 循环依赖检测算法3. 树形结构构建4. 搜索子

Spring定时任务只执行一次的原因分析与解决方案

《Spring定时任务只执行一次的原因分析与解决方案》在使用Spring的@Scheduled定时任务时,你是否遇到过任务只执行一次,后续不再触发的情况?这种情况可能由多种原因导致,如未启用调度、线程... 目录1. 问题背景2. Spring定时任务的基本用法3. 为什么定时任务只执行一次?3.1 未启用

springboot报错Invalid bound statement (not found)的解决

《springboot报错Invalidboundstatement(notfound)的解决》本文主要介绍了springboot报错Invalidboundstatement(not... 目录一. 问题描述二.解决问题三. 添加配置项 四.其他的解决方案4.1 Mapper 接口与 XML 文件不匹配