Module java.net.http

Package java.net.http

package java.net.http

HTTP客户端和WebSocket API

提供了对HTTP（版本1.1和2）的高级客户端接口以及对WebSocket的低级客户端接口。主要定义的类型包括：

• HttpClient
• HttpRequest
• HttpResponse
• WebSocket

协议特定的要求在超文本传输协议版本2（HTTP/2），超文本传输协议（HTTP/1.1）和WebSocket协议中定义。

一般来说，异步任务在调用操作的线程中执行，例如发送HTTP请求，或者由客户端的executor提供的线程执行。依赖任务，即由返回的CompletionStages或CompletableFutures触发的任务，如果没有明确指定执行程序，则在与CompletableFuture的相同默认执行程序中执行，或者在操作完成之前，依赖任务注册之前，由调用线程执行。

此API返回的CompletableFuture在调用其obtrudeValue和obtrudeException方法时会抛出UnsupportedOperationException。调用此API返回的CompletableFuture的cancel方法可能不会中断底层操作，但可能对尚未完成的依赖阶段进行异常完成。

除非另有说明，此包中所有类的方法中的null参数值将导致抛出NullPointerException。

自：

11

Related Packages

Module	Package	Description
java.base	java.net	为实现网络应用程序提供类。
java.base	java.net.spi	java.net包的服务提供者类。

Class	Description
HttpClient	一个HTTP客户端。
HttpClient.Builder	HTTP客户端的构建器。
HttpClient.Redirect	定义自动重定向策略。
HttpClient.Version	HTTP协议版本。
HttpConnectTimeoutException	当无法在指定的时间段内成功建立用于发送HttpRequest的连接时抛出。
HttpHeaders	一组HTTP标头的只读视图。
HttpRequest	一个HTTP请求。
HttpRequest.BodyPublisher	BodyPublisher将高级Java对象转换为适合作为请求体发送的字节缓冲流。
HttpRequest.BodyPublishers	实现了各种有用的发布者的BodyPublisher，例如从字符串发布请求体或从文件发布请求体。
HttpRequest.Builder	HTTP请求的构建器。
HttpResponse<T>	一个HTTP响应。
HttpResponse.BodyHandler<T>	响应体的处理程序。
HttpResponse.BodyHandlers	实现了各种有用的处理程序的BodyHandler，例如将响应体作为字符串处理或将响应体流式传输到文件。
HttpResponse.BodySubscriber<T>	BodySubscriber消耗响应体字节并将其转换为更高级别的Java类型。
HttpResponse.BodySubscribers	实现了各种有用的订阅者的BodySubscriber，例如将响应体字节转换为字符串或将字节流式传输到文件。
HttpResponse.PushPromiseHandler<T>	推送承诺的处理程序。
HttpResponse.ResponseInfo	当初始接收到响应并在处理主体之前时，向BodyHandler提供的初始响应信息。
HttpTimeoutException	在指定的时间段内未收到响应时抛出。
WebSocket	一个WebSocket客户端。
WebSocket.Builder	WebSocket客户端的构建器。
WebSocket.Listener	WebSocket的接收接口。
WebSocketHandshakeException	当握手失败时抛出。