Package org.eclipse.jetty.client
The core class is HttpClient
, which acts as a central configuration object (for example
for idle timeouts
, max connections per destination
, etc.) and as a factory for Request
objects.
The HTTP protocol is based on the request/response paradigm, a unit that in this implementation is called
exchange and is represented by HttpExchange
.
An initial request may trigger a sequence of exchanges with one or more servers, called a conversation
and represented by HttpConversation
. A typical example of a conversation is a redirect, where
upon a request for a resource URI, the server replies with a redirect (for example with the 303 status code)
to another URI. This conversation is made of a first exchange made of the original request and its 303 response,
and of a second exchange made of the request for the new URI and its 200 response.
HttpClient
holds a number of destinations
, which in turn hold a number of
pooled connections
.
When a request is sent, its exchange is associated to a connection, either taken from an idle queue or created
anew, and when both the request and response are completed, the exchange is disassociated from the connection.
Conversations may span multiple connections on different destinations, and therefore are maintained at the
HttpClient
level.
Applications may decide to send the request and wait for the response in a blocking way, using
Request.send()
.
Alternatively, application may ask to be notified of response events asynchronously, using
Request.send(org.eclipse.jetty.client.api.Response.CompleteListener)
.
-
Interface Summary Interface Description AsyncContentProvider Deprecated. This api is not supported anymore.AsyncContentProvider.Listener Deprecated. This api is not supported anymore.ConnectionPool Deprecated. This api is not supported anymore.ConnectionPool.Factory Deprecated. This api is not supported anymore.ConnectionPool.Multiplexable Deprecated. This api is not supported anymore.ContentDecoder Deprecated. This api is not supported anymore.HttpClientTransport Deprecated. This api is not supported anymore.ProtocolHandler Deprecated. This api is not supported anymore.Synchronizable Deprecated. This api is not supported anymore. -
Class Summary Class Description AbstractConnectionPool Deprecated. AbstractConnectorHttpClientTransport Deprecated. AbstractHttpClientTransport Deprecated. AuthenticationProtocolHandler Deprecated. ContentDecoder.Factory Deprecated. This api is not supported anymore.ContinueProtocolHandler Deprecated. This api is not supported anymore.DuplexConnectionPool Deprecated. GZIPContentDecoder Deprecated. This api is not supported anymore.GZIPContentDecoder.Factory Deprecated. This api is not supported anymore.HttpAuthenticationStore Deprecated. HttpChannel Deprecated. HttpClient Deprecated. This api is not supported anymore.HttpConnection Deprecated. HttpContent Deprecated. This api is not supported anymore.HttpContentResponse Deprecated. HttpConversation Deprecated. HttpDestination Deprecated. HttpExchange Deprecated. HttpProxy Deprecated. HttpReceiver Deprecated. This api is not supported anymore.HttpRedirector Deprecated. This api is not supported anymore.HttpRequest Deprecated. HttpResponse Deprecated. HttpSender Deprecated. This api is not supported anymore.LeakTrackingConnectionPool Deprecated. MultiplexConnectionPool Deprecated. MultiplexHttpDestination Deprecated. Origin Deprecated. Origin.Address Deprecated. PoolingHttpDestination Deprecated. ProtocolHandlers Deprecated. This api is not supported anymore.ProxyAuthenticationProtocolHandler Deprecated. This api is not supported anymore.ProxyConfiguration Deprecated. This api is not supported anymore.ProxyConfiguration.Proxy Deprecated. ProxyProtocolClientConnectionFactory Deprecated. This api is not supported anymore.ProxyProtocolClientConnectionFactory.V1 Deprecated. This api is not supported anymore.ProxyProtocolClientConnectionFactory.V1.Tag Deprecated. This api is not supported anymore.ProxyProtocolClientConnectionFactory.V2 Deprecated. This api is not supported anymore.ProxyProtocolClientConnectionFactory.V2.Tag Deprecated. This api is not supported anymore.ProxyProtocolClientConnectionFactory.V2.Tag.TLV Deprecated. RandomConnectionPool Deprecated. This api is not supported anymore.RedirectProtocolHandler Deprecated. This api is not supported anymore.RequestNotifier Deprecated. ResponseNotifier Deprecated. RoundRobinConnectionPool Deprecated. This api is not supported anymore.SendFailure Deprecated. Socks4Proxy Deprecated. Socks4Proxy.Socks4ProxyClientConnectionFactory Deprecated. TimeoutCompleteListener Deprecated. ValidatingConnectionPool Deprecated. This api is not supported anymore.WWWAuthenticationProtocolHandler Deprecated. This api is not supported anymore. -
Enum Summary Enum Description ProxyProtocolClientConnectionFactory.V2.Tag.Command ProxyProtocolClientConnectionFactory.V2.Tag.Family ProxyProtocolClientConnectionFactory.V2.Tag.Protocol -
Exception Summary Exception Description HttpRequestException Deprecated. HttpResponseException Deprecated.