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

模块java.net.httpPackagejava.net.httpHTTP客户端和WebSocket API提供HTTP（版本1.1和2）的高级客户端接口和WebSocket的低级客户端接口。定义的主要类型是：HttpClientHttpRequestHttpResponseWebSocket协议特定的要求在限定Hypertext Transfer P...

ixiaoyang8

1049人浏览 · 2020-01-09 10:41:06

ixiaoyang8 · 2020-01-09 10:41:06 发布

模块 java.net.http

Package java.net.http

HTTP客户端和WebSocket API

提供HTTP（版本1.1和2）的高级客户端接口和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	打开握手失败时抛出。