java与es8实战之二：实战前的准备工作

2023-08-24 06:33 由程序员欣宸发表于 #后端开发

欢迎访问我的GitHub

这里分类和汇总了欣宸的全部原创(含配套源码)：https://github.com/zq2599/blog_demos

本篇概览

本篇是《java与es8实战》系列的第二篇，主要任务是为动手实战做好准备工作，包括这些内容

借助docker，快速部署es服务
借助docker-compose，以更简单的方式部署es集群和kibana服务
介绍实战中涉及的环境信息，例如JDK、软件、库的版本
聊聊java操作es的基本套路
为整个《java与es8实战》系列创建父工程，后面的实战有关的代码，全部写在这个父工程下面

OK，开始

借助docker，快速部署es服务

《java与es8实战》系列的重点是开发，因此不会花太多时间去讲解如何部署和配置es，基本上就是有个能用的es8环境即可
推荐您参考《Docker下elasticsearch8部署、扩容、基本操作实战(含kibana)》，这里面详细说明的如何在docker下快速部署es服务，以及一些常见的操作

借助docker-compose，以更简单的方式部署es集群和kibana服务

如果您觉得《Docker下elasticsearch8部署、扩容、基本操作实战(含kibana)》的操作过于复杂，想更简单的部署一个es集群，外加kibana开箱即用，可以参考《docker-compose快速部署elasticsearch-8.x集群+kibana》，另外此文还会告诉您如何部署一个无需安全检查(证书、账号密码)的es集群

介绍实战中的环境信息，给您作为参考

操作系统：macOS Monterey（M1 Pro芯片的MacBook Pro，16G内存）
Docker：Docker Desktop 4.7.1 (77678)
ElasticSearch：8.2.2
Kibana：8.2.2
JDK：openjdk 11.0.14.1
Maven：3.8.5
IDEA： 2022.1.2 (Ultimate Edition)
SpringBoot：2.7.0

聊聊java操作es的基本套路

从es官方的视角来看，提供了三种操作es的方式

Java Transport Client ：提供异步操作es的客户端API，自7.0.0版本开始被废弃，所以本系列是用不上了
Java REST Client：这个算是大名鼎鼎了，平常用的也很多，它由Low Level和Hight Level两部分组成，Low Level负责负载均衡、容错、持续连接、底层日志跟踪等基本能力，Hight Level是基于Low Level实现的，提供了原有的Transport Client的客户端能力，提供同步和异步两种操作模式，从7.X版本开始，es官方就给出了迁移指导：推荐用户从Java REST Client迁移到Java API Client
Java API Client：官方主推方案，依赖Elasticsearch core，对请求和响应都有强类型约束，支持jackson和JSON-b等两种序列化&反序列化方案，所有API都提供了同步和异步两种方式，推荐使用fluent style+lambda模式编码

从以上小结可以看出，在es8.x的环境下，使用Java API Client是首选，不过旧代码以Java REST Client居多，拿来也能在es8环境使用（通过一个api设置，让请求的header中带有兼容信息，es服务器收到此信息会以7.x模式处理请求）
再从spring视角来看如何操作es

Spring Data模块下属的Spring Data Elasticsearch是推荐的es操作方案
High Level REST Client是Spring Data中默认的底层实现
尽管Spring Data依然支持Java Transport Client，但推荐使用的是High Level REST Client
遗憾的是，Spring Data目前还不支持Java API Client，也不支持es的8.x版本，详情如下表，来自官方

由于《java与es8实战》系列已将es版本固定为8.2，因此，编码过程中，es操作方案选择es官方的Java API Client，和Spring Data不会有关系了

为整个《java与es8实战》系列创建父工程

整个系列后面的文章，少不了写代码，还是提前建好工程吧，用maven建立一个父工程，后面的代码都放在这个父工程下面，方便jar包版本和代码资源的统一管理
新建名为elasticsearch-tutorials的maven工程，其pom.xml内容如下，可见非常简单，仅仅是对jar做了些管理，再定义了一些常量，今后新增的子工程可以用到，例如SpringBoot版本为2.7.0

<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0"
         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">

    <modelVersion>4.0.0</modelVersion>
    <groupId>com.bolingcavalry</groupId>
    <artifactId>elasticsearch-tutorials</artifactId>
    <version>1.0-SNAPSHOT</version>
    <packaging>pom</packaging>
    <name>elasticsearch-tutorials</name>

    <properties>
        <java.version>11</java.version>
        <maven.compiler.source>11</maven.compiler.source>
        <maven.compiler.target>11</maven.compiler.target>
        <!--    <maven-compiler-plugin.version>3.6.1</maven-compiler-plugin.version>-->
        <springboot.version>2.7.0</springboot.version>
        <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
        <project.reporting.outputEncoding>UTF-8</project.reporting.outputEncoding>
        <elastic.version>8.2.2</elastic.version>
    </properties>

    <dependencyManagement>
        <dependencies>
            <dependency>
                <groupId>co.elastic.clients</groupId>
                <artifactId>elasticsearch-java</artifactId>
                <version>${elastic.version}</version>
            </dependency>

            <dependency>
                <groupId>com.fasterxml.jackson.core</groupId>
                <artifactId>jackson-databind</artifactId>
                <version>2.12.3</version>
            </dependency>

            <!-- Needed only if you use the spring-boot Maven plugin -->
            <dependency>
                <groupId>jakarta.json</groupId>
                <artifactId>jakarta.json-api</artifactId>
                <version>2.0.1</version>
            </dependency>

        </dependencies>
    </dependencyManagement>

</project>

至此，准备工作算是完成了，接下来文章会很轻松，和大家聊聊关于Java API Client的一些重要知识点，毕竟后面写代码全指望它了

欢迎关注博客园：程序员欣宸

学习路上，你不孤单，欣宸原创一路相伴...