2017-02-24 07:52:36 -05:00
|
|
|
[[java-rest-high]]
|
|
|
|
== Java High Level REST Client
|
|
|
|
|
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
|
|
|
|
|
|
|
include::usage.asciidoc[]
|
|
|
|
|
2017-07-03 04:48:16 -04:00
|
|
|
include::apis.asciidoc[]
|
|
|
|
|
|
|
|
include::apis/index.asciidoc[]
|