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

2024-09-06 08:32
文章标签 java springboot spring 整合 客户端 高级 搜索引擎 基础教程 resthighlevelclient elasticsearch7.10

本文主要是介绍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。

相关文章

Java中流式并行操作parallelStream的原理和使用方法

Java中流式并行操作parallelStream的原理和使用方法

《Java中流式并行操作parallelStream的原理和使用方法》本文详细介绍了Java中的并行流（parallelStream）的原理、正确使用方法以及在实际业务中的应用案例,并指出在使用并行流... 目录Java中流式并行操作parallelStream0. 问题的产生1. 什么是parallelS
阅读更多...
Java中Redisson 的原理深度解析

Java中Redisson 的原理深度解析

《Java中Redisson的原理深度解析》Redisson是一个高性能的Redis客户端,它通过将Redis数据结构映射为Java对象和分布式对象,实现了在Java应用中方便地使用Redis,本文... 目录前言一、核心设计理念二、核心架构与通信层1. 基于 Netty 的异步非阻塞通信2. 编解码器三、
阅读更多...
SpringBoot基于注解实现数据库字段回填的完整方案

SpringBoot基于注解实现数据库字段回填的完整方案

《SpringBoot基于注解实现数据库字段回填的完整方案》这篇文章主要为大家详细介绍了SpringBoot如何基于注解实现数据库字段回填的相关方法,文中的示例代码讲解详细,感兴趣的小伙伴可以了解... 目录数据库表pom.XMLRelationFieldRelationFieldMapping基础的一些代
阅读更多...
一篇文章彻底搞懂macOS如何决定java环境

一篇文章彻底搞懂macOS如何决定java环境

《一篇文章彻底搞懂macOS如何决定java环境》MacOS作为一个功能强大的操作系统,为开发者提供了丰富的开发工具和框架,下面：本文主要介绍macOS如何决定java环境的相关资料,文中通过代码... 目录方法一：使用 which命令方法二：使用 Java_home工具（Apple 官方推荐）那问题来了，
阅读更多...
Java HashMap的底层实现原理深度解析

Java HashMap的底层实现原理深度解析

《JavaHashMap的底层实现原理深度解析》HashMap基于数组+链表+红黑树结构,通过哈希算法和扩容机制优化性能,负载因子与树化阈值平衡效率,是Java开发必备的高效数据结构,本文给大家介绍... 目录一、概述：HashMap的宏观结构二、核心数据结构解析1. 数组（桶数组）2. 链表节点（Node
阅读更多...
Java AOP面向切面编程的概念和实现方式

Java AOP面向切面编程的概念和实现方式

《JavaAOP面向切面编程的概念和实现方式》AOP是面向切面编程,通过动态代理将横切关注点（如日志、事务）与核心业务逻辑分离,提升代码复用性和可维护性,本文给大家介绍JavaAOP面向切面编程的概... 目录一、AOP 是什么？二、AOP 的核心概念与实现方式核心概念实现方式三、Spring AOP 的关
阅读更多...
详解SpringBoot+Ehcache使用示例

详解SpringBoot+Ehcache使用示例

《详解SpringBoot+Ehcache使用示例》本文介绍了SpringBoot中配置Ehcache、自定义get/set方式,并实际使用缓存的过程,文中通过示例代码介绍的非常详细,对大家的学习或者... 目录摘要概念内存与磁盘持久化存储：配置灵活性：编码示例引入依赖：配置ehcache.XML文件：配置
阅读更多...
Java 虚拟线程的创建与使用深度解析

Java 虚拟线程的创建与使用深度解析

《Java虚拟线程的创建与使用深度解析》虚拟线程是Java19中以预览特性形式引入,Java21起正式发布的轻量级线程,本文给大家介绍Java虚拟线程的创建与使用,感兴趣的朋友一起看看吧... 目录一、虚拟线程简介1.1 什么是虚拟线程？1.2 为什么需要虚拟线程？二、虚拟线程与平台线程对比代码对比示例：三
阅读更多...
从基础到高级详解Go语言中错误处理的实践指南

从基础到高级详解Go语言中错误处理的实践指南

《从基础到高级详解Go语言中错误处理的实践指南》Go语言采用了一种独特而明确的错误处理哲学,与其他主流编程语言形成鲜明对比,本文将为大家详细介绍Go语言中错误处理详细方法,希望对大家有所帮助... 目录1 Go 错误处理哲学与核心机制1.1 错误接口设计1.2 错误与异常的区别2 错误创建与检查2.1 基础
阅读更多...
Java中的.close()举例详解

Java中的.close()举例详解

《Java中的.close()举例详解》.close()方法只适用于通过window.open()打开的弹出窗口,对于浏览器的主窗口,如果没有得到用户允许是不能关闭的,：本文主要介绍Java中的.... 目录当你遇到以下三种情况时，一定要记得使用 .close()：用法作用举例如何判断代码中的 input
阅读更多...

Copyright China编程 23002807@qq.com

沪ICP备2023033072号-2