一、创建RESTHighLevelClient客户端
// 添加以下依赖
<dependency>
<groupId>org.elasticsearch.client</groupId>
<artifactId>elasticsearch-rest-high-level-client</artifactId>
<version>${elasticsearch.version}</version>
</dependency>
// 通过以下代码创建client
RestHighLevelClient client = new RestHighLevelClient(
RestClient.builder(
new HttpHost("localhost", 9200, "http"),
new HttpHost("localhost", 9201, "http")));
// 使用完client后需关闭资源
client.close();
在使用RESTHighLevelClient API时,首先需要创建一个client对象,这个对象在应用程序中应当是全局唯一的。可以将其声明为单例,在整个应用程序上下文中重复使用。
二、创建索引
// 定义index名称及属性Mappings
// mappings: 在索引中预定义字段及其数据类型
// Settings: 在索引中定义设置。例如,默认分片数和副本数
String index = "indexName";
String type = "typeName";
XContentBuilder builder = XContentFactory.jsonBuilder();
builder.startObject();
{
builder.startObject("properties");
{
builder.startObject("fieldName");
{
builder.field("type", "text"); // 字段类型
}
builder.endObject();
}
builder.endObject();
}
builder.endObject();
PutIndexTemplateRequest request = new PutIndexTemplateRequest("templateName");
request.settings(Settings.builder().put("index.number_of_shards", 1) // 分片数
.put("index.number_of_replicas", 0)) // 副本数
.mapping(type, builder);
CreateIndexRequest createIndexRequest = new CreateIndexRequest(index).settings(Settings.builder().put("index.number_of_shards", 1) // 分片数
.put("index.number_of_replicas", 0)) // 副本数
.mapping(type, builder);
// 同步调用,会阻塞当前线程直至操作完成
CreateIndexResponse createIndexResponse = client.indices().create(createIndexRequest, RequestOptions.DEFAULT);
// 异步调用,需要设置监听器
client.indices().createAsync(createIndexRequest, RequestOptions.DEFAULT, listener);
创建索引的过程可以分为两个步骤:定义索引的属性和创建索引。在定义索引属性时,需要使用XContentBuilder来创建一个JSON对象,包含了所需的索引属性。在创建完属性后,就可以使用CreateIndexRequest或PutIndexTemplateRequest来创建索引。
三、添加数据
// 创建IndexRequest
IndexRequest request = new IndexRequest(index, type, "documentId");
// 使用Json数据填充IndexRequest
request.source(jsonMap);
// 同步请求添加数据
IndexResponse indexResponse = client.index(request, RequestOptions.DEFAULT);
// 异步请求添加数据,需要设置监听器
client.indexAsync(request, RequestOptions.DEFAULT, listener);
添加数据是通过创建一个IndexRequest对象来实现的,该对象有3个参数,这些参数分别是索引名称,type和文档ID。添加数据时可以设置数据源。可以将该源指定为Map,String或byte数组,以JSON格式表示。调用index方法将数据添加到指定的索引中。当数据添加完成后,将会获得一个IndexResponse,该response包含了有关添加的数据的详细信息,例如文档的版本号。
四、更新数据
// 创建UpdateRequest,指定需要更新的文档索引、类型和ID
UpdateRequest request = new UpdateRequest(index, type, "documentId");
// 配置需要更新的数据
request.doc(jsonMap);
// 进行同步请求更新
UpdateResponse response = client.update(request, RequestOptions.DEFAULT);
// 异步请求更新,需要设置监听器
client.updateAsync(request, RequestOptions.DEFAULT, listener);
更新数据需要使用UpdateRequest对象,此对象的构造函数中需要传递索引的名称,type和文档ID。更新数据时需要配置更新后的数据,可以将其指定为Map,String或byte数组,以JSON格式表示。调用update方法将更新请求发送到ES。更新后,将会返回一个UpdateResponse,其中包含有关更新数据的详细信息,例如文档的版本号。
五、删除数据
// 创建DeleteRequest,指定需要删除的文档索引、类型和ID
DeleteRequest request = new DeleteRequest(index, type, "documentId");
// 同步删除数据
DeleteResponse response = client.delete(request, RequestOptions.DEFAULT);
// 异步删除数据,需要设置监听器
client.deleteAsync(request, RequestOptions.DEFAULT, listener);
删除数据需要通过创建DeleteRequest对象来实现,该对象的构造函数中需要传递索引的名称,类型和文档ID。调用delete方法将删除请求发送到ES。如果文档删除成功,则会返回一个DeleteResponse,其中包含有关已删除文档的详细信息,例如文档的版本号。
六、搜索数据
// 构建SearchSourceBuilder对象,指定查询条件
SearchSourceBuilder searchSourceBuilder = new SearchSourceBuilder();
searchSourceBuilder.query(QueryBuilders.matchQuery("fieldName", "value"));
// 构建SearchRequest对象
SearchRequest searchRequest = new SearchRequest(index);
searchRequest.source(searchSourceBuilder);
// 发送搜索请求
SearchResponse searchResponse = client.search(searchRequest, RequestOptions.DEFAULT);
在ES中搜索数据是非常常见的。搜索数据需要先创建一个SearchSourceBuilder对象,其中包含搜索的查询条件。可以使用QueryBuilder API创建查询条件。创建SearchRequest对象,该对象是发送搜索请求的必要条件。可以使用SearchRequest对象的source方法设置搜索条件,发送搜索请求的结果可以通过SearchResponse对象获得。
七、批量操作
// 构建BulkRequest对象
BulkRequest bulkRequest = new BulkRequest();
// 添加IndexRequest,UpdateRequest和DeleteRequest
bulkRequest.add(indexRequest);
bulkRequest.add(updateRequest);
bulkRequest.add(deleteRequest);
// 添加批量操作的监听器
client.bulkAsync(bulkRequest, RequestOptions.DEFAULT, listener);
批量操作可以大大提高操作效率,例如批量索引或删除数据都是非常有用的。要执行批量操作,需要先创建一个BulkRequest对象,然后添加多个IndexRequest,UpdateRequest或DeleteRequest对象,每个对象都需要指定所需的参数。添加操作后,可以使用bulkAsync方法将批量操作发送到ES,并设置适当的监听器。