2017-02-24 07:52:36 -05:00
|
|
|
[[java-rest-high]]
|
2017-07-04 04:58:57 -04:00
|
|
|
= Java High Level REST Client
|
2017-02-24 07:52:36 -05:00
|
|
|
|
2017-07-04 04:58:57 -04:00
|
|
|
[partintro]
|
|
|
|
--
|
2017-07-15 01:50:25 -04:00
|
|
|
added[6.0.0-beta1]
|
|
|
|
|
2017-07-03 04:48:16 -04:00
|
|
|
The Java High Level REST Client works on top of the Java Low Level REST client.
|
|
|
|
Its main goal is to expose API specific methods, that accept request objects as
|
|
|
|
an argument and return response objects, so that request marshalling and
|
|
|
|
response un-marshalling is handled by the client itself.
|
2017-02-24 07:52:36 -05:00
|
|
|
|
2017-07-03 04:48:16 -04:00
|
|
|
Each API can be called synchronously or asynchronously. The synchronous
|
|
|
|
methods return a response object, while the asynchronous methods, whose names
|
|
|
|
end with the `async` suffix, require a listener argument that is notified
|
|
|
|
(on the thread pool managed by the low level client) once a response or an
|
|
|
|
error is received.
|
2017-02-24 07:52:36 -05:00
|
|
|
|
2017-07-03 04:48:16 -04:00
|
|
|
The Java High Level REST Client depends on the Elasticsearch core project.
|
|
|
|
It accepts the same request arguments as the `TransportClient` and returns
|
|
|
|
the same response objects.
|
2017-02-24 07:52:36 -05:00
|
|
|
|
2017-07-04 04:58:57 -04:00
|
|
|
--
|
|
|
|
|
2017-08-01 04:38:56 -04:00
|
|
|
:doc-tests: {docdir}/../../client/rest-high-level/src/test/java/org/elasticsearch/client/documentation
|
|
|
|
|
2017-09-06 08:06:41 -04:00
|
|
|
include::getting-started.asciidoc[]
|
|
|
|
include::supported-apis.asciidoc[]
|
|
|
|
include::java-builders.asciidoc[]
|
2017-08-01 04:38:56 -04:00
|
|
|
include::migration.asciidoc[]
|
2017-07-04 04:58:57 -04:00
|
|
|
include::../license.asciidoc[]
|
2017-08-01 04:38:56 -04:00
|
|
|
|
|
|
|
:doc-tests!:
|