目录

一、ES的使用

1、添加

2、删除

3、修改

4、查询

①空查询

②查询表达式

③查询和过滤

④组合多查询

二、Easy-ES

1、什么是Easy-ES？

2、Easy-ES的作用？

3、如何使用？

①创建一个springboot项目

②导入依赖

③配置easy-es的属性

④配置扫描mapper文件

⑤测试

---

一、ES的使用

前提条件

index索引

动词：相当于mysql的insert

名词：相当于mysql的db

Type类型

在index中，可以定义一个或多个类型

类似于mysql的table，每一种类型的数据放在一起

Document文档

保存在某个index下，某种type的一个数据document，文档是json格式的，document就像是mysql中的某个table里面的内容。每一行对应的列叫属性

1、添加

# # 在customer索引下的external类型下保存1号数据
PUT customer/external/1


PUT my_index/_doc/1
{
  "group" : "fans",
  "user" : [
    {
      "first" : "John",
      "last" :  "Smith"
    },
    {
      "first" : "Alice",
      "last" :  "White"
    }
  ]
}

# POSTMAN输入
http://localhost:9200/customer/external/1

{
 "name":"John Doe"
}

1）POST和PUT的区别

POST新增。如果不指定id，会自动生成id。指定id就会修改这个数据，并新增版本号；

        可以不指定id，不指定id时永远为创建
        指定不存在的id为创建
        指定存在的id为更新，而版本号会根据内容变没变而觉得版本号递增与否

PUT可以新增也可以修改。PUT必须指定id；由于PUT需要指定id，我们一般用来做修改操作，不指定id会报错。
        必须指定id
        版本号总会增加

2、删除

1）删除文档或索引
DELETE customer/external/1
DELETE customer

3、修改

PUT my_index/_doc/1
{
  "group" : "fans",
  "user" : [
    {
      "first" : "John",
      "last" :  "Smith"
    },
    {
      "first" : "Alice",
      "last" :  "White"
    }
  ]
}

4、查询

GET /_cat/indices                查询所有的索引

①空查询

1）空查询

//空查询将返回所有索引库（indices)中的所有文档
GET /_search
{}

2）只用一个查询，你就可以在一个、多个或者 _all 索引库（indices）和一个、多个或者所有types中查询

GET /index_2014*/type1,type2/_search
{}

3）可以使用 from 和 size 参数来分页

GET /_search
{
  "from": 30,
  "size": 10
}

②查询表达式

1）空查询

        要使用这种查询表达式，只需将查询语句传递给 query 参数：

        

GET /_search
{
    "query": YOUR_QUERY_HERE
}

GET /_search
{
    "query": {
        "match_all": {}
    }
}

2）查询语句的结构

GET bank/_search
{
  "query":{
    "match":{
//下面是属性的字段的值
    "age":32
    }
  }
}

GET bank/_search
{
  "query": {
//下面的range和上面的match效果是一样的
    "range": {
      "age": {
        "gte": 20,
        "lt": 30
      }
  }
  } 
}

3）合并查询

一条复合语句可以合并 任何 其它查询语句，包括复合语句，了解这一点是很重要的。

{
    "bool": {
        "must":     { "match": { "tweet": "elasticsearch" }},
        "must_not": { "match": { "name":  "mary" }},
        "should":   { "match": { "tweet": "full text" }},
        "filter":   { "range": { "age" : { "gt" : 30 }} }
    }
}

③查询和过滤

④组合多查询

must

文档 必须 匹配这些条件才能被包含进来。

must_not

文档 必须不 匹配这些条件才能被包含进来。

should

如果满足这些语句中的任意语句，将增加 _score ，否则，无任何影响。它们主要用于修正每个文档的相关性得分。

filter

必须 匹配，但它以不评分、过滤模式来进行。这些语句对评分没有贡献，只是根据过滤标准来排除或包含文档。

