2017-02-24 07:52:36 -05:00
|
|
|
[[java-rest-high-usage]]
|
|
|
|
=== Getting started
|
|
|
|
|
|
|
|
[[java-rest-high-usage-maven]]
|
|
|
|
==== Maven Repository
|
|
|
|
|
|
|
|
The high-level Java REST client is hosted on
|
|
|
|
http://search.maven.org/#search%7Cga%7C1%7Cg%3A%22org.elasticsearch.client%22[Maven
|
|
|
|
Central]. The minimum Java version required is `1.8`.
|
|
|
|
|
2017-07-03 04:48:16 -04:00
|
|
|
The High Level REST Client is subject to the same release cycle as
|
|
|
|
Elasticsearch. Replace the version with the desired client version.
|
2017-02-24 07:52:36 -05:00
|
|
|
|
|
|
|
[[java-rest-high-usage-maven-maven]]
|
|
|
|
===== Maven configuration
|
|
|
|
|
|
|
|
Here is how you can configure the dependency using maven as a dependency manager.
|
|
|
|
Add the following to your `pom.xml` file:
|
|
|
|
|
|
|
|
["source","xml",subs="attributes"]
|
|
|
|
--------------------------------------------------
|
|
|
|
<dependency>
|
|
|
|
<groupId>org.elasticsearch.client</groupId>
|
|
|
|
<artifactId>rest-high-level</artifactId>
|
|
|
|
<version>{version}</version>
|
|
|
|
</dependency>
|
|
|
|
--------------------------------------------------
|
|
|
|
|
|
|
|
[[java-rest-high-usage-maven-gradle]]
|
|
|
|
===== Gradle configuration
|
|
|
|
|
|
|
|
Here is how you can configure the dependency using gradle as a dependency manager.
|
|
|
|
Add the following to your `build.gradle` file:
|
|
|
|
|
|
|
|
["source","groovy",subs="attributes"]
|
|
|
|
--------------------------------------------------
|
|
|
|
dependencies {
|
|
|
|
compile 'org.elasticsearch.client:rest-high-level:{version}'
|
|
|
|
}
|
|
|
|
--------------------------------------------------
|
|
|
|
|
|
|
|
[[java-rest-high-usage-dependencies]]
|
|
|
|
==== Dependencies
|
|
|
|
|
2017-07-03 04:48:16 -04:00
|
|
|
The High Level Java REST Client depends on the following artifacts and their
|
2017-02-24 07:52:36 -05:00
|
|
|
transitive dependencies:
|
|
|
|
|
|
|
|
- org.elasticsearch.client:rest
|
|
|
|
- org.elasticsearch:elasticsearch
|
|
|
|
|
|
|
|
|
|
|
|
[[java-rest-high-usage-initialization]]
|
|
|
|
==== Initialization
|
|
|
|
|
|
|
|
A `RestHighLevelClient` instance needs a <<java-rest-low-usage-initialization,REST low-level client>>
|
|
|
|
to be built as follows:
|
|
|
|
|
|
|
|
[source,java]
|
|
|
|
--------------------------------------------------
|
|
|
|
RestHighLevelClient client =
|
|
|
|
new RestHighLevelClient(lowLevelRestClient); <1>
|
|
|
|
--------------------------------------------------
|
|
|
|
<1> We pass the <<java-rest-low-usage-initialization,REST low-level client>> instance
|
|
|
|
|
2017-07-03 04:48:16 -04:00
|
|
|
In the rest of this documentation about the Java High Level Client, the `RestHighLevelClient` instance
|
2017-02-24 07:52:36 -05:00
|
|
|
will be referenced as `client`.
|