Davids实操笔记：Spring Boot 使用docker整合ElasticSearch

古城微笑少年丶 2023-02-23 07:58 24阅读 0赞

### 文章目录 ###

*   *  Davids实操笔记：Spring Boot 使用docker整合ElasticSearch
     *   *  准备工作
         *   *  新建Spring Boot项目
             *  安装ElasticSearch
             *  安装elasticsearch-head
         *  使用Spring Boot访问ElasticSearch
         *   *  添加application.yml配置
             *  启动Spring Boot project
             *  使用ElasticSearchRepository存取数据
         *  总结

## Davids实操笔记：Spring Boot 使用docker整合ElasticSearch ##

ElasticSearch是我们经常用到的搜索引擎之一，本篇博客从零开始使用docker安装elasticsearch，elasticsearch-head然后整合Spring Boot对数据进行新增和查询。由于篇幅原因，后面会分两篇blog实战使用分词器以及拼音搜索功能。

### 准备工作 ###

#### 新建Spring Boot项目 ####

添加我们需要使用的依赖，除了`elasticsearch`其他两个非必要，`web`是为了方便调试，如果没有使用过`lombok`的需要安装`IDEA//Eclipse`插件。

<dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-data-elasticsearch</artifactId>
    </dependency>
    
    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-web</artifactId>
    </dependency>
    
    <dependency>
        <groupId>org.projectlombok</groupId>
        <artifactId>lombok</artifactId>
        <optional>true</optional>
    </dependency>

#### 安装ElasticSearch ####

因为我的电脑是Windows10，所以这里我们选择使用docker来安装elasticsearch，操作简单。没有安装docker的可以试一下。[docker win10安装教学][docker win10]。

1.  首先我们访问[dockerhub][]找到`elasticsearch`，下载自己需要的版本，我这边就下载最新版。  
    ![dockerhub-elasticsearch][]
2.  打开shell命令，拉取镜像  
    ![拉取镜像][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L0Rhdmlkc18_size_16_color_FFFFFF_t_70]
3.  启动elasticsearch，我们按照[dockerhub description][]启动开发配置的elasticsearch。

// shell命令
    docker network create somenetwork
    
    docker run -d --name elasticsearch --net somenetwork -p 9200:9200 -p 9300:9300 -e "discovery.type=single-node" elasticsearch:tag

![How to use image][]  
灰色有些命令看不清楚，所以换个背景颜色，启动完成之后`docker ps`看一下容器是否启动成功。  
![启动完成][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L0Rhdmlkc18_size_16_color_FFFFFF_t_70 1]  
浏览器访问127.0.0.1:9200，查看是否启动成功。  
![127.0.0.1:9200][127.0.0.1_9200]

#### 安装elasticsearch-head ####

1.  同样适用docker安装，但是访问`dockerhub`的时候发现`elasticsearch-head`404了，执行`docker pull mobz/elasticsearch-head`也不可以，但是好在`docker pull mobz/elasticsearch-head:5`是可以拉取的，安装并启动。

// shell命令
    docker pull mobz/elasticsearch-head:5
    
    docker run -d --name es_admin -p 9100:9100 mobz/elasticsearch-head:5

![安装elasticsearch head][elasticsearch head]

