文章目录
- 一、检索
- 下载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
安装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":限制堆栈内存
二、概念
面向文档
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 集群可以 包含多个 索引 ,相应的每个索引可以包含多个 类型 。 这些不同的类型存储着多个 文档 ,每个文档又有多个属性 。
类似关系:
索引-数据库
类型-表
文档-表中的记录
属性-列
对于雇员目录,我们将做如下操作:
每个雇员索引一个文档,包含该雇员的所有信息。
每个文档都将是 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
我的版本是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();
}
}
{"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":"太极"}}]}}