文章目录

  • 一、检索
  • 下载ElasticSearch
  • 二、概念
  • 面向文档
  • JSON
  • 三、整合ElasticSearch测试
  • 引入spring-boot-starter-data-elasticsearch
  • SpringData ElasticSearch
  • Jest
  • 安装Spring Data 对应版本的ElasticSearch
  • application.yml配置
  • SpringData ElasticSearch
  • Jest
  • Spring Boot自动配置的 ElasticsearchRepository、ElasticsearchTemplate、Jest
  • SpringData ElasticSearch
  • Jest
  • 测试ElasticSearch
  • SpringData ElasticSearch
  • Jest


一、检索

我们的应用经常需要添加检索功能,开源的 ElasticSearch 是目前全文搜索引擎的首选。他可以快速的存储、搜索和分析海量数据。Spring Boot通过整合Spring Data ElasticSearch为我们提供了非常便捷的检索功能支持;

Elasticsearch是一个分布式搜索服务,提供Restful API,底层基于Lucene,采用多shard(分片)的方式保证数据安全,并且提供自动resharding的功能,github等大型的站点也是采用了ElasticSearch作为其搜索服务,

下载ElasticSearch

下载时必须指定版本没有latest版

docker pull elasticsearch:7.1.1
docker images

solr springboot全文检索 springer检索_spring

安装6.xx或7.xx的小伙伴们一定要注意写-e "discovery.type=single-node"否则会闪退
docker run -e ES_JAVA_OPTS="-Xms256m -Xmx256m" -e "discovery.type=single-node" -d -p 9200:9200 -p 9300:9300 --name ES b0e9f9f047e6
初始堆栈内存为2G虚拟机没有这么大的空间,所以要限制否则会报错
ES_JAVA_OPTS="-Xms256m -Xmx256m":限制堆栈内存

solr springboot全文检索 springer检索_spring_02

二、概念

面向文档

Elasticsearch 是 面向文档 的,意味着它存储整个对象或 文档_。Elasticsearch 不仅存储文档,而且 _索引 每个文档的内容使之可以被检索。在 Elasticsearch 中,你 对文档进行索引、检索、排序和过滤–而不是对行列数据。这是一种完全不同的思考数据的方式,也是 Elasticsearch 能支持复杂全文检索的原因。

JSON

Elasticsearch 使用 JavaScript Object Notation 或者 JSON 作为文档的序列化格式。JSON 序列化被大多数编程语言所支持,并且已经成为 NoSQL 领域的标准格式。 它简单、简洁、易于阅读。

考虑一下这个 JSON 文档,它代表了一个 user 对象:

{
    "email":      "john@smith.com",
    "first_name": "John",
    "last_name":  "Smith",
    "info": {
        "bio":         "Eco-warrior and defender of the weak",
        "age":         25,
        "interests": [ "dolphins", "whales" ]
    },
    "join_date": "2014/05/01"
}

虽然原始的 user 对象很复杂,但这个对象的结构和含义在 JSON 版本中都得到了体现和保留。在 Elasticsearch 中将对象转化为 JSON 并做索引要比在一个扁平的表结构中做相同的事情简单的多。

以员工文档 的形式存储为例:一个文档代表一个员工数据。存储数据到 ElasticSearch 的行为叫做 索引 ,但在索引一个文档之前,需要确定将文档存储在哪里。

一个 ElasticSearch 集群可以 包含多个 索引 ,相应的每个索引可以包含多个 类型 。 这些不同的类型存储着多个 文档 ,每个文档又有多个属性

类似关系:

索引-数据库

类型-表

文档-表中的记录

属性-列

solr springboot全文检索 springer检索_solr springboot全文检索_03


对于雇员目录,我们将做如下操作:

每个雇员索引一个文档,包含该雇员的所有信息。
每个文档都将是 employee 类型 。
该类型位于 索引 megacorp 内。
该索引保存在我们的 Elasticsearch 集群中。
实践中这非常简单(尽管看起来有很多步骤),我们可以通过一条命令完成所有这些动作:

PUT /megacorp/employee/1
{
    "first_name" : "John",
    "last_name" :  "Smith",
    "age" :        25,
    "about" :      "I love to go rock climbing",
    "interests": [ "sports", "music" ]
}

注意,路径 /megacorp/employee/1 包含了三部分的信息:

megacorp
索引名称
employee
类型名称
1
特定雇员的ID
请求体 —— JSON 文档 —— 包含了这位员工的所有详细信息,他的名字叫 John Smith ,今年 25 岁,喜欢攀岩。

很简单!无需进行执行管理任务,如创建一个索引或指定每个属性的数据类型之类的,可以直接只索引一个文档。Elasticsearch 默认地完成其他一切,因此所有必需的管理任务都在后台使用默认设置完成。

三、整合ElasticSearch测试

引入spring-boot-starter-data-elasticsearch

SpringData ElasticSearch

<!--SpringBoot默认使用SpringData ElasticSearch模块进行操作-->
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-data-elasticsearch</artifactId>
        </dependency>

Jest

我的jest必须用7.1.1版本的ElasticSearch????

<!-- https://mvnrepository.com/artifact/io.searchbox/jest -->
        <dependency>
            <groupId>io.searchbox</groupId>
            <artifactId>jest</artifactId>
            <version>6.3.1</version>
        </dependency>

安装Spring Data 对应版本的ElasticSearch

