HttpConnection (tool-http 1.0.3.9.RELEASE API)

java.lang.Object
- cn.luues.tool.http.HttpConnection

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

作者:

Looly

字段概要

字段
限定符和类型字段和说明

private HttpURLConnection conn

private Proxy proxy

private URL url

字段
限定符和类型	字段和说明
`private HttpURLConnection`	`conn`
`private Proxy`	`proxy`
`private URL`	`url`

构造器概要

构造器
构造器和说明

HttpConnection(URL url, Proxy proxy)
构造HttpConnection

构造器
构造器和说明
`HttpConnection(URL url, Proxy proxy)` 构造HttpConnection

方法概要

所有方法静态方法实例方法具体方法
限定符和类型	方法和说明
`private static void`	`allowPatch()` 增加支持的METHOD方法 see: https://stackoverflow.com/questions/25163131/httpurlconnection-invalid-http-method-patch
`HttpConnection`	`connect()` 连接
`static HttpConnection`	`create(String urlStr, Proxy proxy)` 创建HttpConnection
`static HttpConnection`	`create(URL url, Proxy proxy)` 创建HttpConnection
`HttpConnection`	`disableCache()` 关闭缓存
`HttpConnection`	`disconnect()` 断开连接
`HttpConnection`	`disconnectQuietly()` 静默断开连接。
`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()` 初始化连接相关信息
`private URLConnection`	`openConnection()` 建立连接
`private HttpURLConnection`	`openHttp()` 初始化http或https请求参数有些时候https请求会出现com.sun.net.ssl.internal.www.protocol.https.HttpsURLConnectionOldImpl的实现，此为sun内部api，按照普通http请求处理
`int`	`responseCode()` 获取响应码
`HttpConnection`	`setChunkedStreamingMode(int blockSize)` 采用流方式上传数据，无需本地缓存数据。
`HttpConnection`	`setConnectionAndReadTimeout(int timeout)` 设置连接和读取的超时时间
`HttpConnection`	`setConnectTimeout(int timeout)` 设置连接超时
`HttpConnection`	`setCookie(String cookie)` 设置Cookie
`HttpConnection`	`setHttpsInfo(HostnameVerifier hostnameVerifier, SSLSocketFactory ssf)` 设置https请求参数有些时候htts请求会出现com.sun.net.ssl.internal.www.protocol.https.HttpsURLConnectionOldImpl的实现，此为sun内部api，按照普通http请求处理
`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

- 字段详细资料
  - url
```
private final URL url
```
  - proxy
```
private final Proxy proxy
```
  - conn
```
private HttpURLConnection conn
```
- 构造器详细资料
  - HttpConnection
```
public HttpConnection(URL url,
                      Proxy proxy)
```
    构造HttpConnection
    
    参数:
    
    url - URL
    
    proxy - 代理
- 方法详细资料
  - create
```
public static HttpConnection create(String urlStr,
                                    Proxy proxy)
```
    创建HttpConnection
    
    参数:
    
    urlStr - URL
    
    proxy - 代理，无代理传null
    
    返回:
    
    HttpConnection
  - create
```
public static HttpConnection create(URL url,
                                    Proxy proxy)
```
    创建HttpConnection
    
    参数:
    
    url - URL
    
    proxy - 代理，无代理传null
    
    返回:
    
    HttpConnection
  - initConn
```
public HttpConnection initConn()
```
    初始化连接相关信息
    
    返回:
    
    HttpConnection
    
    从以下版本开始:
    
    4.4.1
  - 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
  - setHttpsInfo
```
public HttpConnection setHttpsInfo(HostnameVerifier hostnameVerifier,
                                   SSLSocketFactory ssf)
                            throws HttpException
```
    设置https请求参数
    有些时候htts请求会出现com.sun.net.ssl.internal.www.protocol.https.HttpsURLConnectionOldImpl的实现，此为sun内部api，按照普通http请求处理
    
    参数:
    
    hostnameVerifier - 域名验证器，非https传入null
    
    ssf - SSLSocketFactory，非https传入null
    
    返回:
    
    this
    
    抛出:
    
    HttpException - KeyManagementException和NoSuchAlgorithmException异常包装
  - disableCache
```
public HttpConnection disableCache()
```
    关闭缓存
    
    返回:
    
    this
    
    另请参阅:
    
    URLConnection.setUseCaches(boolean)
  - 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数），0或小于0表示不设置Chuncked模式
    
    返回:
    
    this
  - setInstanceFollowRedirects
```
public HttpConnection setInstanceFollowRedirects(boolean isInstanceFollowRedirects)
```
    设置自动HTTP 30X跳转
    
    参数:
    
    isInstanceFollowRedirects - 是否自定跳转
    
    返回:
    
    this
  - connect
```
public HttpConnection connect()
                       throws IOException
```
    连接
    
    返回:
    
    this
    
    抛出:
    
    IOException - IO异常
  - disconnectQuietly
```
public HttpConnection disconnectQuietly()
```
    静默断开连接。不抛出异常
    
    返回:
    
    this
    
    从以下版本开始:
    
    4.6.0
  - disconnect
```
public HttpConnection disconnect()
```
    断开连接
    
    返回:
    
    this
  - getInputStream
```
public InputStream getInputStream()
                           throws IOException
```
    获得输入流对象
    输入流对象用于读取数据
    
    返回:
    
    输入流对象
    
    抛出:
    
    IOException - IO异常
  - getErrorStream
```
public InputStream getErrorStream()
```
    当返回错误代码时，获得错误内容流
    
    返回:
    
    错误内容
  - 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
  - openHttp
```
private HttpURLConnection openHttp()
                            throws IOException
```
    初始化http或https请求参数
    有些时候https请求会出现com.sun.net.ssl.internal.www.protocol.https.HttpsURLConnectionOldImpl的实现，此为sun内部api，按照普通http请求处理
    
    返回:
    
    HttpURLConnection，https返回HttpsURLConnection
    
    抛出:
    
    IOException
  - openConnection
```
private URLConnection openConnection()
                              throws IOException
```
    建立连接
    
    返回:
    
    URLConnection
    
    抛出:
    
    IOException - IO异常
  - allowPatch
```
private static void allowPatch()
```
    增加支持的METHOD方法 see: https://stackoverflow.com/questions/25163131/httpurlconnection-invalid-http-method-patch
    
    从以下版本开始:
    
    5.1.6

类 HttpConnection

字段概要

构造器概要

方法概要

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

字段详细资料

url

proxy

conn

构造器详细资料

HttpConnection

方法详细资料

create

create

initConn

getMethod

setMethod

getUrl

getProxy

getHttpURLConnection

header

header

header

header

header

headers

setHttpsInfo

disableCache

setConnectTimeout

setReadTimeout

setConnectionAndReadTimeout

setCookie

setChunkedStreamingMode

setInstanceFollowRedirects

connect

disconnectQuietly

disconnect

getInputStream

getErrorStream

getOutputStream

responseCode

getCharsetName

getCharset

toString

openHttp

openConnection

allowPatch