@ExperimentalApi("https://github.com/grpc/grpc-java/issues/5288")

Package io.grpc.xds

Library for gPRC proxyless service mesh using Envoy xDS protocol.

The package currently includes a name resolver plugin and a family of load balancer plugins. A gRPC channel for a target with "xds:" scheme will load the plugins and a bootstrap file, and will communicate with an external control plane management server (e.g. Traffic Director) that speaks Envoy xDS protocol to retrieve routing, load balancing, load reporting configurations etc. for the channel. More features will be added.

The library is currently in an agile development phase, so API and design are subject to breaking changes.

Interface Summary

Interface	Description
XdsClient.ResourceUpdate
XdsClient.ResourceWatcher<T extends XdsClient.ResourceUpdate>	Watcher interface for a single requested xDS resource.
XdsServerBuilder.XdsServingStatusListener	Applications can register this listener to receive "serving" and "not serving" states of the server using XdsServerBuilder.xdsServingStatusListener(XdsServingStatusListener).
XdsTransportFactory	A factory for creating new XdsTransport instances.
XdsTransportFactory.EventHandler<RespT>	An interface for handling events on a streaming call.
XdsTransportFactory.StreamingCall<ReqT,RespT>	Represents a bidi streaming RPC call.
XdsTransportFactory.XdsTransport	Represents transport for xDS communication (e.g., a gRPC channel).

Class Summary

Class	Description
CsdsService	The CSDS service provides information about the status of a running xDS client.
RingHashOptions	Utility class that provides a way to configure ring hash size limits.
XdsChannelCredentials
XdsClient	An XdsClient instance encapsulates all of the logic for communicating with the xDS server.
XdsResourceType<T extends XdsClient.ResourceUpdate>
XdsResourceType.Args
XdsServerBuilder	A version of ServerBuilder to create xDS managed servers.
XdsServerCredentials

Exception Summary

Exception	Description
XdsResourceType.ResourceInvalidException