Module jdk.incubator.httpclient

Package jdk.incubator.http

高级HTTP和WebSocket API

Incubating Feature.将在以后的版本中删除。

提供HTTP（版本1.1和2）和WebSocket的高级客户端界面。 定义的主要类型有：

• HttpClient
• HttpRequest
• HttpResponse
• WebSocket

API异步运行（使用CompletableFuture ），并且由客户端的Executor提供的线程进行工作。

HttpClient还提供了一个简单的同步模式，其中所有的工作都可以在调用线程上完成。

CompletableFuture通过这个API返回将抛出小号UnsupportedOperationException他们obtrudeValue种obtrudeException方法。 调用cancel方法上CompletableFuture通过这个API返回不会中断底层的操作，但是可以完成那些尚未完成，特殊情况下，依赖阶段是有用的。

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

从以下版本开始：

9

接口摘要

接口	描述
HttpHeaders	一组HTTP标头的只读视图。
HttpRequest.BodyProcessor	将高级Java对象转换为适合作为请求体发送的ByteBuffer的流的处理器 。
HttpResponse.BodyHandler<T>	响应机构的处理程序。
HttpResponse.BodyProcessor<T>	响应机构的处理器。
HttpResponse.MultiProcessor<U,T>	用于HTTP / 2多响应的响应处理器。
WebSocket	符合RFC 6455的WebSocket客户端。
WebSocket.Builder	用于创建 WebSocket实例的构建器。
WebSocket.Listener	一个 WebSocket事件和消息的 WebSocket 。

类摘要

Class	描述
HttpClient	用于多个HttpRequest s共同的配置信息的容器。
HttpClient.Builder	不可变的建筑师HttpClient s。
HttpRequest	表示可以发送到服务器的一个HTTP请求。
HttpRequest.Builder	一个建筑师HttpRequest s。
HttpResponse<T>	代表对HttpRequest的回复 。
MultiMapResult<V>	A Map包含HTTP / 2请求和多响应的结果。

枚举摘要

Enum	描述
HttpClient.Redirect	定义自动重定向策略。
HttpClient.Version	HTTP协议版本。
WebSocket.MessagePart	在可能收到部分消息的情况下由WebSocket.Listener使用的标记。

异常摘要

异常	描述
HttpTimeoutException	在指定时间段内没有收到回应时抛出。
WebSocketHandshakeException	用于表示开启握手的异常失败。