Package com.linecorp.armeria.client
@NonNullByDefault
package com.linecorp.armeria.client
Client core.
Starting points
-
InterfaceDescriptionProvides the construction parameters of a client.Creates and manages clients.Creates a new
ClientFactory
dynamically via Java SPI (Service Provider Interface).Captures theClientRequestContext
s created by the current thread.Listens to the client connection pool events.A functional interface that enables building aSimpleDecoratingHttpClient
withClientBuilder.decorator(DecoratingHttpClientFunction)
.A functional interface that enables building aSimpleDecoratingRpcClient
withClientBuilder.rpcDecorator(DecoratingRpcClientFunction)
.Sends anHttpRequest
to a remoteEndpoint
.ARequestOptions
for anHttpRequest
.Sends anRpcRequest
to a remoteEndpoint
.An asynchronous web client. -
ClassDescriptionA skeletal builder implementation for
ClientOptions
.A skeletal builder implementation forRetryRule
,RetryRuleWithContent
,CircuitBreakerRule
andCircuitBreakerRuleWithContent
.AbstractRuleWithContentBuilder<T extends Response>A skeletal builder implementation forRetryRuleWithContent
andCircuitBreakerRuleWithContent
.A skeletal builder implementation forWebClient
.Creates a new client that connects to the specifiedURI
using the builder pattern.Creates a newClientDecoration
using the builder pattern.Builds a newClientFactory
.AClientFactory
option.A set ofClientFactoryOption
s and their respective values.A value of aClientFactoryOption
.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
.Wraps an existingClientRequestContext
.Creates a new client that connects to a specifiedURI
.A skeletalConnectionPoolListener
implementation in order for a user to implement only the methods what he or she really needs.AConnectionPoolListener
that wraps an existingConnectionPoolListener
.DecoratingClient<T_I extends Request,T_O extends Response,R_I extends Request,R_O extends Response>Decorates aClient
.DefaultClientRequestContext
implementation.Builds anAddressResolverGroup
which buildsAddressResolver
s that update DNS caches automatically.A remote endpoint that refers to a single host.A builder for creating a newRequestOptions
.Keeps the recentSessionProtocol
negotiation failures.Decorates aClient
.Decorates anHttpClient
.Decorates anRpcClient
.A base class for implementing a user's entry point for sending aRequest
.Creates a new web client that connects to the specifiedURI
using the builder pattern.Prepares and executes a newHttpRequest
forWebClient
. -
ExceptionDescriptionA
TimeoutException
raised when a response has not been received from a DNS server within timeout.ARuntimeException
raised when a server sent an HTTP/2 GOAWAY frame with thelastStreamId
less then the stream ID of the request.ARuntimeException
raised when a client received an invalid response.AnInvalidResponseException
raised when a client received a response with invalid headers.ARuntimeException
raised when a server set HTTP/2MAX_CONCURRENT_STREAMS
to 0, which means a client can't send anything.ACancellationException
raised when a response is cancelled by the user.ATimeoutException
raised when a response has not been received from a server within timeout.An exception triggered when failed to negotiate the desiredSessionProtocol
with a server.ARuntimeException
raised when it is certain that a request has not been handled by a server and thus can be retried safely.ATimeoutException
raised when a client failed to send a request to the wire within timeout.