com.alipay.api.internal.util

类 WebUtils

java.lang.Object

com.alipay.api.internal.util.WebUtils

public class WebUtils
extends Object

网络工具类。

从以下版本开始:

1.0, Sep 12, 2009

作者:

carver.gu

方法概要

限定符和类型	方法和说明
static String	buildForm(String baseUrl, Map<String,String> parameters)
static String	buildQuery(Map<String,String> params, String charset)
static String	decode(String value) 使用默认的UTF-8字符集反编码请求参数值。
static String	decode(String value, String charset) 使用指定的字符集反编码请求参数值。
static String	doGet(String url, Map<String,String> params) 执行HTTP GET请求。
static String	doGet(String url, Map<String,String> params, String charset) 执行HTTP GET请求。
static String	doPost(String url, Map<String,String> params, Map<String,FileItem> fileParams, String charset, int connectTimeout, int readTimeout, String proxyHost, int proxyPort, Map<String,String> headers, Map<String,String> resHeaders) 执行带文件上传的HTTP POST请求。
static String	doPost(String url, Map<String,String> params, String charset, int connectTimeout, int readTimeout, String proxyHost, int proxyPort, Map<String,String> headers, Map<String,String> resHeaders) 执行HTTP POST请求，可使用代理proxy。
static String	doPost(String url, String ctype, byte[] content, int connectTimeout, int readTimeout, String proxyHost, int proxyPort, Map<String,String> headers, Map<String,String> resHeaders) 执行HTTP POST请求。
static String	encode(String value) 使用默认的UTF-8字符集编码请求参数值。
static String	encode(String value, String charset) 使用指定的字符集编码请求参数值。
static HttpURLConnection	getConnection(URL url, String method, String ctype, Map<String,String> headers)
static HttpURLConnection	getConnection(URL url, String method, String ctype, String proxyHost, int proxyPort, Map<String,String> headers)
static byte[]	getFileEntry(String fieldName, String fileName, String mimeType, String charset)
static Map<String,String>	getParamsFromUrl(String url)
protected static String	getResponseAsString(HttpURLConnection conn)
static byte[]	getTextEntry(String fieldName, String fieldValue, String charset)
static boolean	isNeedCheckServerTrusted() Getter method for property needCheckServerTrusted.
static void	setKeepAliveTimeout(int timeout) 设置KeepAlive连接超时时间，一次HTTP请求完成后，底层TCP连接将尝试尽量保持该超时时间后才关闭，以便其他HTTP请求复用TCP连接 KeepAlive连接超时时间设置为0，表示使用默认的KeepAlive连接缓存时长（目前为5s） 连接并非一定能保持指定的KeepAlive超时时长，比如服务端断开了连接 注：该方法目前只在JDK8上测试有效
static void	setNeedCheckServerTrusted(boolean needCheckServerTrusted) 设置是否校验SSL服务端证书
static Map<String,String>	splitUrlQuery(String query) 从URL中提取所有的参数。

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

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

方法详细资料

setNeedCheckServerTrusted

public static void setNeedCheckServerTrusted(boolean needCheckServerTrusted)

设置是否校验SSL服务端证书

参数:

needCheckServerTrusted - true：需要校验（默认，推荐）；

false：不需要校验（仅当部署环境不便于进行服务端证书校验，且已有其他方式确保通信安全时，可以关闭SSL服务端证书校验功能）

isNeedCheckServerTrusted

public static boolean isNeedCheckServerTrusted()

Getter method for property needCheckServerTrusted.

返回:

property value of needCheckServerTrusted

setKeepAliveTimeout

public static void setKeepAliveTimeout(int timeout)

设置KeepAlive连接超时时间，一次HTTP请求完成后，底层TCP连接将尝试尽量保持该超时时间后才关闭，以便其他HTTP请求复用TCP连接

KeepAlive连接超时时间设置为0，表示使用默认的KeepAlive连接缓存时长（目前为5s）

连接并非一定能保持指定的KeepAlive超时时长，比如服务端断开了连接

注：该方法目前只在JDK8上测试有效

参数:

timeout - KeepAlive超时时间，单位秒

doPost

public static String doPost(String url,
                            Map<String,String> params,
                            String charset,
                            int connectTimeout,
                            int readTimeout,
                            String proxyHost,
                            int proxyPort,
                            Map<String,String> headers,
                            Map<String,String> resHeaders)
                     throws IOException

