1、查询官方文档
1. 阅读官方文档
Elsticsearch官方文档地址Elasticsearch使用文档地址
使用Restful风格文档Restful风格文档地址注意:需要选择对应的版本
使用高级客户端高级客户端文档地址
2、SpringBoot集成Elasticsearch
1. 相关依赖
注意:由于SpringBoot默认整合的事elasticsearch的6.8.6版本,因此需要修改依赖的版本信息为当前elasticsearch对应的版本。
<!-- 修改elasticsearch的版本 -->
<properties>
<elasticsearch.version>7.6.1</elasticsearch.version>
</properties>
<!-- SpringBoot与elasticsearch整合的相关依赖 -->
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-data-elasticsearch</artifactId>
</dependency>
<!-- spring-boot-starter-data-elasticsearch的依赖中已经引入了当前依赖,因此只需要修改相关的版本即可
<dependency>
<groupId>org.elasticsearch.client</groupId>
<artifactId>elasticsearch-rest-high-level-client</artifactId>
<version>7.6.2</version>
</dependency>
-->
完整的配置信息如下:
<properties>
<java.version>1.8</java.version>
<elasticsearch.version>7.6.1</elasticsearch.version>
<fastjson.version>1.2.72</fastjson.version>
</properties>
<dependencies>
<!-- springboot集成elasticsearch的依赖 -->
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-data-elasticsearch</artifactId>
</dependency>
<!-- Spring MVC的依赖 -->
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-web</artifactId>
</dependency>
<!-- 热部署使用的依赖 -->
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-devtools</artifactId>
<scope>runtime</scope>
<optional>true</optional>
</dependency>
<!-- lombok的依赖 -->
<dependency>
<groupId>org.projectlombok</groupId>
<artifactId>lombok</artifactId>
<optional>true</optional>
</dependency>
<!-- SpringBoot测试使用的依赖 -->
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-test</artifactId>
<scope>test</scope>
</dependency>
<!-- fastjson依赖 -->
<dependency>
<groupId>com.alibaba</groupId>
<artifactId>fastjson</artifactId>
<version>${fastjson.version}</version>
</dependency>
</dependencies>
2. 初始化
RestHighLevelClient client = new RestHighLevelClient(
RestClient.builder(
new HttpHost("localhost", 9200, "http"),
new HttpHost("localhost", 9201, "http")));
完整ES客户端配置信息类:
@Configuration
public class ElasticsearchConfig {
@Bean
public RestHighLevelClient restHighLevelClient() {
RestHighLevelClient client = new RestHighLevelClient(
RestClient.builder(
new HttpHost("127.0.0.1", 9200, "http")
/** 多个节点也是在当前地方配置 */
// , new HttpHost("localhost", 9300, "http")
));
return client;
}
}
3. 主要的API类的方法
1. 创建索引的API
@Autowired
private RestHighLevelClient restHighLevelClient;
/**
* 功能描述:createIndex 测试索引的创建 <br>
*
* @param
* @return void
* @Author xununan
* @Date 2020-08-23 18:53
* @Version 1.0.0
*/
@Test
void createIndexTest() throws IOException {
// 1. 创建索引请求
CreateIndexRequest firstIndex = new CreateIndexRequest("xununan_index");
// 2. 客户端执行创建索引的请求
CreateIndexResponse response = restHighLevelClient.indices().create(firstIndex, RequestOptions.DEFAULT);
System.out.println(response);
}
2. 判断索引是否存在的API
@Autowired
private RestHighLevelClient restHighLevelClient;
/**
* 功能描述:existsIndexTest 判断索引是否存在 <br>
*
* @param
* @return void
* @Author xununan
* @Date 2020-08-23 18:59
* @Version 1.0.0
*/
@Test
void existsIndexTest() throws IOException {
// 1. 创建一个get请求获取指定索引的信息
GetIndexRequest getIndexRequest = new GetIndexRequest("xununan_index");
// 2. 客户端执行请求判断索引是否存在
boolean exists = restHighLevelClient.indices().exists(getIndexRequest, RequestOptions.DEFAULT);
System.out.println(exists);
if (!exists) {
System.out.println(">>>>>>>>> 索引不存在。。。。。");
return;
}
}
3. 删除索引的API
@Autowired
private RestHighLevelClient restHighLevelClient;
/**
* 功能描述:deleteIndexTest 删除指定的索引 <br>
*
* @param
* @return void
* @Author xununan
* @Date 2020-08-23 19:05
* @Version 1.0.0
*/
@Test
void deleteIndexTest() throws IOException {
// 1. 创建一个delete请求,用于删除索引信息
DeleteIndexRequest deleteIndexRequest = new DeleteIndexRequest("xununan_index");
// 2. 客户端执行删除请求
AcknowledgedResponse result = restHighLevelClient.indices().delete(deleteIndexRequest, RequestOptions.DEFAULT);
System.out.println(JSON.toJSON(result));
}
4. 创建文档的API
@Autowired
private RestHighLevelClient restHighLevelClient;
/**
* 功能描述:创建文档 <br>
*
* @return
* @Author xununan
* @Date 2020-08-23 19:11
* @Version 1.0.0
*/
@Test
void addDocumentTest() throws IOException {
// 1. 创建对象
User user = new User("xununan", 27);
// 2. 创建请求并指定索引
IndexRequest indexRequest = new IndexRequest("xununan_index");
// 3. 创建的规则:put /xununan_index/_doc/1
indexRequest.id("1"); // 设置ID
indexRequest.timeout("1s"); // 设置超时时间
// 4. 将数据放入到请求中
indexRequest.source(JSON.toJSONString(user), XContentType.JSON);
// 5. 使用客户端发送请求
IndexResponse index = restHighLevelClient.index(indexRequest, RequestOptions.DEFAULT);
System.out.println(JSON.toJSONString(index));
}
5. 根据ID获取指定索引的文档信息
@Autowired
private RestHighLevelClient restHighLevelClient;
/**
* 功能描述:getDocumentTest 获取文档信息 <br>
* @param
* @return void
*
* @Author xununan
* @Date 2020-08-23 19:40
* @Version 1.0.0
*/
@Test
void getDocumentTest() throws IOException {
// 1. 创建请求信息绑定索引和指定需要查询的文档id
GetRequest getRequest = new GetRequest("xununan_index", "1");
// 设置不获取的返回时的_source的上下文,一般情况是不需要设置的
// getRequest.fetchSourceContext(new FetchSourceContext(false)).storedFields("_none_");
// 2. 判断指定的索引和id是否存在
boolean exists = restHighLevelClient.exists(getRequest, RequestOptions.DEFAULT);
if (!exists) {
System.out.println(">>>>>>>> 当前索引:xununan_index对应的id:1 不存在");
return;
}
System.out.println(">>>>>>>> 当前索引:xununan_index对应的id:1 存在");
// 3. 获取指定ID的资源信息
GetResponse response = restHighLevelClient.get(getRequest, RequestOptions.DEFAULT);
// 4. 打印获取到的资源信息
System.out.println(response.getSourceAsString());
System.out.println(JSON.toJSONString(response));
}
6. 根据ID更新文档信息
@Autowired
private RestHighLevelClient restHighLevelClient;
/**
* 功能描述:updateDocmentTest 更新文档信息 <br>
* @param
* @return void
*
* @Author xununan
* @Date 2020-08-23 21:11
* @Version 1.0.0
*/
@Test
void updateDocmentTest() throws IOException {
// 1. 创建一个更新请求的信息,绑定索引名称和需要更新的文档ID
UpdateRequest updateRequest = new UpdateRequest("xununan_index", "1");
updateRequest.timeout("1s"); // 设置超时时间
User user = new User("小明", 28);
// 2. 封装需要更新的文档信息
updateRequest.doc(JSON.toJSONString(user), XContentType.JSON);
// 3. 使用update更新文档
UpdateResponse updateResponse = restHighLevelClient.update(updateRequest, RequestOptions.DEFAULT);
System.out.println(JSON.toJSONString(updateResponse));
}
7. 根据ID删除文档信息
@Autowired
private RestHighLevelClient restHighLevelClient;
/**
* 功能描述:deleteDocmentTest 删除文档信息 <br>
* @param
* @return void
*
* @Author xununan
* @Date 2020-08-23 21:31
* @Version 1.0.0
*/
@Test
void deleteDocmentTest() throws IOException {
// 1. 创建一个删除的请求,绑定索引名和需要删除的文档ID
DeleteRequest deleteRequest = new DeleteRequest("xununan_index", "1");
// 2. 发起删除请求
DeleteResponse response = restHighLevelClient.delete(deleteRequest, RequestOptions.DEFAULT);
System.out.println(JSON.toJSONString(response));
}
8. 批量创建文档
@Autowired
private RestHighLevelClient restHighLevelClient;
/**
* 功能描述:addDocmentByBatchTest 批量创建文档 <br>
* @param
* @return void
*
* @Author xununan
* @Date 2020-08-23 22:36
* @Version 1.0.0
*/
@Test
void addDocmentByBatchTest() throws IOException {
// 1. 创建批量的请求
BulkRequest bulkRequest = new BulkRequest();
bulkRequest.timeout("10s"); // 设置超时时间
List<User> list = new ArrayList<>();
User user = null;
for (int i = 1; i <= 10; i++) {
user = new User("姓名" + i, 20+i);
list.add(user);
}
// 2. 将多条数据批量的放入bulkRequest中
for (int i = 0; i <list.size(); i++) {
// 批量更新和批量删除在这里修改对应的请求即可
bulkRequest.add(new IndexRequest("xununan_index")
.id("" + i)
.source(JSON.toJSONString(list.get(i)), XContentType.JSON)
);
}
// 3. 执行批量创建文档
BulkResponse responses = restHighLevelClient.bulk(bulkRequest, RequestOptions.DEFAULT);
System.out.println(responses.hasFailures()); // 是否失败,如果false则表示全部成功
System.out.println(JSON.toJSONString(responses));
}
9. 指定条件模糊查询多条数据
@Autowired
private RestHighLevelClient restHighLevelClient;
/**
* 功能描述:searchTest 批量搜索,可以设置高亮等信息 <br>
* @param
* @return void
*
* @Author xununan
* @Date 2020-08-23 22:58
* @Version 1.0.0
*/
@Test
void searchTest() throws IOException {
// 1. 创建批量搜索请求,并绑定索引
SearchRequest searchRequest = new SearchRequest("xununan_index");
// 2. 构建搜索条件
SearchSourceBuilder sourceBuilder = new SearchSourceBuilder();
// 【注意:这里有个坑,当中文查询时,如果使用ik分词器会查询不到数据,属性需要使用xxx.keyword才能查询到数据】
TermQueryBuilder termQueryBuilder = QueryBuilders.termQuery("name.keyword", "姓名7"); // 设置精确查询
// QueryBuilders.matchAllQuery();
sourceBuilder.query(termQueryBuilder).timeout(new TimeValue(60, TimeUnit.SECONDS));
// 3. 将查询条件放入搜索请求request中
searchRequest.source(sourceBuilder);
// 4. 发起查询请求获取数据
SearchResponse response = restHighLevelClient.search(searchRequest, RequestOptions.DEFAULT);
System.out.println(JSON.toJSONString(response));
System.out.println(JSON.toJSONString(response.getHits().getHits()));
}