Deprecate the transport client in favour of the high-level REST client (elastic/x-pack-elasticsearch#2779)

Original commit: elastic/x-pack-elasticsearch@2aeef5df3f
This commit is contained in:
Luca Cavanna 2017-12-01 12:24:26 +01:00 committed by GitHub
parent d08944b1ff
commit 55a19ed394
4 changed files with 9 additions and 4 deletions

View File

@ -1,6 +1,8 @@
[[java-clients]]
=== Java Client and Security
deprecated[7.0.0, The `TransportClient` is deprecated in favour of the {java-rest}/java-rest-high.html[Java High Level REST Client] and will be removed in Elasticsearch 8.0. The {java-rest}/java-rest-high-level-migration.html[migration guide] describes all the steps needed to migrate.]
{security} supports the Java http://www.elastic.co/guide/en/elasticsearch/client/java-api/current/transport-client.html[transport client] for Elasticsearch.
The transport client uses the same transport protocol that the cluster nodes use
for inter-node communication. It is very efficient as it does not have to marshall

View File

@ -2,14 +2,12 @@
[[setup-xpack-client]]
== Configuring {xpack} Java Clients
deprecated[7.0.0, The `TransportClient` is deprecated in favour of the {java-rest}/java-rest-high.html[Java High Level REST Client] and will be removed in Elasticsearch 8.0. The {java-rest}/java-rest-high-level-migration.html[migration guide] describes all the steps needed to migrate.]
If you want to use a Java {javaclient}/transport-client.html[transport client] with a
cluster where {xpack} is installed, then you must download and configure the
{xpack} transport client.
WARNING: The `TransportClient` is aimed to be replaced by the Java High Level REST
Client, which executes HTTP requests instead of serialized Java requests. The
`TransportClient` will be deprecated in upcoming versions of {es}.
. Add the {xpack} transport JAR file to your *CLASSPATH*. You can download the {xpack}
distribution and extract the JAR file manually or you can get it from the
https://artifacts.elastic.co/maven/org/elasticsearch/client/x-pack-transport/{version}/x-pack-transport-{version}.jar[Elasticsearc Maven repository].

View File

@ -1,6 +1,8 @@
[[api-java]]
== Java API
deprecated[7.0.0, The `TransportClient` is deprecated in favour of the {java-rest}/java-rest-high.html[Java High Level REST Client] and will be removed in Elasticsearch 8.0. The {java-rest}/java-rest-high-level-migration.html[migration guide] describes all the steps needed to migrate.]
{xpack} provides a Java client called `WatcherClient` that adds native Java
support for the {watcher}.

View File

@ -25,8 +25,11 @@ import java.util.concurrent.TimeUnit;
* all of the plugins installed by the {@link PreBuiltTransportClient} and the
* {@link XPackPlugin} so that the client may be used with an x-pack enabled
* cluster.
*
* @deprecated {@link TransportClient} is deprecated in favour of the high-level REST client and will be removed in Elasticsearch 8.0
*/
@SuppressWarnings({"unchecked","varargs"})
@Deprecated
public class PreBuiltXPackTransportClient extends PreBuiltTransportClient {
@SafeVarargs