一、前言
ElasticSearch的Java客戶端中，[spring-data-elasticsearch](https://github.com/spring-projects/spring-data-elasticsearch) 簡化了 增刪改、建索引等，沒有簡化 複雜查詢 編碼。[easy-es](https://www.easy-es.cn/) API 類似 Mybatis-Plus，大幅降低開發門檻，減少程式碼量，支援 自定義排序、權重、原生查詢，留下了 廣闊的調整空間

二、Java客戶端

- ~~[Java Transport Client](https://www.elastic.co/guide/en/elasticsearch/client/java-api/current/index.html)~~：官方已棄用，二進位制協議，版本強繫結，不建議使用
- ~~[Jest](https://github.com/searchbox-io/Jest)~~：4年多沒釋出新版本，不維護了，不建議使用
- [Java REST Client](https://www.elastic.co/guide/en/elasticsearch/client/java-rest/current/index.html)：7.15 以下版本適用
- [Elasticsearch Java API Client](https://www.elastic.co/guide/en/elasticsearch/client/java-api-client/current/index.html)：7.16 版本釋出測試版，建議es 8.0 以上使用
- [spring-data-elasticsearch](https://github.com/spring-projects/spring-data-elasticsearch)：簡化了 增刪改、建索引等，沒有簡化 複雜查詢 編碼
- [easy-es](https://www.easy-es.cn/)：API 類似 Mybatis-Plus，大幅降低開發門檻，減少程式碼量，支援 自定義排序、權重、原生查詢，留下了 廣闊的調整空間

三、easy-es

1. [MySQL和 easy-es 語法對比 | Easy-Es](https://www.easy-es.cn/pages/8f3438/)
   
   | MySQL          | Easy-Es | es-DSL/es java api                        |
   | -------------- | ------- | ----------------------------------------- |
   | and            | and     | must                                      |
   | or             | or      | should                                    |
   | =              | eq      | term                                      |
   | !=             | ne      | boolQueryBuilder.mustNot(queryBuilder)    |
   | >              | gt      | QueryBuilders.rangeQuery('es field').gt() |
   | >=             | ge      | .rangeQuery('es field').gte()             |
   | <              | lt      | .rangeQuery('es field').lt()              |
   | <=             | le      | .rangeQuery('es field').lte()             |
   | like '%field%' | like    | QueryBuilders.wildcardQuery(field,value)  |
   | ...            |         |                                           |

2. [spring-boot配置](https://www.easy-es.cn/pages/eddebb/)
   
   注意：**`adress 不能以 http(s):// 開頭`**
   
   在 application.yml 配置檔案中新增：
   
   ```yml
   easy-es:
     enable: true # 是否開啟EE自動配置 預設開啟,可預設
     address: 域名:9200
     username: elastic
     password: 密碼
     banner: false # 預設為true 列印banner 若您不期望列印banner,可配置為false
     global-config:
       process-index-mode: smoothly #索引處理模式,smoothly:平滑模式,預設開啟此模式, not_smoothly:非平滑模式, manual:手動模式
       print-dsl: false # 開啟控制檯列印透過本框架生成的DSL語句，預設為開啟，測試穩定後的生產環境建議關閉，以提升少量效能
       async-process-index-blocking: false # 非同步處理索引是否阻塞主執行緒 預設阻塞 資料量過大時調整為非阻塞非同步進行 專案啟動更快
       db-config:
         table-prefix: # 索引字首,可用於區分環境 預設為空 用法和MP的tablePrefix一樣的作用和用法
         field-strategy: not_null # 欄位更新策略 預設為not_null
         refresh-policy: none # 預設為不重新整理，wait_until對寫入效能影響也很大
   ```

3. [新增依賴](https://www.easy-es.cn/pages/04414d/)
   
   如 maven，以 1.1.1 版本為例(最新版本是 2.0.0-beta1，後續討論)：
   
   ```xml
   <dependency>
     <groupid>cn.easy-es</groupid>
     <artifactid>easy-es-boot-starter</artifactid>
     <version>1.1.1</version>
   </dependency>
   ```

4. [編寫實體類](https://www.easy-es.cn/pages/ac41f0/)
   
   索引名稱：預設是 類名轉全小寫(沒有駝峰了)，建議駝峰類名指定
   
   keepGlobalPrefix：配合全域性配置 easy-es.global-config.db-config.table-prefix 實現多個環境公用es
   
   String型別欄位，1.1.1 版本預設為 keyword，為了便於後續升級，建議指定
   
   ```java
   @Data
   @IndexName(value = "document", keepGlobalPrefix = true)
   public class Document {
       /**
        * es中的id
        */
       private String id;
   
       /**
        * 檔案標題
       */
       @IndexField(fieldType = FieldType.KEYWORD)
       private String title;
   
       /**
        * 檔案內容
        */
       @IndexField(fieldType = FieldType.TEXT, analyzer = Analyzer.IK_SMART)
       private String content;
   }
   ```

5. 編寫Mapper類
   
   ```java
   public interface DocumentMapper extends BaseEsMapper<document> {
   }
   ```

6. 新增 @EsMapperScan 註解
   
   ```java
   @SpringBootApplication
   @EsMapperScan("com.xpc.easyes.sample.mapper")
   public class Application {
   
       public static void main(String[] args) {
           SpringApplication.run(Application.class, args);
       }
   
   }
   ```

7. 儲存
   
   ```java
   Document document = new Document();
   document.setTitle("老漢");
   document.setContent("推*技術過硬");
   int successCount = documentMapper.insert(document);
   ```

8. 更新
   
   ```java
   Document document1 = new Document();
   document1.setId("id");
   document1.setTitle("title1");
   documentMapper.updateById(document1);
   ```

9. 分頁查詢
   
   ```java
   documentMapper.pageQuery(EsWrappers.lambdaQuery(Document.class).eq(Document::getTitle, "老漢"), 1, 20)
   ```

四、總結

[easy-es](https://www.easy-es.cn/)，大幅降低開發門檻，減少程式碼量，支援 自定義排序、權重、原生查詢，留下了 廣闊的調整空間</document>

用easy-es簡化ElasticSearch操作

相關文章