-
- 参数类型
-
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
-
-
嵌套类汇总
嵌套类 变量和类型 接口 描述 static interface
HttpResponse.BodyHandler<T>
响应主体的处理程序。static class
HttpResponse.BodyHandlers
实现各种有用处理程序的BodyHandler
的实现,例如将响应主体作为String处理,或将响应主体流式传输到文件。static interface
HttpResponse.BodySubscriber<T>
BodySubscriber
响应正文字节并将它们转换为更高级别的Java类型。static class
HttpResponse.BodySubscribers
实现各种有用订户的BodySubscriber
的实现,例如将响应主体字节转换为字符串,或将字节流式传输到文件。static interface
HttpResponse.PushPromiseHandler<T>
推送承诺的处理程序。static interface
HttpResponse.ResponseInfo
初始接收响应时和处理主体之前提供给BodyHandler
的初始响应信息。
-
方法摘要
所有方法 实例方法 抽象方法 变量和类型 方法 描述 T
body()
返回正文。HttpHeaders
headers()
返回收到的响应头。Optional<HttpResponse<T>>
previousResponse()
返回Optional
其中包含先前的中间响应(如果收到一个)。HttpRequest
request()
返回与此响应对应的HttpRequest
。Optional<SSLSession>
sslSession()
返回Optional
,其中包含对此响应有效的SSLSession
。int
statusCode()
返回此响应的状态代码。URI
uri()
返回收到响应的URI
。HttpClient.Version
version()
返回用于此响应的HTTP协议版本。
-
-
-
方法详细信息
-
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[]
或String
或Path
),或者它可能表示正在读取正文的对象,例如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协议版本
-
-