HttpResponse (ladsn-tool-http 4.1.15 API)

java.lang.Object
- org.ladsn.tool.http.HttpBase<HttpResponse>
- - org.ladsn.tool.http.HttpResponse

所有已实现的接口:

java.io.Closeable, java.lang.AutoCloseable
```
public class HttpResponse
extends HttpBase<HttpResponse>
implements java.io.Closeable
```
Http响应类
非线程安全对象

作者:

Looly

字段概要
- 从类继承的字段 org.ladsn.tool.http.HttpBase
  bodyBytes, charset, headers, HTTP_1_0, HTTP_1_1, httpVersion

构造器概要

构造器
限定符	构造器和说明
`protected`	`HttpResponse(HttpConnection httpConnection, java.nio.charset.Charset charset, boolean isAsync, boolean isIgnoreBody)` 构造

方法概要

All Methods Instance Methods Concrete Methods
限定符和类型	方法和说明
`java.lang.String`	`body()` 获取响应主体
`byte[]`	`bodyBytes()` 获取响应流字节码此方法会转为同步模式
`java.io.InputStream`	`bodyStream()` 获得服务区响应流异步模式下获取Http原生流，同步模式下获取获取到的在内存中的副本如果想在同步模式下获取流，请先调用`sync()`方法强制同步流获取后处理完毕需关闭此类
`void`	`close()`
`java.lang.String`	`contentEncoding()` 获取内容编码
`java.net.HttpCookie`	`getCookie(java.lang.String name)` 获取Cookie
`java.util.List<java.net.HttpCookie>`	`getCookies()` 获取Cookie
`java.lang.String`	`getCookieStr()` 获取本次请求服务器返回的Cookie信息
`java.lang.String`	`getCookieValue(java.lang.String name)` 获取Cookie值
`int`	`getStatus()` 获取状态码
`boolean`	`isGzip()`
`boolean`	`isOk()` 请求是否成功，判断依据为：状态码范围在200~299内。
`HttpResponse`	`sync()` 同步如果为异步状态，则暂时不读取服务器中响应的内容，而是持有Http链接的`InputStream`。
`java.lang.String`	`toString()`
`long`	`writeBody(java.io.File destFile)` 将响应内容写出到文件异步模式下直接读取Http流写出，同步模式下将存储在内存中的响应内容写出写出后会关闭Http流（异步模式）
`long`	`writeBody(java.io.File destFile, StreamProgress streamProgress)` 将响应内容写出到文件异步模式下直接读取Http流写出，同步模式下将存储在内存中的响应内容写出写出后会关闭Http流（异步模式）
`long`	`writeBody(java.io.OutputStream out, boolean isCloseOut, StreamProgress streamProgress)` 将响应内容写出到`OutputStream` 异步模式下直接读取Http流写出，同步模式下将存储在内存中的响应内容写出写出后会关闭Http流（异步模式）
`long`	`writeBody(java.lang.String destFilePath)` 将响应内容写出到文件异步模式下直接读取Http流写出，同步模式下将存储在内存中的响应内容写出写出后会关闭Http流（异步模式）

从类继承的方法 org.ladsn.tool.http.HttpBase
addHeaders, charset, charset, charset, header, header, header, header, header, header, header, header, headerList, headers, httpVersion, httpVersion, removeHeader, removeHeader

从类继承的方法 java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

- 构造器详细资料
  - HttpResponse
```
protected HttpResponse(HttpConnection httpConnection,
                       java.nio.charset.Charset charset,
                       boolean isAsync,
                       boolean isIgnoreBody)
```
    构造
    
    参数:
    
    httpConnection - HttpConnection
    
    charset - 编码，从请求编码中获取默认编码
    
    isAsync - 是否异步
    
    isIgnoreBody - 是否忽略读取响应体
    
    从以下版本开始:
    
    3.1.2
- 方法详细资料
  - getStatus
```
public int getStatus()
```
    获取状态码
    
    返回:
    
    状态码
  - isOk
```
public boolean isOk()
```
    请求是否成功，判断依据为：状态码范围在200~299内。
    
    返回:
    
    是否成功请求
    
    从以下版本开始:
    
    4.1.9
  - sync
```
public HttpResponse sync()
                  throws HttpException
```
    同步
    如果为异步状态，则暂时不读取服务器中响应的内容，而是持有Http链接的InputStream。
    当调用此方法时，异步状态转为同步状态，此时从Http链接流中读取body内容并暂存在内容中。如果已经是同步状态，则不进行任何操作。
    
    返回:
    
    this
    
    抛出:
    
    HttpException - IO异常
  - contentEncoding
