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

x33g5p2x  于2022-06-27 转载在 Java  
字(3.9k)|赞(0)|评价(0)|浏览(549)

欢迎访问我的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系列

相关文章