HttpConnection (easytools 1.0.0 API)

java.lang.Object
- javacommon.easytools.http.HttpConnection

```
public class HttpConnection
extends Object
```
http连接对象，对HttpURLConnection的包装

构造器概要

构造器
构造器和说明
`HttpConnection(String urlStr, Method method)` 构造HttpConnection
`HttpConnection(String urlStr, Method method, HostnameVerifier hostnameVerifier, SSLSocketFactory ssf, int timeout, Proxy proxy)` 构造HttpConnection
`HttpConnection(String urlStr, Method method, int timeout)` 构造HttpConnection

方法概要

所有方法静态方法实例方法具体方法
限定符和类型	方法和说明
`HttpConnection`	`connect()` 连接
`static HttpConnection`	`create(String urlStr, Method method)` 创建HttpConnection
`static HttpConnection`	`create(String urlStr, Method method, HostnameVerifier hostnameVerifier, SSLSocketFactory ssf)` 创建HttpConnection
`static HttpConnection`	`create(String urlStr, Method method, HostnameVerifier hostnameVerifier, SSLSocketFactory ssf, int timeout, Proxy proxy)` 创建HttpConnection
`static HttpConnection`	`create(String urlStr, Method method, int timeout)` 创建HttpConnection
`HttpConnection`	`disableCache()` 关闭缓存
`HttpConnection`	`disconnect()` 断开连接
`Charset`	`getCharset()` 获取字符集编码从Http连接的头信息中获得字符集从ContentType中获取
`String`	`getCharsetName()` 获得字符集编码从Http连接的头信息中获得字符集从ContentType中获取
`InputStream`	`getErrorStream()` 当返回错误代码时，获得错误内容流
`HttpURLConnection`	`getHttpURLConnection()` 获取HttpURLConnection对象
`InputStream`	`getInputStream()` 获得输入流对象输入流对象用于读取数据
`Method`	`getMethod()` 获取请求方法,GET/POST
`OutputStream`	`getOutputStream()` 获取输出流对象输出流对象用于发送数据
`Proxy`	`getProxy()` 获得代理
`URL`	`getUrl()` 获取请求URL
`String`	`header(Header name)` 获取Http请求头
`HttpConnection`	`header(Header header, String value, boolean isOverride)` 设置请求头当请求头存在时，覆盖之
`HttpConnection`	`header(Map<String,List<String>> headerMap, boolean isOverride)` 设置请求头不覆盖原有请求头
`String`	`header(String name)` 获取Http请求头
`HttpConnection`	`header(String header, String value, boolean isOverride)` 设置请求头当请求头存在时，覆盖之
`Map<String,List<String>>`	`headers()` 获取所有Http请求头
`HttpConnection`	`initConn()` 初始化连接相关信息
`int`	`responseCode()` 获取响应码
`HttpConnection`	`setChunkedStreamingMode(int blockSize)` 采用流方式上传数据，无需本地缓存数据。
`HttpConnection`	`setConnectionAndReadTimeout(int timeout)` 设置连接和读取的超时时间
`HttpConnection`	`setConnectTimeout(int timeout)` 设置连接超时
`HttpConnection`	`setCookie(String cookie)` 设置Cookie
`HttpConnection`	`setInstanceFollowRedirects(boolean isInstanceFollowRedirects)` 设置自动HTTP 30X跳转
`HttpConnection`	`setMethod(Method method)` 设置请求方法
`HttpConnection`	`setReadTimeout(int timeout)` 设置读取超时
`String`	`toString()`

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

构造器详细资料

HttpConnection

public HttpConnection(String urlStr,
                      Method method)

构造HttpConnection

参数:: urlStr - URL; method - HTTP方法

HttpConnection

public HttpConnection(String urlStr,
                      Method method,
                      int timeout)

构造HttpConnection

参数:: urlStr - URL; method - HTTP方法; timeout - 超时时长

HttpConnection

public HttpConnection(String urlStr,
                      Method method,
                      HostnameVerifier hostnameVerifier,
                      SSLSocketFactory ssf,
                      int timeout,
                      Proxy proxy)

构造HttpConnection

参数:: urlStr - URL; method - HTTP方法; hostnameVerifier - 域名验证器; ssf - SSLSocketFactory; timeout - 超时时长; proxy - 代理

方法详细资料

create

public static HttpConnection create(String urlStr,
                                    Method method)

创建HttpConnection

参数:: urlStr - URL; method - HTTP方法
返回:: HttpConnection

create

public static HttpConnection create(String urlStr,
                                    Method method,
                                    int timeout)

创建HttpConnection

参数:: urlStr - URL; method - HTTP方法; timeout - 超时时长
返回:: HttpConnection

create

public static HttpConnection create(String urlStr,
                                    Method method,
                                    HostnameVerifier hostnameVerifier,
                                    SSLSocketFactory ssf)

创建HttpConnection

参数:: urlStr - URL; method - HTTP方法; hostnameVerifier - HostnameVerifier; ssf - SSLSocketFactory
返回:: HttpConnection

create

public static HttpConnection create(String urlStr,
                                    Method method,
                                    HostnameVerifier hostnameVerifier,
                                    SSLSocketFactory ssf,
                                    int timeout,
                                    Proxy proxy)

