Java HTTP客户端和WebSocket API 的功能介绍

模块  java.net.http

Package java.net.http

HTTP客户端和WebSocket API

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

• HttpClient
• HttpRequest
• HttpResponse
• WebSocket

协议特定的要求在限定Hypertext Transfer Protocol Version 2 (HTTP/2) ，所述Hypertext Transfer Protocol (HTTP/1.1) ，和The WebSocket Protocol 。

通常，异步任务在调用操作的线程中执行，例如sending HTTP请求，或者由客户端executor提供的线程执行 。 相关的任务，那些被退回CompletionStages或CompletableFutures触发，没有明确指定遗嘱执行人，执行在同一default executor为的CompletableFuture ，或者调用线程，如果从属任务被注册前的操作完成。

CompletableFuture通过这个API返回将抛出小号UnsupportedOperationException他们obtrudeValue种obtrudeException方法。 调用cancel方法上的CompletableFuture这个API返回的可能不中断的基本操作，但可能完成，但没有已经完成，特殊情况下，依赖阶段是有用的。

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

接口摘要

接口	描述
HttpClient.Builder	HTTP Clients的建设者 。
HttpRequest.BodyPublisher	BodyPublisher将高级Java对象转换为适合作为请求主体发送的字节缓冲区流。
HttpRequest.Builder	HTTP requests的建设者 。
HttpResponse<T>	HTTP响应。
HttpResponse.BodyHandler<T>	响应主体的处理程序。
HttpResponse.BodySubscriber<T>	BodySubscriber响应正文字节并将它们转换为更高级别的Java类型。
HttpResponse.PushPromiseHandler<T>	推送承诺的处理程序。
HttpResponse.ResponseInfo	初始接收响应时和处理主体之前提供给BodyHandler的初始响应信息。
WebSocket	WebSocket客户端。
WebSocket.Builder	WebSocket Clients的生成器 。
WebSocket.Listener	接收界面为 WebSocket 。

类摘要

类	描述
HttpClient	HTTP客户端。
HttpHeaders	一组HTTP标头的只读视图。
HttpRequest	HTTP请求。
HttpRequest.BodyPublishers	实现各种有用发布者的BodyPublisher的实现，例如从String或文件发布请求主体。
HttpResponse.BodyHandlers	实现各种有用处理程序的BodyHandler的实现，例如将响应主体作为String处理，或将响应主体流式传输到文件。
HttpResponse.BodySubscribers	实现各种有用订户的BodySubscriber的实现，例如将响应主体字节转换为字符串，或将字节流式传输到文件。

枚举摘要

Enum	描述
HttpClient.Redirect	定义自动重定向策略。
HttpClient.Version	HTTP协议版本。

异常摘要

异常	描述
HttpConnectTimeoutException	在指定时间段内未成功建立要发送 HttpRequest的连接时抛出。
HttpTimeoutException	在指定时间段内未收到响应时抛出。
WebSocketHandshakeException	打开握手失败时抛出。