模块  java.net.http
软件包  java.net.http

Interface HttpResponse<T>

  • 参数类型
    T - 响应正文类型

    public interface HttpResponse<T>
    HTTP响应。

    HttpResponse不是直接创建的,而是由于发送HttpRequest而返回。 当收到响应状态代码和标题时,通常在完全接收到响应主体之后, HttpResponse可用。 在完全接收响应主体之前HttpResponse是否可用取决于发送HttpRequest时提供的HttpRequest

    此类提供了访问响应状态代码,标头,响应正文以及与此响应对应的HttpRequest

    以下是以String形式检索响应的示例:

       HttpResponse<String> response = client .send(request, BodyHandlers.ofString());  

    BodyHandlers提供了许多常见响应处理程序的实现。 或者,可以使用自定义BodyHandler实现。

    从以下版本开始:
    11
    • 方法详细信息

      • statusCode

        int statusCode()
        返回此响应的状态代码。
        结果
        响应代码
      • request

        HttpRequest request()
        返回与此响应对应的HttpRequest

        返回HttpRequest可以不提供当所述发起请求sending 例如,如果重定向了发起请求,则此方法返回的请求将具有重定向的URI,该URI将与发起请求URI不同。

        结果
        请求
        另请参见:
        previousResponse()
      • previousResponse

        Optional<HttpResponse<T>> previousResponse()
        返回Optional其中包含先前的中间响应(如果收到了一个)。 中间响应是由于重定向或身份验证而接收的响应。 如果未收到先前的响应,则返回空Optional
        结果
        包含HttpResponse的Optional,如果有的话。
      • headers

        HttpHeaders headers()
        返回收到的响应头。
        结果
        响应标头
      • body

        T body()
        返回正文。 根据T的类型,返回的正文可能在读取后表示正文(例如byte[]StringPath ),或者它可能表示正在读取正文的对象,例如InputStream

        如果这个HttpResponse从的调用返回previousResponse()那么此方法返回null

        结果
        身体
      • sslSession

        Optional<SSLSession> sslSession()
        返回Optional其中包含对此响应有效的SSLSession 如果这不是HTTPS响应,则返回空Optional
        结果
        Optional包含与响应关联的 SSLSession
      • uri

        URI uri()
        返回收到响应的URI 如果发生重定向,这可能与请求URI不同。
        结果
        响应的URI
      • version

        HttpClient.Version version()
        返回用于此响应的HTTP协议版本。
        结果
        HTTP协议版本