创建HttpConnection

参数:: urlStr - URL; method - HTTP方法; hostnameVerifier - HostnameVerifier; ssf - SSLSocketFactory; timeout - 超时时间; proxy - 代理
返回:: HttpConnection

initConn
```
public HttpConnection initConn()
```
初始化连接相关信息

返回:

HttpConnection

getMethod
```
public Method getMethod()
```
获取请求方法,GET/POST

返回:

请求方法,GET/POST

setMethod
```
public HttpConnection setMethod(Method method)
```
设置请求方法

参数:

method - 请求方法

返回:

自己

getUrl
```
public URL getUrl()
```
获取请求URL

返回:

请求URL

getProxy
```
public Proxy getProxy()
```
获得代理

返回:

Proxy

getHttpURLConnection
```
public HttpURLConnection getHttpURLConnection()
```
获取HttpURLConnection对象

返回:

HttpURLConnection

header

public HttpConnection header(String header,
                             String value,
                             boolean isOverride)

设置请求头
当请求头存在时，覆盖之

参数:: header - 头名; value - 头值; isOverride - 是否覆盖旧值
返回:: HttpConnection

header

public HttpConnection header(Header header,
                             String value,
                             boolean isOverride)

设置请求头
当请求头存在时，覆盖之

参数:: header - 头名; value - 头值; isOverride - 是否覆盖旧值
返回:: HttpConnection

header

public HttpConnection header(Map<String,List<String>> headerMap,
                             boolean isOverride)

设置请求头
不覆盖原有请求头

参数:: headerMap - 请求头; isOverride - 是否覆盖
返回:: this

header
```
public String header(String name)
```
获取Http请求头

参数:

name - Header名

返回:

Http请求头值

header
```
public String header(Header name)
```
获取Http请求头

参数:

name - Header名

返回:

Http请求头值

headers
```
public Map<String,List<String>> headers()
```
获取所有Http请求头

返回:

Http请求头Map

disableCache
```
public HttpConnection disableCache()
```
关闭缓存

返回:

this

setConnectTimeout
```
public HttpConnection setConnectTimeout(int timeout)
```
设置连接超时

参数:

timeout - 超时

返回:

this

setReadTimeout
```
public HttpConnection setReadTimeout(int timeout)
```
设置读取超时

参数:

timeout - 超时

返回:

this

setConnectionAndReadTimeout
```
public HttpConnection setConnectionAndReadTimeout(int timeout)
```
设置连接和读取的超时时间

参数:

timeout - 超时时间

返回:

this

setCookie

public HttpConnection setCookie(String cookie)

设置Cookie

参数:: cookie - Cookie
返回:: this

setChunkedStreamingMode
```
public HttpConnection setChunkedStreamingMode(int blockSize)
```
采用流方式上传数据，无需本地缓存数据。
HttpUrlConnection默认是将所有数据读到本地缓存，然后再发送给服务器，这样上传大文件时就会导致内存溢出。

参数:

blockSize - 块大小（bytes数）

返回:

this

setInstanceFollowRedirects
```
public HttpConnection setInstanceFollowRedirects(boolean isInstanceFollowRedirects)
```
设置自动HTTP 30X跳转

参数:

isInstanceFollowRedirects - 是否自定跳转

返回:

this

connect

public HttpConnection connect()
                       throws IOException

连接

返回:: this
抛出:: IOException - IO异常

disconnect
```
public HttpConnection disconnect()
```
断开连接

返回:

this

getInputStream
```
public InputStream getInputStream()
                           throws IOException
```
获得输入流对象
输入流对象用于读取数据

返回:

输入流对象

抛出:

IOException - IO异常

getErrorStream
```
public InputStream getErrorStream()
                           throws IOException
```
当返回错误代码时，获得错误内容流

返回:

错误内容

抛出:

IOException - IO异常

getOutputStream
```
public OutputStream getOutputStream()
                             throws IOException
```
获取输出流对象输出流对象用于发送数据

返回:

OutputStream

抛出:

IOException - IO异常

responseCode
```
public int responseCode()
                 throws IOException
```
获取响应码

返回:

响应码

抛出:

IOException - IO异常

getCharsetName
```
public String getCharsetName()
```
获得字符集编码
从Http连接的头信息中获得字符集
从ContentType中获取

返回:

字符集编码

getCharset
```
public Charset getCharset()
```
获取字符集编码
从Http连接的头信息中获得字符集
从ContentType中获取

返回:

Charset编码

从以下版本开始:

3.0.9

toString
```
public String toString()
```
覆盖:

toString 在类中 Object

类 HttpConnection

构造器概要

方法概要

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

构造器详细资料

HttpConnection

HttpConnection

HttpConnection

方法详细资料

create

create

create

create

initConn

getMethod

setMethod

getUrl

getProxy

getHttpURLConnection

header

header

header

header

header

headers

disableCache

setConnectTimeout

setReadTimeout

setConnectionAndReadTimeout

setCookie

setChunkedStreamingMode

setInstanceFollowRedirects

connect

disconnect

getInputStream

getErrorStream

getOutputStream

responseCode

getCharsetName

getCharset

toString