Package com.linecorp.armeria.client
@NonNullByDefault
package com.linecorp.armeria.client
Client core.
Starting points
-
ClassDescriptionA skeletal builder implementation for
ClientOptions
.AbstractDnsResolverBuilder<SELF extends AbstractDnsResolverBuilder<SELF>>A skeletal builder implementation for DNS resolvers.AbstractRuleBuilder<SELF extends AbstractRuleBuilder<SELF>>A skeletal builder implementation forRetryRule
,RetryRuleWithContent
,CircuitBreakerRule
andCircuitBreakerRuleWithContent
.AbstractRuleWithContentBuilder<SELF extends AbstractRuleWithContentBuilder<SELF,T>, T extends Response> A skeletal builder implementation forRetryRuleWithContent
andCircuitBreakerRuleWithContent
.A skeletal builder implementation forWebClient
.A blocking web client that waits for anHttpResponse
to be fully aggregated.Prepares and executes a newHttpRequest
forBlockingWebClient
.Creates a new client that connects to the specifiedURI
using the builder pattern.Provides the construction parameters of a client.Creates a newClientDecoration
using the builder pattern.Creates and manages clients.Builds a newClientFactory
.AClientFactory
option.A set ofClientFactoryOption
s and their respective values.A value of aClientFactoryOption
.Creates a newClientFactory
dynamically via Java SPI (Service Provider Interface).ClientOption<T>A client option.A set ofClientOption
s and their respective values.Creates a newClientOptions
using the builder pattern.A value of aClientOption
.Builds a newClientRequestContext
.Captures theClientRequestContext
s created by the current thread.Wraps an existingClientRequestContext
.Creates a new client that connects to a specifiedURI
.Listens to the client connection pool events.A skeletalConnectionPoolListener
implementation in order for a user to implement only the methods what he or she really needs.AConnectionPoolListener
that wraps an existingConnectionPoolListener
.Decorates aClient
.A functional interface that enables building aSimpleDecoratingHttpClient
withClientBuilder.decorator(DecoratingHttpClientFunction)
.A functional interface that enables building aSimpleDecoratingRpcClient
withClientBuilder.rpcDecorator(DecoratingRpcClientFunction)
.A cache for DNS responses.A builder forDnsCache
.Listens to theDnsCache
events.Builds anAddressResolverGroup
which buildsAddressResolver
s that update DNS caches automatically.ATimeoutException
raised when a response has not been received from a DNS server within timeout.A remote endpoint that refers to a single host.Asynchronously transforms anHttpResponse
into aT
type object.Prepares and executes a newHttpRequest
forWebClient
, and asynchronously transforms anHttpResponse
into aT
type object.ARuntimeException
raised when a server sent an HTTP/2 GOAWAY frame with thelastStreamId
less then the stream ID of the request.Sends anHttpRequest
to a remoteEndpoint
.AnInvalidResponseException
raised when a client received an invalidHttpResponse
.ARuntimeException
raised when a client received an invalid response.AnInvalidResponseException
raised when a client received a response with invalid headers.Provides a way for users to addResponseAs
mappings to transform an aggregated response given that the correspondingPredicate
is satisfied.AnSSLException
raised before starting a TLS handshake.ARuntimeException
raised when a server set HTTP/2MAX_CONCURRENT_STREAMS
to 0, which means a client can't send anything.ARequestOptions
for anHttpRequest
.A builder for creating a newRequestOptions
.Provides the setters for buildingRequestOptions
.Provides the setters for building anHttpRequest
andRequestOptions
.ResponseAs<T,R> Transforms a response into another.ACancellationException
raised when a response is cancelled by the user.ATimeoutException
raised when a response has not been received from a server within timeout.Specifies when to start scheduling a response timeout.A client designed for calling RESTful APIs conveniently.Prepares and executes a newHttpRequest
forRestClient
.Sends anRpcRequest
to a remoteEndpoint
.Keeps the recentSessionProtocol
negotiation failures.An exception triggered when failed to negotiate the desiredSessionProtocol
with a server.Decorates aClient
.Decorates anHttpClient
.Decorates anRpcClient
.Prepares and executes a newHttpRequest
for aWebClient
orBlockingWebClient
, and transforms anHttpResponse
into theT
type object.ARuntimeException
raised when it is certain that a request has not been handled by a server and thus can be retried safely.A base class for implementing a user's entry point for sending aRequest
.An asynchronous web client.Creates a new web client that connects to the specifiedURI
using the builder pattern.Prepares and executes a newHttpRequest
forWebClient
.ATimeoutException
raised when a client failed to send a request to the wire within timeout.