一、导入 ElasticSearch 依赖
在 pom .xml里加入如下依赖
<dependency> | |
<groupId>org.springframework.boot</groupId> | |
<artifactId>spring-boot-starter-data-elasticsearch</artifactId> | |
</dependency> |
非常重要:检查依赖版本是否与你当前所用的版本是否一致,如果不一致,会连接失败!
二、创建高级客户端
import org. apache .http.HttpHost; | |
import org.elastic Search .client. rest Client; | |
import org.elasticsearch.client.RestHighLevelClient; | |
import org.springframework.context. annotation .Bean; | |
import org.springframework.context.annotation.Configuration; | |
public class ElasticSearchClientConfig { | |
public RestHighLevelClient restHighLevelClient(){ | |
RestHighLevelClient client = new RestHighLevelClient( | |
RestClient.builder( | |
new HttpHost("服务器IP",, "http"))); | |
return client; | |
} | |
} |
三、基本用法
1.创建、判断存在、删除索引
import org.elasticsearch.action.admin.indices.delete.DeleteIndex Request ; | |
import org.elasticsearch.action.support.master.AcknowledgedResponse; | |
import org.elasticsearch.client.RequestOptions; | |
import org.elasticsearch.client.RestHighLevelClient; | |
import org.elasticsearch.client.indices.CreateIndexRequest; | |
import org.elasticsearch.client.indices.CreateIndexResponse; | |
import org.elasticsearch.client.indices.GetIndexRequest; | |
import org. junit .jupiter.api.Test; | |
import org.springframework.beans.factory.annotation.Autowired; | |
import org.springframework.boot.test.context.SpringBootTest; | |
import java .io.IO Exception ; | |
class ElasticsearchApplicationTests { | |
private RestHighLevelClient restHighLevelClient; | |
void testCreateIndex() throws IOException { | |
//.创建 索引 请求 | |
CreateIndexRequest request = new CreateIndexRequest("ljx"); | |
//.客户端执行请求IndicesClient,执行create方法创建索引,请求后获得响应 | |
CreateIndexResponse response= | |
restHighLevelClient.indices().create(request, RequestOptions.DEFAULT); | |
System.out.println(response); | |
} | |
void testExistIndex() throws IOException { | |
//.查询索引请求 | |
GetIndexRequest request=new GetIndexRequest("ljx"); | |
//.执行 exists 方法判断是否存在 | |
boolean exists=restHighLevelClient.indices().exists(request,RequestOptions.DEFAULT); | |
System.out.println(exists); | |
} | |
void testDeleteIndex() throws IOException { | |
//.删除索引请求 | |
DeleteIndexRequest request=new DeleteIndexRequest("ljx"); | |
//执行delete方法删除指定索引 | |
AcknowledgedResponse delete = restHighLevelClient.indices().delete(request, RequestOptions.DEFAULT); | |
System.out.println(delete.isAcknowledged()); | |
} | |
} |
2.对文档的CRUD
创建文档:
创建文档时若该ID已存在,发送创建文档请求后会更新文档中的数据。
@Test | |
void testAddUser() throws IOException { | |
//.创建对象 | |
User user=new User("Go",,new String[]{"内卷","吃饭"}); | |
//.创建请求 | |
IndexRequest request=new IndexRequest("ljx"); | |
//.设置规则 PUT /ljx666/_doc/1 | |
//设置文档id=,设置超时=1s等,不设置会使用默认的 | |
//同时支持链式编程如 request.id("").timeout("1s"); | |
request.id(""); | |
request.timeout("s"); | |
//.将数据放入请求,要将对象转化为 json 格式 | |
//XContentType. JSON ,告诉它传的数据是JSON类型 | |
request.source(JSONValue.toJSONString(user), XContentType.JSON); | |
//.客户端发送请求,获取响应结果 | |
IndexResponse indexResponse=restHighLevelClient.index(request,RequestOptions.DEFAULT); | |
System.out.println(indexResponse.toString()); | |
System.out.println(indexResponse.status()); | |
} |
获取文档中的数据:
@Test | |
void testGetUser() throws IOException { | |
//.创建请求,指定索引、文档id | |
GetRequest request=new GetRequest("ljx","1"); | |
GetResponse getResponse=restHighLevelClient.get(request,RequestOptions.DEFAULT); | |
System.out.println(getResponse);//获取响应结果 | |
//getResponse.getSource() 返回的是 Map 集合 | |
System.out.println(getResponse.getSourceAsString());//获取响应结果source中内容,转化为 字符串 | |
} |
更新文档数据:
注意:需要将User对象中的属性全部指定值,不然会被设置为空,如User只设置了名称,那么只有名称会被修改成功,其他会被修改为null。
void testUpdateUser() throws IOException { | |
//.创建请求,指定索引、文档id | |
UpdateRequest request=new UpdateRequest("ljx","6"); | |
User user =new User("GoGo",,new String[]{"内卷","吃饭"}); | |
//将创建的对象放入文档中 | |
request.doc(JSONValue.toJSONString(user),XContentType.JSON); | |
UpdateResponse updateResponse=restHighLevelClient.update(request,RequestOptions.DEFAULT); | |
System.out.println(updateResponse.status());//更新成功返回OK | |
} |
删除文档:
@Test | |
void testDeleteUser() throws IOException { | |
//创建删除请求,指定要删除的索引与文档ID | |
DeleteRequest request=new DeleteRequest("ljx","6"); | |
DeleteResponse updateResponse=restHighLevelClient.delete(request,RequestOptions.DEFAULT); | |
System.out.println(updateResponse.status());//删除成功返回OK,没有找到返回NOT_FOUND | |
} |
3.批量CRUD数据
这里只列出了批量插入数据,其他与此类似
注意:hasFailures()方法是返回是否失败,即它的值为false时说明上传成功
@Test | |
void testBulkAddUser() throws IOException { | |
BulkRequest bulkRequest=new BulkRequest(); | |
//设置超时 | |
bulkRequest.timeout("s"); | |
ArrayList<User> list=new ArrayList<>(); | |
list.add(new User(" Java ",25,new String[]{"内卷"})); | |
list.add(new User("Go",,new String[]{"内卷"})); | |
list.add(new User("C",,new String[]{"内卷"})); | |
list.add(new User("C++",,new String[]{"内卷"})); | |
list.add(new User(" Python ",20,new String[]{"内卷"})); | |
int id=; | |
//批量处理请求 | |
for (User u :list){ | |
//不设置id会生成随机id | |
bulkRequest.add(new IndexRequest("ljx") | |
.id(""+(id++)) | |
.source(JSONValue.toJSONString(u),XContentType.JSON)); | |
} | |
BulkResponse bulkResponse=restHighLevelClient.bulk(bulkRequest,RequestOptions.DEFAULT); | |
System.out.println(bulkResponse.hasFailures());//是否执行失败,false为执行成功 | |
} |
4.查询所有、模糊查询、分页查询、排序、高亮显示
@Test | |
void testSearch() throws IOException { | |
SearchRequest searchRequest=new SearchRequest("ljx");//里面可以放多个索引 | |
SearchSourceBuilder sourceBuilder=new SearchSourceBuilder();//构造搜索条件 | |
//此处可以使用QueryBuilders工具类中的方法 | |
//.查询所有 | |
sourceBuilder.query(QueryBuilders.matchAllQuery()); | |
//.查询name中含有Java的 | |
sourceBuilder.query(QueryBuilders.multiMatchQuery("java","name")); | |
//.分页查询 | |
sourceBuilder.from().size(5); | |
//.按照score正序排列 | |
//sourceBuilder.sort(SortBuilders.scoreSort().order(SortOrder.ASC)); | |
//.按照id倒序排列(score会失效返回 NaN ) | |
//sourceBuilder.sort(SortBuilders.fieldSort("_id").order(SortOrder.DESC)); | |
//.给指定字段加上指定高亮样式 | |
HighlightBuilder highlightBuilder=new HighlightBuilder(); | |
highlightBuilder.field("name").preTags("<span style='color:red;'>").postTags("</span>"); | |
sourceBuilder.highlighter(highlightBuilder); | |
searchRequest.source(sourceBuilder); | |
SearchResponse searchResponse=restHighLevelClient.search(searchRequest,RequestOptions.DEFAULT); | |
//获取总条数 | |
System.out.println(searchResponse.getHits().getTotalHits().value); | |
//输出结果数据(如果不设置返回条数,大于条默认只返回10条) | |
SearchHit[] hits=searchResponse.getHits().getHits(); | |
for(SearchHit hit :hits){ | |
System.out.println("分数:"+hit.getScore()); | |
Map<String,Object> source=hit.getSourceAsMap(); | |
System.out.println("index->"+hit.getIndex()); | |
System.out.println("id->"+hit.getId()); | |
for(Map.Entry<String,Object> s:source.entrySet()){ | |
System.out.println(s.getKey()+"--"+s.getValue()); | |
} | |
} | |
} |
四、总结
1.大致流程
创建对应的请求 –> 设置请求(添加规则,添加数据等) –> 执行对应的方法(传入请求,默认请求选项)–> 接收响应结果(执行方法返回值)–> 输出响应结果中需要的数据(source,status等)
2.注意事项
- 如果不指定id,会自动生成一个随机id
- 正常情况下,不应该这样使用 new IndexRequest(“ljx777”) ,如果索引发生改变了,那么代码都需要修改,可以定义一个枚举类或者一个专门存放常量的类,将变量用 final static 等进行修饰,并指定索引值。其他地方引用该常量即可,需要修改也只需修改该类即可。
- elasticsearch相关的东西,版本都必须一致,不然会报错
- elasticsearch很消耗内存,建议在内存较大的服务器上运行elasticsearch,否则会因为内存不足导致elasticsearch自动killed