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 decorateConnectionFactoryinstances 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> AConnectionFactorythat delegates all methods to anotherConnectionFactory.DelegatingConnectionFactoryFilter<ResolvedAddress,C extends ListenableAsyncCloseable> AConnectionFactoryFilterthat delegates all methods to anotherConnectionFactoryFilter.DelegatingServiceDiscoverer<UnresolvedAddress,ResolvedAddress, E extends ServiceDiscovererEvent<ResolvedAddress>> AServiceDiscovererthat delegates all methods to anotherServiceDiscoverer.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> AConnectionFactorythat 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 multipleSocketAddresses select the most desiredSocketAddressto use.LoadBalancerFactory<ResolvedAddress,C extends LoadBalancedConnection> A factory for creatingLoadBalancerinstances.A hint fromLoadBalancer.eventStream()that the internal state of theLoadBalanceris 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.A tracker of latency of an action over time.Enumeration of the main failure classes.ARequestConcurrencyControllerthat 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 theServiceDiscoverersystem that guides the actions ofLoadBalancerupon the boundServiceDiscovererEvent.address()(viaServiceDiscovererEvent).TransportObserverConnectionFactoryFilter<ResolvedAddress,C extends ListenableAsyncCloseable> AConnectionFactoryFilterthat configures aTransportObserverfor new connections.