Package java.net.http
HTTP Client and WebSocket APIs
Provides high-level client interfaces to HTTP (versions 1.1 and 2) and low-level client interfaces to WebSocket. The main types defined are:
The protocol-specific requirements are defined in the Hypertext Transfer Protocol Version 2 (HTTP/2), the Hypertext Transfer Protocol (HTTP/1.1), and The WebSocket Protocol.
In general, asynchronous tasks execute in either the thread invoking
the operation, e.g. sending an HTTP request, or by the threads supplied by the client's executor
. Dependent tasks, those that are triggered by
returned CompletionStages or CompletableFutures, that do not explicitly
specify an executor, execute in the same default executor
as that of
CompletableFuture
, or the invoking thread if the operation completes before
the dependent task is registered.
CompletableFuture
s returned by this API will throw UnsupportedOperationException
for their obtrudeValue
and obtrudeException
methods. Unless otherwise specified, invoking
the cancel
method on a
CompletableFuture
returned by this API may not
interrupt the underlying operation, but may be useful to complete,
exceptionally, dependent stages that have not already completed.
Unless otherwise stated, null
parameter values will cause methods
of all classes in this package to throw NullPointerException
.
- Since:
- 11
-
ClassDescriptionAn HTTP Client.A builder of HTTP Clients.Defines the automatic redirection policy.The HTTP protocol version.Thrown when a connection, over which an
HttpRequest
is intended to be sent, is not successfully established within a specified time period.A read-only view of a set of HTTP headers.An HTTP request.ABodyPublisher
converts high-level Java objects into a flow of byte buffers suitable for sending as a request body.Implementations ofBodyPublisher
that implement various useful publishers, such as publishing the request body from a String, or from a file.A builder of HTTP requests.HttpResponse<T>An HTTP response.A handler for response bodies.Implementations ofBodyHandler
that implement various useful handlers, such as handling the response body as a String, or streaming the response body to a file.ABodySubscriber
consumes response body bytes and converts them into a higher-level Java type.Implementations ofBodySubscriber
that implement various useful subscribers, such as converting the response body bytes into a String, or streaming the bytes to a file.A handler for push promises.Initial response information supplied to aBodyHandler
when a response is initially received and before the body is processed.Thrown when a response is not received within a specified time period.A WebSocket Client.A builder of WebSocket Clients.The receiving interface ofWebSocket
.Thrown when the opening handshake has failed.