GET bank/_search
{
  "query": {
    "bool": {
        "must":     { "match": { "title": "how to make millions" }},
        "must_not": { "match": { "tag":   "spam" }},
        "should": [
            { "match": { "tag": "starred" }}
        ],
        "filter": {
          "bool": { 
              "must": [
                  { "range": { "date": { "gte": "2014-01-01" }}},
                  { "range": { "price": { "lte": 29.99 }}}
              ],
              "must_not": [
                  { "term": { "category": "ebooks" }}
              ]
          }
        }
    }
  } 
}

二、Easy-ES

1、什么是Easy-ES？

一款基于ElasticSearch(简称Es)官方提供的RestHighLevelClient打造的ORM开发框架

2、Easy-ES的作用？

简单上手ElasticSearch

开发者只需要会MySQL语法即可使用Es,真正做到一通百通,无需学习枯燥易忘的Es语法,Es使用相对MySQL较低频,学了长期不用也会忘,没必要浪费这时间.开发就应该专注于业务,省下的时间去撸铁,去陪女朋友陪家人,不做资本家的韭菜；开发者只要会国内最受欢迎的Mybatis-Plus语法。

3、如何使用？

①创建一个springboot项目

②导入依赖

        <dependency>
            <groupId>cn.easy-es</groupId>
            <artifactId>easy-es-boot-starter</artifactId>
            <version>Latest Version</version>
        </dependency>

③配置easy-es的属性

easy-es:
  enable: true #默认为true,若为false则认为不启用本框架
  address : 127.0.0.1:9200 # es的连接地址,必须含端口 若为集群,则可以用逗号隔开 例如:127.0.0.1:9200,127.0.0.2:9200
  username: elastic #若无 则可省略此行配置
  password: WG7WVmuNMtM4GwNYkyWH #若无 则可省略此行配置

④配置扫描mapper文件

@SpringBootApplication
@EsMapperScan("com.xpc.easyes.sample.mapper")
public class Application {

    public static void main(String[] args) {
        SpringApplication.run(Application.class, args);
    }

}

⑤测试

1）测试插入

@Data
@IndexName("document")
public class Document {
    /**
     * es中的唯一id
     */
    private String id;

    /**
     * 文档标题
     */
    private String title;
    /**
     * 文档内容
     */
    private String content;

}

    

@Test
    public void testInsert() {
        // 测试插入数据
        Document document = new Document();
        document.setTitle("老汉");
        document.setContent("推*技术过硬");
        int successCount = documentMapper.insert(document);
        System.out.println(successCount);
    }

2）测试查询

    @Test
    public void testSelect() {
        // 测试查询
        String title = "老汉";
        LambdaEsQueryWrapper<Document> wrapper = new LambdaEsQueryWrapper<>();
        wrapper.eq(Document::getTitle,title);
        Document document = documentMapper.selectOne(wrapper);
        System.out.println(document);
        Assert.assertEquals(title,document.getTitle());
    }

3）测试更新

    @Test
    public void testUpdate() {
        // 测试更新 更新有两种情况 分别演示如下:
        // case1: 已知id, 根据id更新 (为了演示方便,此id是从上一步查询中复制过来的,实际业务可以自行查询)
        String id = "krkvN30BUP1SGucenZQ9";
        String title1 = "隔壁老王";
        Document document1 = new Document();
        document1.setId(id);
        document1.setTitle(title1);
        documentMapper.updateById(document1);

        // case2: id未知, 根据条件更新
        LambdaEsUpdateWrapper<Document> wrapper = new LambdaEsUpdateWrapper<>();
        wrapper.eq(Document::getTitle,title1);
        Document document2 = new Document();
        document2.setTitle("隔壁老李");
        document2.setContent("推*技术过软");
        documentMapper.update(document2,wrapper);

        // 关于case2 还有另一种省略实体的简单写法,这里不演示,后面章节有介绍,语法与MP一致
    }