包 java.net.http
包java.net.http
HTTP 客户端和 WebSocket API
为 HTTP(版本 1.1 和 2)提供高级客户端接口,为 WebSocket 提供低级客户端接口。定义的主要类型有:
协议特定要求在 超文本传输协议版本 2 (HTTP/2)、超文本传输协议 (HTTP/1.1) 和 WebSocket 协议 中定义。
通常,异步任务在调用操作的线程中执行,例如 发送 HTTP 请求,或者由客户端的 executor
提供的线程执行。依赖任务,那些由返回的 CompletionStages 或 CompletableFutures 触发的,没有明确指定执行者,在与 CompletableFuture
相同的 default executor
中执行,或者如果操作在依赖任务注册之前完成,则在调用线程中执行。
此 API 返回的 CompletableFuture
将为其 obtrudeValue
和 obtrudeException
方法抛出 UnsupportedOperationException
。在此 API 返回的 CompletableFuture
上调用 cancel
方法可能不会中断底层操作,但可能有助于完成尚未完成的依赖阶段。
除非另有说明,否则 null
参数值将导致此包中所有类的方法抛出 NullPointerException
。
- 自从:
- 11
-
类描述一个 HTTP 客户端。HTTP 客户端 的建设者。定义自动重定向策略。HTTP 协议版本。当要发送
HttpRequest
的连接未在指定时间段内成功建立时抛出。一组 HTTP 标头的只读视图。HTTP 请求。BodyPublisher
将高级 Java 对象转换为适合作为请求主体发送的字节缓冲区流。BodyPublisher
的实现实现了各种有用的发布者,例如从字符串或文件发布请求主体。HTTP 请求 的建设者。HttpResponse <T>HTTP 响应。响应主体的处理程序。BodyHandler
的实现实现了各种有用的处理程序,例如将响应主体作为字符串处理,或将响应主体流式传输到文件。BodySubscriber
消耗响应主体字节并将它们转换为更高级别的 Java 类型。BodySubscriber
的实现实现了各种有用的订阅者,例如将响应主体字节转换为字符串,或将字节流式传输到文件。推送承诺的处理程序。当最初收到响应时和处理正文之前,提供给BodyHandler
的初始响应信息。在指定时间段内未收到响应时抛出。WebSocket 客户端。WebSocket 客户端 的建设者。WebSocket
的接收接口。当开始握手失败时抛出。