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

Posted 2022-06-20 程序员欣宸

欢迎访问我的GitHub

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

本篇概览

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

1. 借助docker，快速部署es服务
2. 借助docker-compose，以更简单的方式部署es集群和kibana服务
3. 介绍实战中涉及的环境信息，例如JDK、软件、库的版本
4. 聊聊java操作es的基本套路
5. 为整个《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集群

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

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

聊聊java操作es的基本套路

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

1. Java Transport Client ：提供异步操作es的客户端API，自7.0.0版本开始被废弃，所以本系列是用不上了
2. Java REST Client：这个算是大名鼎鼎了，平常用的也很多，它由Low Level和Hight Level两部分组成，Low Level负责负载均衡、容错、持续连接、底层日志跟踪等基本能力，Hight Level是基于Low Level实现的，提供了原有的Transport Client的客户端能力，提供同步和异步两种操作模式，从7.X版本开始，es官方就给出了迁移指导：推荐用户从Java REST Client迁移到Java API Client
3. 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

1. Spring Data模块下属的Spring Data Elasticsearch是推荐的es操作方案
2. High Level REST Client是Spring Data中默认的底层实现
3. 尽管Spring Data依然支持Java Transport Client，但推荐使用的是High Level REST Client
4. 遗憾的是，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的一些重要知识点，毕竟后面写代码全指望它了

你不孤单，欣宸原创一路相伴

1. Java系列
2. Spring系列
3. Docker系列
4. kubernetes系列
5. 数据库+中间件系列
6. DevOps系列