第一步:导入maven依赖
<groupId>org.elasticsearch.clientgroupId>
<artifactId>elasticsearch-rest-high-level-clientartifactId>
<groupId>org.elasticsearchgroupId>
<artifactId>elasticsearchartifactId>
第二步:配置配置类
import org.apache.http.HttpHost;
import org.apache.http.auth.AuthScope;
import org.apache.http.auth.UsernamePasswordCredentials;
import org.apache.http.client.CredentialsProvider;
import org.apache.http.impl.client.BasicCredentialsProvider;
import org.apache.http.impl.nio.client.HttpAsyncClientBuilder;
import org.elasticsearch.client.RestClient;
import org.elasticsearch.client.RestClientBuilder;
import org.elasticsearch.client.RestHighLevelClient;
import org.springframework.beans.factory.annotation.Qualifier;
import org.springframework.beans.factory.annotation.Value;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
@Value("${spring.es.addrs.host}")
@Value("${spring.es.addrs.port}")
@Value("${spring.es.username}")
@Value("${spring.es.password}")
@Qualifier("restHighLevelClient")
public RestHighLevelClient restHighLevelClient(){
final CredentialsProvider credentialsProvider = new BasicCredentialsProvider();
credentialsProvider.setCredentials(AuthScope.ANY, new UsernamePasswordCredentials(username, password));
RestClientBuilder restClientBuilder = RestClient.builder(new HttpHost(url, port, "http"))
.setHttpClientConfigCallback(new RestClientBuilder.HttpClientConfigCallback() {
public HttpAsyncClientBuilder customizeHttpClient(HttpAsyncClientBuilder httpAsyncClientBuilder) {
return httpAsyncClientBuilder.setDefaultCredentialsProvider(credentialsProvider);
return new RestHighLevelClient(restClientBuilder);
第三步:工具类准备
import cn.hutool.core.bean.BeanUtil;
import com.alibaba.fastjson.JSON;
import lombok.extern.slf4j.Slf4j;
import org.apache.commons.lang3.StringUtils;
import org.elasticsearch.action.bulk.BulkRequest;
import org.elasticsearch.action.bulk.BulkResponse;
import org.elasticsearch.action.delete.DeleteRequest;
import org.elasticsearch.action.search.SearchRequest;
import org.elasticsearch.action.search.SearchResponse;
import org.elasticsearch.action.update.UpdateRequest;
import org.elasticsearch.client.RequestOptions;
import org.elasticsearch.client.RestHighLevelClient;
import org.elasticsearch.client.core.CountRequest;
import org.elasticsearch.client.core.CountResponse;
import org.elasticsearch.common.text.Text;
import org.elasticsearch.search.SearchHit;
import org.elasticsearch.search.SearchHits;
import org.elasticsearch.search.builder.SearchSourceBuilder;
import org.elasticsearch.search.fetch.subphase.highlight.HighlightField;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.beans.factory.annotation.Qualifier;
import org.springframework.stereotype.Component;
import java.io.IOException;
import java.util.ArrayList;
@Qualifier("restHighLevelClient")
private RestHighLevelClient restHighLevelClient;
public SearchHit[] search(String indexName, SearchSourceBuilder builder) throws IOException{
SearchRequest request = new SearchRequest(indexName).source(builder);
SearchResponse response = restHighLevelClient.search(request, RequestOptions.DEFAULT);
SearchHits hits = response.getHits();
public List search(String indexName, SearchSourceBuilder builder,Class clazz,String highlightField) throws IOException{
SearchRequest request = new SearchRequest(indexName).source(builder);
long start = System.currentTimeMillis();
log.info("es 查询开始 ==== index:{} {}",indexName,builder.toString());
SearchResponse response = restHighLevelClient.search(request, RequestOptions.DEFAULT);
long end = System.currentTimeMillis();
log.info("es 查询结束 ==== 命中:{} 耗时:{}",response.getHits().getTotalHits().value,end - start);
SearchHits hits = response.getHits();
return parseSearchHits(hits.getHits(),clazz,highlightField);
public long count(String indexName, SearchSourceBuilder builder) throws IOException{
CountRequest countRequest = new CountRequest(indexName);
countRequest.source(builder);
long start = System.currentTimeMillis();
log.info("es count开始 ==== index:{} {}",indexName,builder.toString());
CountResponse response = restHighLevelClient.count(countRequest, RequestOptions.DEFAULT);
long end = System.currentTimeMillis();
log.info("es count结束 ==== 总量:{} 耗时:{}",response.getCount(),end - start);
return response.getCount();
public boolean deleteByIds(String indexName, List list) throws IOException{
BulkRequest request = new BulkRequest();
for (Integer id : list) {
request.add(new DeleteRequest().index(indexName).id(id.toString()));
long start = System.currentTimeMillis();
log.info("es 删除开始 ==== index:{} 数量:{}",indexName,list.size());
BulkResponse response = restHighLevelClient.bulk(request, RequestOptions.DEFAULT);
long end = System.currentTimeMillis();
log.info("es 删除结束 ==== 耗时:{}",end - start);
public boolean updateBulk(String indexName, List list) throws IOException{
BulkRequest request = new BulkRequest();
Map map = BeanUtil.beanToMap(t);
Object id = map.get("id");
request.add(new UpdateRequest().index(indexName).id(map.get("id").toString()).doc(map).docAsUpsert(true));
request.add(new UpdateRequest().index(indexName).doc(map).docAsUpsert(true));
long start = System.currentTimeMillis();
log.info("es 批量更新开始 ==== index:{} 数量:{}",indexName,list.size());
BulkResponse response = restHighLevelClient.bulk(request, RequestOptions.DEFAULT);
long end = System.currentTimeMillis();
log.info("es 批量更新结束 ==== 耗时:{}",end - start);
public List parseSearchHits(SearchHit[] hits, Class clazz, String highlightField) throws IOException{
List list = new ArrayList<>();
if (hits == null || hits.length == 0){
for (SearchHit hit : hits) {
Map map = hit.getSourceAsMap();
if (!StringUtils.isEmpty(highlightField)){
Map highlightFields = hit.getHighlightFields();
HighlightField str = highlightFields.get(highlightField);
Text[] fragments = str.fragments();
for (Text fragment : fragments) {
map.put(highlightField,highlight);
T t = JSON.parseObject(JSON.toJSONString(map), clazz);
第四步:创建索引
public boolean createMapping() {
GetIndexRequest indexRequest = new GetIndexRequest(TEST_INDEX);
boolean exists = client.indices().exists(indexRequest, RequestOptions.DEFAULT);
XContentBuilder mappings = XContentFactory.jsonBuilder()
.startObject("properties")
.startObject("id").field("type", "long").field("store", true).endObject()
.startObject("classIds").field("type", "long").field("store", true).endObject()
.startObject("classLevels").field("type", "text").field("store", true).endObject()
.startObject("title").field("type", "text").field("store", true).endObject()
XContentBuilder settings = XContentFactory.jsonBuilder()
.startObject("index").field("max_result_window", 100000).endObject()
CreateIndexRequest request = new CreateIndexRequest(TEST_INDEX);
request.mapping(mappings);
request.settings(settings);
client.indices().create(request, RequestOptions.DEFAULT);
} catch (IOException e) {
第五步:简单的使用方法测试
import com.eebbk.task.handler.EsHandler;
import lombok.extern.slf4j.Slf4j;
import org.elasticsearch.index.query.BoolQueryBuilder;
import org.elasticsearch.index.query.QueryBuilders;
import org.elasticsearch.search.builder.SearchSourceBuilder;
import org.elasticsearch.search.fetch.subphase.highlight.HighlightBuilder;
import org.junit.jupiter.api.Test;
import org.springframework.boot.test.context.SpringBootTest;
import javax.annotation.Resource;
import java.io.IOException;
public class EsHandlerTest {
private EsHandler esHandler;
private String indexName = "test_index";
void contextLoads() throws IOException {
HighlightBuilder highlightBuilder = new HighlightBuilder();
highlightBuilder.field("title").field("tag");
highlightBuilder.preTags("");
highlightBuilder.postTags("");
SearchSourceBuilder builder = new SearchSourceBuilder().highlighter(highlightBuilder).from(1).size(100);
BoolQueryBuilder boolQueryBuilder = new BoolQueryBuilder();
boolQueryBuilder.must(QueryBuilders.matchPhraseQuery("title","*"+"地球的运动"+"*"));
List
result = esHandler.search(indexName, builder.query(boolQueryBuilder), PropertyVo.class, title); System.out.println(result);