Package io.servicetalk.client.api
@ElementsAreNonnullByDefault
package io.servicetalk.client.api
API definitions for Client use cases.
-
ClassDescriptionClientGroup<Key,
Client extends ListenableAsyncCloseable> A data-structure capable of holding arbitrary number of clients and bridging lifecycle events across all clients managed by the group.ConnectionFactory<ResolvedAddress,C extends ListenableAsyncCloseable> A factory for creating new connections.ConnectionFactoryFilter<ResolvedAddress,C extends ListenableAsyncCloseable> A contract to decorateConnectionFactory
instances for the purpose of filtering.Thrown when the number of connections reached their limit for a given resource (i.e.Thrown when a newly created connection was rejected.Throws when a connect operations failed because of a timeout.A container for an event that requires acknowledgement when the event is consumed viaConsumableEvent.eventConsumed()
.DefaultGroupKey<Address>A default implementation ofGroupKey
.Default implementation ofServiceDiscovererEvent
.DelegatingConnectionFactory<ResolvedAddress,C extends ListenableAsyncCloseable> AConnectionFactory
that delegates all methods to anotherConnectionFactory
.DelegatingConnectionFactoryFilter<ResolvedAddress,C extends ListenableAsyncCloseable> AConnectionFactoryFilter
that delegates all methods to anotherConnectionFactoryFilter
.GroupKey<Address>Identifies a client within a group of clients, and provides enough information to create a client if non exist.LimitingConnectionFactoryFilter<ResolvedAddress,C extends ListenableAsyncCloseable> AConnectionFactory
that limits the total number of active connections created using thisConnectionFactory
.LimitingConnectionFactoryFilter.ConnectionLimiter<ResolvedAddress,C extends ListenableAsyncCloseable> A contract to limit number of connections created byLimitingConnectionFactoryFilter
.LoadBalancedAddress<C extends LoadBalancedConnection>An address managed by aLoadBalancer
.A connection managed by aLoadBalancer
.LoadBalancer<C extends LoadBalancedConnection>Given multipleSocketAddress
es select the most desiredSocketAddress
to use.LoadBalancerFactory<ResolvedAddress,C extends LoadBalancedConnection> A factory for creatingLoadBalancer
instances.A hint fromLoadBalancer.eventStream()
that the internal state of theLoadBalancer
is ready suchLoadBalancer.selectConnection(Predicate, ContextMap)
is not likely to fail.Thrown when no host is active to establish a new connection.Thrown when no host is available but at least one is required.An interface which allows controlling reserving connections which maybe used concurrently.Result of theRequestConcurrencyController.tryRequest()
call.Thrown when a request was rejected before processing by the transport layer.ARequestConcurrencyController
that also allows toReservableRequestConcurrencyController.tryReserve()
a connection for exclusive use.Throws when a connect operations failed.Enables components to expose a score.ServiceDiscoverer<UnresolvedAddress,ResolvedAddress, E extends ServiceDiscovererEvent<ResolvedAddress>> Represents the interaction pattern with a service discovery system.ServiceDiscovererEvent<ResolvedAddress>Notification from the Service Discovery system that availability for an address has changed.Status provided by theServiceDiscoverer
system that guides the actions ofLoadBalancer
upon the boundServiceDiscovererEvent.address()
(viaServiceDiscovererEvent
).TransportObserverConnectionFactoryFilter<ResolvedAddress,C extends ListenableAsyncCloseable> AConnectionFactoryFilter
that configures aTransportObserver
for new connections.