```
public java.lang.String contentEncoding()
```
    获取内容编码
    
    返回:
    
    String
  - isGzip
```
public boolean isGzip()
```
    返回:
    
    是否为gzip压缩过的内容
  - getCookieStr
```
public java.lang.String getCookieStr()
```
    获取本次请求服务器返回的Cookie信息
    
    返回:
    
    Cookie字符串
    
    从以下版本开始:
    
    3.1.1
  - getCookies
```
public java.util.List<java.net.HttpCookie> getCookies()
```
    获取Cookie
    
    返回:
    
    Cookie列表
    
    从以下版本开始:
    
    3.1.1
  - getCookie
```
public java.net.HttpCookie getCookie(java.lang.String name)
```
    获取Cookie
    
    参数:
    
    name - Cookie名
    
    返回:
    
    HttpCookie
    
    从以下版本开始:
    
    4.1.4
  - getCookieValue
```
public java.lang.String getCookieValue(java.lang.String name)
```
    获取Cookie值
    
    参数:
    
    name - Cookie名
    
    返回:
    
    Cookie值
    
    从以下版本开始:
    
    4.1.4
  - bodyStream
```
public java.io.InputStream bodyStream()
```
    获得服务区响应流
    异步模式下获取Http原生流，同步模式下获取获取到的在内存中的副本
    如果想在同步模式下获取流，请先调用sync()方法强制同步
    流获取后处理完毕需关闭此类
    
    返回:
    
    响应流
  - bodyBytes
```
public byte[] bodyBytes()
```
    获取响应流字节码
    此方法会转为同步模式
    
    返回:
    
    byte[]
  - body
```
public java.lang.String body()
                      throws HttpException
```
    获取响应主体
    
    返回:
    
    String
    
    抛出:
    
    HttpException - 包装IO异常
  - writeBody
```
public long writeBody(java.io.OutputStream out,
                      boolean isCloseOut,
                      StreamProgress streamProgress)
```
    将响应内容写出到OutputStream
    异步模式下直接读取Http流写出，同步模式下将存储在内存中的响应内容写出
    写出后会关闭Http流（异步模式）
    
    参数:
    
    out - 写出的流
    
    isCloseOut - 是否关闭输出流
    
    streamProgress - 进度显示接口，通过实现此接口显示下载进度
    
    返回:
    
    写出bytes数
    
    从以下版本开始:
    
    3.3.2
  - writeBody
```
public long writeBody(java.io.File destFile,
                      StreamProgress streamProgress)
```
    将响应内容写出到文件
    异步模式下直接读取Http流写出，同步模式下将存储在内存中的响应内容写出
    写出后会关闭Http流（异步模式）
    
    参数:
    
    destFile - 写出到的文件
    
    streamProgress - 进度显示接口，通过实现此接口显示下载进度
    
    返回:
    
    写出bytes数
    
    从以下版本开始:
    
    3.3.2
  - writeBody
```
public long writeBody(java.io.File destFile)
```
    将响应内容写出到文件
    异步模式下直接读取Http流写出，同步模式下将存储在内存中的响应内容写出
    写出后会关闭Http流（异步模式）
    
    参数:
    
    destFile - 写出到的文件
    
    返回:
    
    写出bytes数
    
    从以下版本开始:
    
    3.3.2
  - writeBody
```
public long writeBody(java.lang.String destFilePath)
```
    将响应内容写出到文件
    异步模式下直接读取Http流写出，同步模式下将存储在内存中的响应内容写出
    写出后会关闭Http流（异步模式）
    
    参数:
    
    destFilePath - 写出到的文件的路径
    
    返回:
    
    写出bytes数
    
    从以下版本开始:
    
    3.3.2
  - close
```
public void close()
```
    指定者:
    
    close 在接口中 java.io.Closeable
    
    指定者:
    
    close 在接口中 java.lang.AutoCloseable
  - toString
```
public java.lang.String toString()
```
    覆盖:
    
    toString 在类中 HttpBase<HttpResponse>

类 HttpResponse

字段概要

从类继承的字段 org.ladsn.tool.http.HttpBase

构造器概要

方法概要

从类继承的方法 org.ladsn.tool.http.HttpBase

从类继承的方法 java.lang.Object

构造器详细资料

HttpResponse

方法详细资料

getStatus

isOk

sync

contentEncoding

isGzip

getCookieStr

getCookies

getCookie

getCookieValue

bodyStream

bodyBytes

body

writeBody

writeBody

writeBody

writeBody

close

toString