Module  jdk.incubator.httpclient
软件包  jdk.incubator.http

Class HttpRequest.Builder

  • Enclosing class:
    HttpRequest 

    public abstract static class HttpRequest.Builder
extends Object
    一个建筑师HttpRequest s。
    Incubating Feature.将在以后的版本中删除。

    HttpRequest.Builder是通过调用HttpRequest.newBuilder(URI)或HttpRequest.newBuilder()创建的。

    每一个在这个类中的setter方法修改生成器的状态并返回此 （即相同的实例）。 方法不同步，不应该从多个线程调用而不需要外部同步。

    请注意，并非所有请求标头都可能由用户代码设置。 有些是为了安全原因而受到限制，而其他诸如与身份验证，重定向和cookie管理相关的标题由特定的API管理，而不是通过直接的用户设置头。

    build方法在每次调用时都会返回一个新的HttpRequest 。

    从以下版本开始：
    9

    • 构造方法详细信息

      • Builder

        protected Builder​()
        创建一个生成器。

    • 方法详细信息

      • expectContinue

        public abstract HttpRequest.Builder expectContinue​(boolean enable)
        在发送请求正文之前请求服务器确认请求。 默认情况下禁用此功能。 如果启用，则请求服务器在客户端发送请求正文之前发送错误响应或100 Continue响应。 这意味着在接收到该临时响应之前，请求的请求处理器将不被调用。
        参数
        enable - true如果Expect继续发送
        结果
        这个请求生成器

      • header

        public abstract HttpRequest.Builder header​(String name,
                                           String value)
        将给定的名称值对添加到此请求的头文件集中。
        参数
        name - 标题名称
        value - 标头值
        结果
        这个请求生成器

      • headers

        public abstract HttpRequest.Builder headers​(String... headers)
        将给定的名称值对添加到此请求的标题集。 所提供的String必须作为名称和值交替。
        参数
        headers - 字符串名称值对的列表
        结果
        这个请求生成器
        异常
        IllegalArgumentException - 如果有奇数个参数

      • setHeader

        public abstract HttpRequest.Builder setHeader​(String name,
                                              String value)
        将给定的名称值对设置为此请求的标题集。 这将覆盖任何以前设置的名称值。
        参数
        name - 标题名称
        value - 标头值
        结果
        这个请求生成器

      • GET

        public abstract HttpRequest.Builder GET​()
        将此构建器的请求方法设置为GET。
        结果
        一个 HttpRequest

      • POST

        public abstract HttpRequest.Builder POST​(HttpRequest.BodyProcessor body)
        将此构建器的请求方法设置为POST，并将其请求体处理器设置为给定值。
        参数
        body - 身体处理器
        结果
        一个 HttpRequest

      • PUT

        public abstract HttpRequest.Builder PUT​(HttpRequest.BodyProcessor body)
        将此构建器的请求方法设置为PUT，并将其请求体处理器设置为给定值。
        参数
        body - 身体处理器
        结果
        一个 HttpRequest

      • DELETE

        public abstract HttpRequest.Builder DELETE​(HttpRequest.BodyProcessor body)
        将此构建器的请求方法设置为DELETE，并将其请求体处理器设置为给定值。
        参数
        body - 身体处理器
        结果
        一个 HttpRequest

      • copy

        public abstract HttpRequest.Builder copy​()
        根据当前状态返回此Builder的精确副本。 然后可以独立于此构建器修改新构建器。
        结果
        这个Builder的精确副本