演示的目标
演示先决条件:
我们要将以下文档保存到ElasticSearch中:
@Document(indexName = "dataexchangecode", type = "dataTransferCode") public class DataTransfer { @Id private String id; private String dataExchangeCode; private String data; public DataTransfer() { } /** * @param id * @param dataExchangeCode * @param data */<font> <b>public</b> DataTransfer(<b>final</b> String id, <b>final</b> String dataExchangeCode, <b>final</b> String data) { <b>this</b>.id = id; <b>this</b>.dataExchangeCode = dataExchangeCode; <b>this</b>.data = data; } <b>public</b> String getId() { <b>return</b> id; } <b>public</b> <b>void</b> setId(String id) { <b>this</b>.id = id; } <b>public</b> String getDataExchangeCode() { <b>return</b> dataExchangeCode; } <b>public</b> <b>void</b> setDataExchangeCode(String dataExchangeCode) { <b>this</b>.dataExchangeCode = dataExchangeCode; } <b>public</b> String getData() { <b>return</b> data; } <b>public</b> <b>void</b> setData(String data) { <b>this</b>.data = data; } @Override <b>public</b> String toString() { <b>return</b> <b>this</b>.id+ <b>this</b>.dataExchangeCode+ <b>this</b>.id; } } </font>
要了解indexName 和参数类型,可检查 document .
为了测试目的,让我们创建以下两个REST控制器来调用Spring Data ElasticSearch CRUD存储库:
@Component @RestController <b>public</b> <b>class</b> HomeController { @Autowired <b>private</b> DataTransferRepository dataTransferRepository; @GetMapping(value = <font>"/prepareData"</font><font>) <b>public</b> String prepareESData() { <b>final</b> DataTransfer data = <b>new</b> DataTransfer(</font><font>"1"</font><font>, </font><font>"AW_INPUT"</font><font>, </font><font>"<XML>"</font><font>); dataTransferRepository.save(data); <b>final</b> DataTransfer data2 = <b>new</b> DataTransfer(</font><font>"2"</font><font>, </font><font>"BSL_INPUT"</font><font>, </font><font>"<XML>"</font><font>); dataTransferRepository.save(data2); <b>return</b> </font><font>"Data saved into elastic search!"</font><font>; } @GetMapping(value = </font><font>"/get/{id}"</font><font>) <b>public</b> DataTransfer getDataTransfer(@PathVariable(</font><font>"id"</font><font>) String id) { <b>return</b> dataTransferRepository.findById(id).get(); } } </font>
连接并查询嵌入式ElasticSearch节点
构建本地节点时请记住,ElasticSearch API 5.x已针对指定用于构建本地ES节点的NodeBuilder类进行了更改。例如,检查 此 stackoverflow讨论。ES文档说明:
NodeBuilder已被删除。虽然直接在应用程序中使用Node不受官方支持, 但它仍然可以使用Node(Settings)构造函数构建。
下面是我所做的:
@Profile(<font>"localNode"</font><font>) @Bean <b>public</b> Node createLocalNode() throws NodeValidationException { <b>final</b> String tmpDir = System.getProperty(</font><font>"java.io.tmpdir"</font><font>); Settings.Builder elasticsearchSettings = Settings.builder() .put(</font><font>"cluster.name"</font><font>, EsClusterName) .put(</font><font>"path.data"</font><font>, <b>new</b> File(tmpDir, </font><font>"data"</font><font>).getAbsolutePath()) .put(</font><font>"path.logs"</font><font>, <b>new</b> File(tmpDir, </font><font>"logs"</font><font>).getAbsolutePath()) .put(</font><font>"transport.type"</font><font>,</font><font>"local"</font><font>) .put(</font><font>"http.enabled"</font><font>,</font><font>"false"</font><font>) .put(</font><font>"path.home"</font><font>, tmpDir); <b>final</b> Node node = <b>new</b> Node(elasticsearchSettings.build()); node.start(); <b>return</b> node; } </font>
有关节点参数列表,请查看 以下 文档。要使Spring Data ElasticSearch存储库正常工作,我们需要ElasticsearchTemplate:
@Profile(<font>"localNode"</font><font>) @Bean(name=</font><font>"elasticsearchTemplate"</font><font>) <b>public</b> ElasticsearchTemplate elasticsearchTemplate2() throws Exception { <b>return</b> <b>new</b> ElasticsearchTemplate(createLocalNode().client()); } </font>
这将根据您的需要使用 NodeClient 启动ElasticsearchTemplate 。Definitelly要注意以下两件事:
测试本地ElasticSearch节点
首先,我们需要构建项目:
$ mvn clean install
然后使用localNode spring profile运行Spring Boot 2.0应用程序:
$ java -jar -Dspring.profiles.active=localNode target/demo-0.0.1-SNAPSHOT.jar
ES本地节点应该启动了。
现在让我们测试一下,首先调用REST控制器端点将数据加载到ElasticSearch中:
curl http:<font><i>//localhost:8080/prepareData</i></font><font> Data saved into elastic search! </font>
然后我们可以查询数据:
$ curl http:<font><i>//localhost:8080/get/1 {"id":"1","dataExchangeCode":"AW_INPUT","data":"<XML>"}</i></font><font> </font>
$ curl http:<font><i>//localhost:8080/get/2 {"id":"2","dataExchangeCode":"BSL_INPUT","data":"<XML>"}</i></font><font> </font>
好的,本地嵌入式节点工作正常!
连接并查询外部ElasticSearch节点
在这种情况下,我们不需要嵌入任何本地ES节点,我们只需要启动ES客户端。以下配置互联网:
Settings settings = Settings.builder() .put(<font>"cluster.name"</font><font>, EsClusterName).build(); TransportClient client = <b>new</b> PreBuiltTransportClient(settings); client.addTransportAddress( <b>new</b> InetSocketTransportAddress( InetAddress.getByName(EsHost), EsPort)); </font>
好吧,嵌入在Spring Boot 2.0中的ES API不能与PreBuiltTransportClient一起使用,因为它需要Netty3Plugin,这个无法放到maven依赖项中。如果您仍然不希望 highlevel REST API ,可以还是使用TransportClientFactoryBean 委托给SpringDataTransportClient
@Profile(<font>"!localNode"</font><font>) @Bean <b>public</b> Client client() throws Exception { </font><font><i>/** * PreBuiltTransportClient works fine, but requires Netty3Plugin * and Spring Boot offers only Netty4Plugin. Needs extra dependencies. Settings settings = Settings.builder() .put("cluster.name", EsClusterName).build(); TransportClient client = new PreBuiltTransportClient(settings); client.addTransportAddress( new InetSocketTransportAddress( InetAddress.getByName(EsHost), EsPort)); return client; */</i></font><font> TransportClientFactoryBean client = <b>new</b> TransportClientFactoryBean(); client.setClusterName(EsClusterName); client.afterPropertiesSet(); <b>return</b> client.getObject(); } </font>
当然,我们需要再次使用ElasticsearchTemplate来使Spring Data ES工作:
@Profile(<font>"!localNode"</font><font>) @Bean(name = </font><font>"elasticsearchTemplate"</font><font>) <b>public</b> ElasticsearchOperations elasticsearchTemplate1() throws Exception { <b>return</b> <b>new</b> ElasticsearchTemplate(client()); } </font>
准备好代码,让我们测试整个场景:
打开终端并启动外部ES服务器
$ elasticsearch
验证外部elasticsearch服务器是否正在运行:
$ curl http:<font><i>//localhost:9200 </i></font><font> { </font><font>"name"</font><font> : </font><font>"NmF778a"</font><font>, </font><font>"cluster_name"</font><font> : </font><font>"elasticsearch_tomask79"</font><font>, </font><font>"cluster_uuid"</font><font> : </font><font>"Z0CfKNMxSNGqfkUONZ6bRg"</font><font>, </font><font>"version"</font><font> : { </font><font>"number"</font><font> : </font><font>"6.4.2"</font><font>, </font><font>"build_flavor"</font><font> : </font><font>"oss"</font><font>, </font><font>"build_type"</font><font> : </font><font>"tar"</font><font>, </font><font>"build_hash"</font><font> : </font><font>"04711c2"</font><font>, </font><font>"build_date"</font><font> : </font><font>"2018-09-26T13:34:09.098244Z"</font><font>, </font><font>"build_snapshot"</font><font> : false, </font><font>"lucene_version"</font><font> : </font><font>"7.4.0"</font><font>, </font><font>"minimum_wire_compatibility_version"</font><font> : </font><font>"5.6.0"</font><font>, </font><font>"minimum_index_compatibility_version"</font><font> : </font><font>"5.0.0"</font><font> }, </font><font>"tagline"</font><font> : </font><font>"You Know, for Search"</font><font> } </font>
现在让我们使用默认的spring配置文件启动applicationn:
$ java -jar target/demo-0.0.1-SNAPSHOT.jar
然后让我们重复调用REST端点,将数据加载到ES中并查询:
curl http:<font><i>//localhost:8080/prepareData</i></font><font> Data saved into elastic search! $ curl http:</font><font><i>//localhost:8080/get/1</i></font><font> {</font><font>"id"</font><font>:</font><font>"1"</font><font>,</font><font>"dataExchangeCode"</font><font>:</font><font>"AW_INPUT"</font><font>,</font><font>"data"</font><font>:</font><font>"<XML>"</font><font>} $ curl http:</font><font><i>//localhost:8080/get/2</i></font><font> {</font><font>"id"</font><font>:</font><font>"2"</font><font>,</font><font>"dataExchangeCode"</font><font>:</font><font>"BSL_INPUT"</font><font>,</font><font>"data"</font><font>:</font><font>"<XML>"</font><font>} </font>
连接到外部ES也可以正常工作。
原文源码点击标题