1.  访问[http://127.0.0.1:9100/][http_127.0.0.1_9100]，检查head是否启动成功，发现head是启动成功了，但是没有连接上elasticsearch，因为我们自定义了网络，所以需要配置一下elasticsearch支持跨域访问。  
    ![elasticsearch head][elasticsearch head 1]
2.  配置elasticsearch.yml支持跨域。

// shell命令
    // 进入容器
    docker exec -it elasticsearch /bin/bash
    
    // 修改配置文件
    vi ./config/elasticsearch.yml
    
    // 添加以下配置
    http.cors.enabled: true
    http.cors.allow-origin: "*"
    
    // ctrl + c，:wq!保存配置
    // 退出容器
    exit
    
    // 重启elasticsearch
    docker restart elasticsearch

再重新访问一下[http://127.0.0.1:9100/][http_127.0.0.1_9100]，连接成功了。  
![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L0Rhdmlkc18_size_16_color_FFFFFF_t_70 2]

### 使用Spring Boot访问ElasticSearch ###

#### 添加application.yml配置 ####

# application.yml
    server:
      port: 8080
    
    spring:
      application:
        name: elasticsearch-demo
      elasticsearch:
        rest:
          uris: http://127.0.0.1:9200
          connection-timeout: 1s
          read-timeout: 30s

#### 启动Spring Boot project ####

我这里使用的是SpringBoot 2.x，在使用Spring Boot 1.5.x的时候可能会遇到`java.lang.ClassNotFoundException: com.sun.jna.Native`缺少Native依赖，这个时候只需要添加上相关依赖即可。

<dependency>
        <groupId>com.sun.jna</groupId>
        <artifactId>jna</artifactId>
        <version>3.0.9</version>
    </dependency>

![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L0Rhdmlkc18_size_16_color_FFFFFF_t_70 3]  
启动成功  
![启动完成][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L0Rhdmlkc18_size_16_color_FFFFFF_t_70 4]

#### 使用ElasticSearchRepository存取数据 ####

![项目结构][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L0Rhdmlkc18_size_16_color_FFFFFF_t_70 5]

// UserEntity 
    package com.example.elasticsearch.entity;
    
    import org.springframework.data.annotation.Id;
    import org.springframework.data.elasticsearch.annotations.Document;
    
    import lombok.AllArgsConstructor;
    import lombok.Builder;
    import lombok.Data;
    import lombok.NoArgsConstructor;
    
    @Data
    @NoArgsConstructor
    @AllArgsConstructor
    @Builder
    @Document(indexName = "user")
    public class UserEntity {
        
    
        @Id
        private Long userId;
    
        private String userName;
    
        private Integer age;
    
        private Integer sex;
    
    }
    
    // UserRepository 
    package com.example.elasticsearch.repository;
    
    import com.example.elasticsearch.entity.UserEntity;
    
    import org.springframework.data.elasticsearch.repository.ElasticsearchRepository;
    
    public interface UserRepository extends ElasticsearchRepository<UserEntity, Long> {
        
    
    }
    
    // ElasticSearchService 
    package com.example.elasticsearch.service;
    
    import com.example.elasticsearch.entity.UserEntity;
    
    import java.util.List;
    
    public interface ElasticSearchService {
        
    
        void saveUser( UserEntity userEntity );
    
        void saveUser( List<UserEntity> userEntity );
    
        UserEntity findById(Long id);
    
    }
    
    // ElasticSearchServiceImpl 
    package com.example.elasticsearch.service.impl;
    
    import com.example.elasticsearch.entity.UserEntity;
    import com.example.elasticsearch.repository.UserRepository;
    import com.example.elasticsearch.service.ElasticSearchService;
    
    import org.springframework.stereotype.Service;
    
    import java.util.List;
    
    import javax.annotation.Resource;
    
    @Service
    public class ElasticSearchServiceImpl implements ElasticSearchService {
        
    
        @Resource
        private UserRepository userRepository;
    
        @Override
        public void saveUser( UserEntity userEntity ) {
        
            userRepository.save(userEntity);
        }
    
        @Override
        public void saveUser( List<UserEntity> userEntity ) {
        
            userEntity.containsAll(userEntity);
        }
    
        @Override
        public UserEntity findById( Long id ) {
        
            return userRepository.findById(id).get();
        }
    }
    
    // Test
    package com.example.elasticsearch;
    
    import com.example.elasticsearch.entity.UserEntity;
    import com.example.elasticsearch.service.ElasticSearchService;
    
    import org.junit.jupiter.api.Test;
    import org.springframework.boot.test.context.SpringBootTest;
    
    import javax.annotation.Resource;
    
    @SpringBootTest
    class ElasticsearchApplicationTests {
        
    
        @Resource
        private ElasticSearchService elasticSearchService;
    
        @Test
        void save() {
        
            elasticSearchService.saveUser(UserEntity.builder()
                    .userId(1L).userName("David").age(18).sex(1)
                    .build());
        }
    
        @Test
        void findById() {
        
            UserEntity byId = elasticSearchService.findById(1L);
            System.out.println(byId);
        }
    
    }

数据插入成功后，head无法查看，因为我们使用的head是5，但是es是7，解析格式不同，所以我们需要修改`vendor.js`文件。

// 将vendor.js拷贝至本地
    docker cp es_admin:/usr/src/app/_site/vendor.js ./
    
    // 修改6886和7573行 application/x-www-form-urlencoded修改为application/json;charset=UTF-8
    // 将vendor.js拷贝到es_admines_admin原处
    docker cp vendor.js es_admin:/usr/src/app/_site

操作完成后直接刷新页面即可。  
![es-head][]

### 总结 ###

`ElasticSearch`是我们经常用到的搜索引擎之一，本篇博客从零开始使用`docker`安装`elasticsearch`，`elasticsearch-head`然后整合`Spring Boot`对数据进行新增和查询。后面会分两篇blog实战使用`分词器`以及`拼音搜索`功能。使用docker可以为我们很大的便利，docker对容器和镜像的管理使用起来非常简单，后面我还会使用docker来进行MongoDB实战，以及Linux的学习，大家可以到[docker菜鸟教程][docker]学习一下，玩一玩儿就会了。

[docker win10]: https://www.runoob.com/docker/windows-docker-install.html
[dockerhub]: https://hub.docker.com/_/elasticsearch?tab=tags
[dockerhub-elasticsearch]: https://img-blog.csdnimg.cn/20200706080524850.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L0Rhdmlkc18=,size_16,color_FFFFFF,t_70
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L0Rhdmlkc18_size_16_color_FFFFFF_t_70]: https://img-blog.csdnimg.cn/20200706080704416.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L0Rhdmlkc18=,size_16,color_FFFFFF,t_70
[dockerhub description]: https://hub.docker.com/_/elasticsearch?tab=description
[How to use image]: https://img-blog.csdnimg.cn/20200706081026706.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L0Rhdmlkc18=,size_16,color_FFFFFF,t_70
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L0Rhdmlkc18_size_16_color_FFFFFF_t_70 1]: https://img-blog.csdnimg.cn/20200706081533162.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L0Rhdmlkc18=,size_16,color_FFFFFF,t_70
[127.0.0.1_9200]: https://img-blog.csdnimg.cn/20200706082028129.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L0Rhdmlkc18=,size_16,color_FFFFFF,t_70
[elasticsearch head]: https://img-blog.csdnimg.cn/20200706083414816.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L0Rhdmlkc18=,size_16,color_FFFFFF,t_70
[http_127.0.0.1_9100]: http://127.0.0.1:9100/
[elasticsearch head 1]: https://img-blog.csdnimg.cn/20200706083926250.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L0Rhdmlkc18=,size_16,color_FFFFFF,t_70
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L0Rhdmlkc18_size_16_color_FFFFFF_t_70 2]: https://img-blog.csdnimg.cn/20200706084353751.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L0Rhdmlkc18=,size_16,color_FFFFFF,t_70
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L0Rhdmlkc18_size_16_color_FFFFFF_t_70 3]: https://img-blog.csdnimg.cn/68bc326c35454ed38311b20844d9ae44.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L0Rhdmlkc18=,size_16,color_FFFFFF,t_70
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L0Rhdmlkc18_size_16_color_FFFFFF_t_70 4]: https://img-blog.csdnimg.cn/20200706085513299.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L0Rhdmlkc18=,size_16,color_FFFFFF,t_70
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L0Rhdmlkc18_size_16_color_FFFFFF_t_70 5]: https://img-blog.csdnimg.cn/20200706094215351.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L0Rhdmlkc18=,size_16,color_FFFFFF,t_70
[es-head]: https://img-blog.csdnimg.cn/20200706095554565.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L0Rhdmlkc18=,size_16,color_FFFFFF,t_70
[docker]: https://www.runoob.com/docker/docker-install-nginx.html