solr springboot全文检索 springer检索_Elastic_04


solr springboot全文检索 springer检索_solr springboot全文检索_05


我的版本是3.1.8对应的是6.2.2但是没有此版本我在docker hub上搜索到6.6.2,应用后错误消除

application.yml配置

SpringData ElasticSearch

spring.data.elasticsearch.cluster-name=docker-cluster
spring.data.elasticsearch.cluster-nodes=192.168.43.105:9300

Jest

spring.elasticsearch.jest.uris=http://192.168.43.105:9200

Spring Boot自动配置的 ElasticsearchRepository、ElasticsearchTemplate、Jest

package com.matthew.elastic;

import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
/*
 * @Description:
 * TODO SpringBoot默认支持两种技术来和ES交互;
 *      1. Jest(默认不生效)
 *             需要导入jest的工具包(io.searchbox.client.JestClient)
 *      2.  SpringData ElasticSearch
 *              版本适配说明:https://github.com/spring-projects/spring-data-elasticsearch
 *              没有6.2.2可用下载6.6.2
 *              如果版本不适配:
 *                  1)、升级SpringBoot版本
 *                  2)、安装对应版本的ES
 *             1)、Client clusterNode; clusterName
 *             2)、ElasticsearchTemplate 操作es
 *             3)、编写一个ElasticsearchRepository的子接口来操作ES‘
 *         两种用法
 *              1)、编写一个ElasticsearchRepository
 */
@SpringBootApplication
public class Springboot03ElasticApplication {

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

}

SpringData ElasticSearch

package com.matthew.elastic.repository;

import com.matthew.elastic.bean.Book;
import org.springframework.data.elasticsearch.repository.ElasticsearchRepository;

import java.util.List;

public interface BookRepository extends ElasticsearchRepository<Book,Integer> {

    public List<Book> findByBookNameLike(String bookName);
}
package com.matthew.elastic.bean;

import org.springframework.data.elasticsearch.annotations.Document;

/**
 * @Description TODO
 * @Author Matthew
 * @Date 2019/6/18 19:57
 * @Version 1.0
 */
@Document(indexName = "matthew",type = "book")
public class Book {
    private Integer id;
    private String bookName;
    private String author;

    @Override
    public String toString() {
        return "Book{" +
                "id=" + id +
                ", bookName='" + bookName + '\'' +
                ", author='" + author + '\'' +
                '}';
    }

    public Integer getId() {
        return id;
    }

    public void setId(Integer id) {
        this.id = id;
    }

    public String getBookName() {
        return bookName;
    }

    public void setBookName(String bookName) {
        this.bookName = bookName;
    }

    public String getAuthor() {
        return author;
    }

    public void setAuthor(String author) {
        this.author = author;
    }
}

Jest

package com.matthew.elastic.bean;

import io.searchbox.annotations.JestId;

/**
 * @Description TODO
 * @Author Matthew
 * @Date 2019/6/18 19:34
 * @Version 1.0
 */

public class Article {

    @JestId
    private Integer id;
    private String author;
    private String title;
    private String content;

    public Integer getId() {
        return id;
    }

    public void setId(Integer id) {
        this.id = id;
    }

    public String getAuthor() {
        return author;
    }

    public void setAuthor(String author) {
        this.author = author;
    }

    public String getTitle() {
        return title;
    }

    public void setTitle(String title) {
        this.title = title;
    }

    public String getContent() {
        return content;
    }

    public void setContent(String content) {
        this.content = content;
    }
}

测试ElasticSearch

SpringData ElasticSearch

@Autowired
    BookRepository bookRepository;
@Test
    public void test02() {
//        Book book = new Book();
//        book.setId(1);
//        book.setAuthor("吴承恩");
//        book.setBookName("西游记");
//        bookRepository.index(book);

        for (Book book : bookRepository.findByBookNameLike("游")) {
            System.out.println(book);
        }
    }

Jest

@Autowired
    JestClient jestClient;
@Test
    public void contextLoads() {
        //1. 给ES中索引(保存)一个文档
        Article article = new Article();
        article.setId(1);
        article.setTitle("好消息");
        article.setAuthor("张三丰");
        article.setContent("太极");

        //构建一个索引功能
        Index build = new Index.Builder(article).index("matthew").type("new").build();

        try {
            //执行
            jestClient.execute(build);
        } catch (IOException e) {
            e.printStackTrace();
        }
    }

    //测试搜索
    @Test
    public void search(){
        //查询表达式
        String json = "{\n" +
                "    \"query\" : {\n" +
                "        \"match\" : {\n" +
                "            \"content\" : \"太极\"\n" +
                "        }\n" +
                "    }\n" +
                "}";
        Search search = new Search.Builder(json).addIndex("matthew").addType("new").build();

        //执行
        try {
            SearchResult result = jestClient.execute(search);
            System.out.println(result.getJsonString());
        } catch (IOException e) {
            e.printStackTrace();
        }
    }

solr springboot全文检索 springer检索_solr springboot全文检索_06

{"took":109,"timed_out":false,"_shards":{"total":1,"successful":1,"skipped":0,"failed":0},"hits":{"total":{"value":1,"relation":"eq"},"max_score":0.5753642,"hits":[{"_index":"matthew","_type":"new","_id":"1","_score":0.5753642,"_source":{"id":1,"author":"张三丰","title":"好消息","content":"太极"}}]}}