执行HTTP POST请求，可使用代理proxy。

参数:

url - 请求地址

params - 请求参数

charset - 字符集，如UTF-8, GBK, GB2312

connectTimeout - 连接超时时间

readTimeout - 请求超时时间

proxyHost - 代理host，传null表示不使用代理

proxyPort - 代理端口，传0表示不使用代理

返回:

响应字符串

抛出:

IOException

doPost

public static String doPost(String url,
                            String ctype,
                            byte[] content,
                            int connectTimeout,
                            int readTimeout,
                            String proxyHost,
                            int proxyPort,
                            Map<String,String> headers,
                            Map<String,String> resHeaders)
                     throws IOException

执行HTTP POST请求。

参数:

url - 请求地址

ctype - 请求类型

content - 请求字节数组

connectTimeout - 连接超时时间

readTimeout - 请求超时时间

proxyHost - 代理host，传null表示不使用代理

proxyPort - 代理端口，传0表示不使用代理

返回:

响应字符串

抛出:

IOException

doPost

public static String doPost(String url,
                            Map<String,String> params,
                            Map<String,FileItem> fileParams,
                            String charset,
                            int connectTimeout,
                            int readTimeout,
                            String proxyHost,
                            int proxyPort,
                            Map<String,String> headers,
                            Map<String,String> resHeaders)
                     throws IOException

执行带文件上传的HTTP POST请求。

参数:

url - 请求地址

params - 文本请求参数

fileParams - 文件请求参数

charset - 字符集，如UTF-8, GBK, GB2312

connectTimeout - 连接超时时间

readTimeout - 请求超时时间

proxyHost - 代理host，传null表示不使用代理

proxyPort - 代理端口，传0表示不使用代理

返回:

响应字符串

抛出:

IOException

getTextEntry

public static byte[] getTextEntry(String fieldName,
                                  String fieldValue,
                                  String charset)
                           throws IOException

抛出:

IOException

getFileEntry

public static byte[] getFileEntry(String fieldName,
                                  String fileName,
                                  String mimeType,
                                  String charset)
                           throws IOException

抛出:

IOException

doGet

public static String doGet(String url,
                           Map<String,String> params)
                    throws IOException

执行HTTP GET请求。

参数:

url - 请求地址

params - 请求参数

返回:

响应字符串

抛出:

IOException

doGet

public static String doGet(String url,
                           Map<String,String> params,
                           String charset)
                    throws IOException

执行HTTP GET请求。

参数:

url - 请求地址

params - 请求参数

charset - 字符集，如UTF-8, GBK, GB2312

返回:

响应字符串

抛出:

IOException

getConnection

public static HttpURLConnection getConnection(URL url,
                                              String method,
                                              String ctype,
                                              Map<String,String> headers)
                                       throws IOException

抛出:

IOException

getConnection

public static HttpURLConnection getConnection(URL url,
                                              String method,
                                              String ctype,
                                              String proxyHost,
                                              int proxyPort,
                                              Map<String,String> headers)
                                       throws IOException

抛出:

IOException

buildQuery

public static String buildQuery(Map<String,String> params,
                                String charset)
                         throws IOException

抛出:

IOException

getResponseAsString

protected static String getResponseAsString(HttpURLConnection conn)
                                     throws IOException

抛出:

IOException

decode

public static String decode(String value)

使用默认的UTF-8字符集反编码请求参数值。

参数:

value - 参数值

返回:

反编码后的参数值

encode

public static String encode(String value)

使用默认的UTF-8字符集编码请求参数值。

参数:

value - 参数值

返回:

编码后的参数值

decode

public static String decode(String value,
                            String charset)

使用指定的字符集反编码请求参数值。

参数:

value - 参数值

charset - 字符集

返回:

反编码后的参数值

encode

public static String encode(String value,
                            String charset)

使用指定的字符集编码请求参数值。

参数:

value - 参数值

charset - 字符集

返回:

编码后的参数值

getParamsFromUrl

public static Map<String,String> getParamsFromUrl(String url)

splitUrlQuery

public static Map<String,String> splitUrlQuery(String query)

从URL中提取所有的参数。

参数:

query - URL地址

返回:

参数映射

buildForm

public static String buildForm(String baseUrl,
                               Map<String,String> parameters)