org.ladsn.tool.http

类 HttpConnection

java.lang.Object

org.ladsn.tool.http.HttpConnection

public class HttpConnection
extends java.lang.Object

http连接对象，对HttpURLConnection的包装

作者:

Looly

构造器概要

构造器

构造器和说明
HttpConnection(java.lang.String urlStr, Method method) 构造HttpConnection
HttpConnection(java.lang.String urlStr, Method method, javax.net.ssl.HostnameVerifier hostnameVerifier, javax.net.ssl.SSLSocketFactory ssf, int timeout, java.net.Proxy proxy) 构造HttpConnection
HttpConnection(java.lang.String urlStr, Method method, int timeout) 构造HttpConnection
HttpConnection(java.net.URL url, Method method, javax.net.ssl.HostnameVerifier hostnameVerifier, javax.net.ssl.SSLSocketFactory ssf, int timeout, java.net.Proxy proxy) 构造HttpConnection

方法概要

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

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

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

构造器详细资料

HttpConnection

public HttpConnection(java.lang.String urlStr,
                      Method method)

构造HttpConnection

参数:

urlStr - URL

method - HTTP方法

HttpConnection

public HttpConnection(java.lang.String urlStr,
                      Method method,
                      int timeout)

构造HttpConnection

参数:

urlStr - URL

method - HTTP方法

timeout - 超时时长

HttpConnection

public HttpConnection(java.lang.String urlStr,
                      Method method,
                      javax.net.ssl.HostnameVerifier hostnameVerifier,
                      javax.net.ssl.SSLSocketFactory ssf,
                      int timeout,
                      java.net.Proxy proxy)

构造HttpConnection

参数:

urlStr - URL

method - HTTP方法

hostnameVerifier - 域名验证器

ssf - SSLSocketFactory

timeout - 超时时长

proxy - 代理

HttpConnection

public HttpConnection(java.net.URL url,
                      Method method,
                      javax.net.ssl.HostnameVerifier hostnameVerifier,
                      javax.net.ssl.SSLSocketFactory ssf,
                      int timeout,
                      java.net.Proxy proxy)

构造HttpConnection

参数:

url - URL

method - HTTP方法

hostnameVerifier - 域名验证器

ssf - SSLSocketFactory

timeout - 超时时长

proxy - 代理

方法详细资料

create

public static HttpConnection create(java.lang.String urlStr,
                                    Method method)

创建HttpConnection

参数:

urlStr - URL

method - HTTP方法

返回:

HttpConnection

create

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

创建HttpConnection

参数:

urlStr - URL

method - HTTP方法

timeout - 超时时长

返回:

HttpConnection

create

public static HttpConnection create(java.lang.String urlStr,
                                    Method method,
                                    javax.net.ssl.HostnameVerifier hostnameVerifier,
                                    javax.net.ssl.SSLSocketFactory ssf)

创建HttpConnection

参数:

urlStr - URL

method - HTTP方法

hostnameVerifier - HostnameVerifier

ssf - SSLSocketFactory

返回:

HttpConnection

create

public static HttpConnection create(java.lang.String urlStr,
                                    Method method,
                                    javax.net.ssl.HostnameVerifier hostnameVerifier,
                                    javax.net.ssl.SSLSocketFactory ssf,
                                    int timeout,
                                    java.net.Proxy proxy)

创建HttpConnection

参数:

urlStr - URL

method - HTTP方法

hostnameVerifier - HostnameVerifier

ssf - SSLSocketFactory

timeout - 超时时间

proxy - 代理

返回:

HttpConnection

create

public static HttpConnection create(java.net.URL url,
                                    Method method,
                                    javax.net.ssl.HostnameVerifier hostnameVerifier,
                                    javax.net.ssl.SSLSocketFactory ssf,
                                    int timeout,
                                    java.net.Proxy proxy)

创建HttpConnection

参数:

url - URL

method - HTTP方法

hostnameVerifier - HostnameVerifier

ssf - SSLSocketFactory

timeout - 超时时间

proxy - 代理

返回:

HttpConnection

从以下版本开始:

4.1.9

initConn

public HttpConnection initConn()

初始化连接相关信息

返回:

HttpConnection

getMethod

public Method getMethod()

获取请求方法,GET/POST

返回:

请求方法,GET/POST

setMethod

public HttpConnection setMethod(Method method)

设置请求方法

参数:

method - 请求方法

返回:

自己

getUrl

public java.net.URL getUrl()

获取请求URL

返回:

请求URL

getProxy

public java.net.Proxy getProxy()

获得代理

返回:

Proxy

getHttpURLConnection

public java.net.HttpURLConnection getHttpURLConnection()

获取HttpURLConnection对象

返回:

HttpURLConnection

header

public HttpConnection header(java.lang.String header,
                             java.lang.String value,
                             boolean isOverride)

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

参数:

header - 头名

value - 头值

isOverride - 是否覆盖旧值

返回:

HttpConnection

header

public HttpConnection header(Header header,
                             java.lang.String value,
                             boolean isOverride)

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

参数:

header - 头名

value - 头值

isOverride - 是否覆盖旧值

返回:

HttpConnection

header

public HttpConnection header(java.util.Map<java.lang.String,java.util.List<java.lang.String>> headerMap,
                             boolean isOverride)

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

参数:

headerMap - 请求头

isOverride - 是否覆盖

返回:

this

header

public java.lang.String header(java.lang.String name)

获取Http请求头

参数:

name - Header名

返回:

Http请求头值

header

public java.lang.String header(Header name)

获取Http请求头

参数:

name - Header名

返回:

Http请求头值

headers

public java.util.Map<java.lang.String,java.util.List<java.lang.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(java.lang.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 java.io.IOException

连接

返回:

this

抛出:

java.io.IOException - IO异常

disconnect

public HttpConnection disconnect()

断开连接

返回:

this

getInputStream

public java.io.InputStream getInputStream()
                                   throws java.io.IOException

获得输入流对象
输入流对象用于读取数据

返回:

输入流对象

抛出:

java.io.IOException - IO异常

getErrorStream

public java.io.InputStream getErrorStream()
                                   throws java.io.IOException

当返回错误代码时，获得错误内容流

返回:

错误内容

抛出:

java.io.IOException - IO异常

getOutputStream

public java.io.OutputStream getOutputStream()
                                     throws java.io.IOException

获取输出流对象 输出流对象用于发送数据

返回:

OutputStream

抛出:

java.io.IOException - IO异常

responseCode

public int responseCode()
                 throws java.io.IOException

获取响应码

返回:

响应码

抛出:

java.io.IOException - IO异常

getCharsetName

public java.lang.String getCharsetName()

获得字符集编码
从Http连接的头信息中获得字符集
从ContentType中获取

返回:

字符集编码

getCharset

public java.nio.charset.Charset getCharset()

获取字符集编码
从Http连接的头信息中获得字符集
从ContentType中获取

返回:

Charset编码

从以下版本开始:

3.0.9

toString

public java.lang.String toString()

覆盖:

toString 在类中 java.lang.Object