public class HttpRequest
extends java.lang.Object
HttpURLConnection(或子类)。
< p >
每个实例支持单个请求,不能重用
进一步的请求| Modifier and Type | Class and Description |
|---|---|
static class |
HttpRequest.Base64
从Base64表示法中编码和解码。
|
protected static class |
HttpRequest.CloseOperation<V>
确保的类以适当的异常关闭
处理。
|
static interface |
HttpRequest.ConnectionFactory
创建
URL。 |
protected static class |
HttpRequest.FlushOperation<V>
确保的类被正确地刷新
异常处理。
|
static class |
HttpRequest.HttpRequestException
HTTP请求异常,其原因始终是
|
protected static class |
HttpRequest.Operation<V>
处理执行回调的操作,一旦完成和处理
嵌套异常
|
static class |
HttpRequest.RequestOutputStream
请求输出流
|
static interface |
HttpRequest.UploadProgress
为请求报告上传进度的回调接口。
|
| Modifier and Type | Field and Description |
|---|---|
static java.lang.String |
CHARSET_UTF8
'UTF-8' 字符集名称
|
static java.lang.String |
CONTENT_TYPE_FORM
'application/x-www-form-urlencoded' 内容类型头值
|
static java.lang.String |
CONTENT_TYPE_JSON
'application/json' 内容类型头值
|
static java.lang.String |
ENCODING_GZIP
'gzip' 编码标头值
|
static java.lang.String |
HEADER_ACCEPT
'Accept' 标题名称
|
static java.lang.String |
HEADER_ACCEPT_CHARSET
'Accept-Charset' 标题名称
|
static java.lang.String |
HEADER_ACCEPT_ENCODING
'Accept-Encoding' 标题名称
|
static java.lang.String |
HEADER_AUTHORIZATION
'Authorization'标题名称
|
static java.lang.String |
HEADER_CACHE_CONTROL
'Cache-Control' 标题名称
|
static java.lang.String |
HEADER_CONTENT_ENCODING
'Content-Encoding' 标题名称
|
static java.lang.String |
HEADER_CONTENT_LENGTH
'Content-Length' 标题名称
|
static java.lang.String |
HEADER_CONTENT_TYPE
'Content-Type' 标题名称
|
static java.lang.String |
HEADER_DATE
'Date' 标题名称
|
static java.lang.String |
HEADER_ETAG
'ETag' 标题名称
|
static java.lang.String |
HEADER_EXPIRES
'Expires' 标题名称
|
static java.lang.String |
HEADER_IF_NONE_MATCH
'If-None-Match' 标题名称
|
static java.lang.String |
HEADER_LAST_MODIFIED
'Last-Modified' 标题名称
|
static java.lang.String |
HEADER_LOCATION
'Location' 标题名称
|
static java.lang.String |
HEADER_PROXY_AUTHORIZATION
'Proxy-Authorization' 标题名称
|
static java.lang.String |
HEADER_REFERER
'Referer' 标题名称
|
static java.lang.String |
HEADER_SERVER
'Server' 标题名称
|
static java.lang.String |
HEADER_USER_AGENT
'User-Agent'标题名称
|
static java.lang.String |
METHOD_DELETE
'DELETE' 请求方法
|
static java.lang.String |
METHOD_GET
'GET' 请求方法
|
static java.lang.String |
METHOD_HEAD
'HEAD' 请求方法
|
static java.lang.String |
METHOD_OPTIONS
'OPTIONS' 选项方法
|
static java.lang.String |
METHOD_POST
'POST' 请求方法
|
static java.lang.String |
METHOD_PUT
'PUT' 请求方法
|
static java.lang.String |
METHOD_TRACE
'TRACE' 请求方法
|
static java.lang.String |
PARAM_CHARSET
'charset' 头值参数
|
| Constructor and Description |
|---|
HttpRequest(java.lang.CharSequence url,
java.lang.String method)
创建HTTP连接包装
|
HttpRequest(java.net.URL url,
java.lang.String method)
创建HTTP连接包装
|
| Modifier and Type | Method and Description |
|---|---|
HttpRequest |
accept(java.lang.String accept)
将“Accept”标头设置为给定值
|
HttpRequest |
acceptCharset(java.lang.String acceptCharset)
将“accept - charset”标头设置为给定值
|
HttpRequest |
acceptEncoding(java.lang.String acceptEncoding)
设置'Accept-Encoding' 头为给定值
|
HttpRequest |
acceptGzipEncoding()
将“Accept-Encoding”头设置为“gzip”
Set the 'Accept-Encoding' header to 'gzip'
|
HttpRequest |
acceptJson()
将“Accept”头设置为“application/json”
|
static java.lang.String |
append(java.lang.CharSequence url,
java.util.Map<?,?> params)
将映射作为查询参数到基本URL
|
static java.lang.String |
append(java.lang.CharSequence url,
java.lang.Object... params)
将名称/值对作为查询参数到基本URL
|
HttpRequest |
authorization(java.lang.String authorization)
将“Authorization”头设置为给定值
|
boolean |
badRequest()
响应码是400个错误请求吗?
|
HttpRequest |
basic(java.lang.String name,
java.lang.String password)
将“Authorization”头设置为在基本身份验证中给定的值
格式
|
java.lang.String |
body()
使用返回的角色集作为获得响应从
charset() |
HttpRequest |
body(java.util.concurrent.atomic.AtomicReference<java.lang.String> output)
将响应主体作为,并将其设置为该值
给参考。
|
HttpRequest |
body(java.util.concurrent.atomic.AtomicReference<java.lang.String> output,
java.lang.String charset)
将响应主体作为,并将其设置为该值
给参考。
|
java.lang.String |
body(java.lang.String charset)
在给定的字符集中得到的响应
|
java.io.BufferedInputStream |
buffer()
在缓冲流中获得响应
|
java.io.BufferedReader |
bufferedReader()
使用从返回的字符集获得缓冲读取器到响应主体
charset()和配置的缓冲区大小 |
java.io.BufferedReader |
bufferedReader(java.lang.String charset)
使用给定的字符集r来获得缓冲读取器到响应主体
配置的缓冲区大小
|
int |
bufferSize()
获取配置的缓冲区大小
|
HttpRequest |
bufferSize(int size)
设置在流中缓冲和复制时使用的大小
|
byte[] |
bytes()
得到响应作为字节数组
|
protected java.io.ByteArrayOutputStream |
byteStream()
创建字节数组输出流
|
java.lang.String |
cacheControl()
从响应中获取“cache - control”头
|
java.lang.String |
charset()
从“content - type”响应头获取“charset”参数
|
HttpRequest |
chunk(int size)
将分块流模式设置为给定的大小
|
protected HttpRequest |
closeOutput()
Close output stream
关闭输出流
|
protected HttpRequest |
closeOutputQuietly()
调用并重新抛出一个捕获的
一个
|
int |
code()
获取响应的状态码
|
HttpRequest |
code(java.util.concurrent.atomic.AtomicInteger output)
将给定的的值设置为状态代码
response
|
HttpRequest |
connectTimeout(int timeout)
设置连接到给定值的连接超时
|
java.lang.String |
contentEncoding()
从响应中获取“Content-Encoding”头
|
int |
contentLength()
从响应中获取“content - length”头
Get the 'Content-Length' header from the response
|
HttpRequest |
contentLength(int contentLength)
将“Content-Length”请求头设置为给定值
|
HttpRequest |
contentLength(java.lang.String contentLength)
将“Content-Length”请求头设置为给定值
|
java.lang.String |
contentType()
从响应中获取“content - type”标题
|
HttpRequest |
contentType(java.lang.String contentType)
将“content - type”请求头设置为给定值
|
HttpRequest |
contentType(java.lang.String contentType,
java.lang.String charset)
将“content - type”请求头设置为给定值和charset
|
protected HttpRequest |
copy(java.io.InputStream input,
java.io.OutputStream output)
从输入流复制到输出流
|
protected HttpRequest |
copy(java.io.Reader input,
java.io.Writer output)
Copy from reader to writer
:把读取到信息复制到写入中
|
boolean |
created()
响应码是201 OK吗?
|
long |
date()
从响应中获取“Date”标题
|
long |
dateHeader(java.lang.String name)
从响应返回到返回- 1的日期头
头丢失或解析失败
|
long |
dateHeader(java.lang.String name,
long defaultValue)
从响应返回到返回给定的日期头
如果消息头丢失或解析失败,则默认值
|
static HttpRequest |
delete(java.lang.CharSequence url)
启动“删除”请求到给定的URL
|
static HttpRequest |
delete(java.lang.CharSequence baseUrl,
boolean encode,
java.lang.Object... params)
在给定URL和查询参数一起启动“删除”请求
|
static HttpRequest |
delete(java.lang.CharSequence baseUrl,
java.util.Map<?,?> params,
boolean encode)
在给定URL和查询参数一起启动“删除”请求
|
static HttpRequest |
delete(java.net.URL url)
启动“删除”请求到给定的URL
|
HttpRequest |
disconnect()
关闭连接
|
static java.lang.String |
encode(java.lang.CharSequence url)
将给定URL编码为ASCII
< p >
此方法确保URL的路径和查询段正确
编码的如“字符编码为% 20”或任何utf -8
非ascii的字符。默认情况下不需要对url进行编码
HttpRequest构造函数,如果需要URL编码
在调用构造函数之前,应该调用*方法。 |
java.lang.String |
eTag()
从响应中获取“ETag”头
|
long |
expires()
从响应中获取“Expires”标题
|
HttpRequest |
followRedirects(boolean followRedirects)
Set whether or not the underlying connection should follow redirects in
the response.
|
HttpRequest |
form(java.util.Map.Entry<?,?> entry)
Write the key and value in the entry as form data to the request body
:将输入中的键和值写入请求主体的表单数据
|
HttpRequest |
form(java.util.Map.Entry<?,?> entry,
java.lang.String charset)
Write the key and value in the entry as form data to the request body
:将输入中的键和值写入请求主体的表单数据
|
HttpRequest |
form(java.util.Map<?,?> values)
Write the values in the map as form data to the request body
:将映射中的值作为表单数据写入请求体
|
HttpRequest |
form(java.util.Map<?,?> values,
java.lang.String charset)
Write the values in the map as encoded form data to the request body
:将映射中的值作为编码的表单数据写入请求体
|
HttpRequest |
form(java.lang.Object name,
java.lang.Object value)
Write the name/value pair as form data to the request body
:将名称/值对作为表单数据写入请求体
|
HttpRequest |
form(java.lang.Object name,
java.lang.Object value,
java.lang.String charset)
Write the name/value pair as form data to the request body
:将名称/值对作为表单数据写入请求体
|
static HttpRequest |
get(java.lang.CharSequence url)
对给定的URL启动“GET”请求
|
static HttpRequest |
get(java.lang.CharSequence baseUrl,
boolean encode,
java.lang.Object... params)
在给定的URL和查询参数一起启动“GET”请求
|
static HttpRequest |
get(java.lang.CharSequence baseUrl,
java.util.Map<?,?> params,
boolean encode)
在给定的URL和查询参数一起启动“GET”请求
|
static HttpRequest |
get(java.net.URL url)
对给定的URL启动“GET”请求
|
java.net.HttpURLConnection |
getConnection()
得到潜在的连接
|
protected java.lang.String |
getParam(java.lang.String value,
java.lang.String paramName)
从标题值获取参数值
|
protected java.util.Map<java.lang.String,java.lang.String> |
getParams(java.lang.String header)
从标题值获取参数值
|
static HttpRequest |
head(java.lang.CharSequence url)
对给定的URL启动一个“HEAD”请求
|
static HttpRequest |
head(java.lang.CharSequence baseUrl,
boolean encode,
java.lang.Object... params)
在给定的URL和查询参数一起启动“GET”请求
|
static HttpRequest |
head(java.lang.CharSequence baseUrl,
java.util.Map<?,?> params,
boolean encode)
在给定URL和查询参数一起启动“HEAD”请求
|
static HttpRequest |
head(java.net.URL url)
对给定的URL启动一个“HEAD”请求
|
HttpRequest |
header(java.util.Map.Entry<java.lang.String,java.lang.String> header)
将输入的键作为名称和值作为值设置
|
java.lang.String |
header(java.lang.String name)
得到一个响应头
|
HttpRequest |
header(java.lang.String name,
java.lang.Number value)
将标题名称设置为给定值
|
HttpRequest |
header(java.lang.String name,
java.lang.String value)
将标题名称设置为给定值
|
java.util.Map<java.lang.String,java.util.List<java.lang.String>> |
headers()
获取所有响应头
|
HttpRequest |
headers(java.util.Map<java.lang.String,java.lang.String> headers)
在给定的映射中,设置标题的值,并在其中找到所有的标题
值是头值
|
java.lang.String[] |
headers(java.lang.String name)
从响应中获取给定标题的所有值
|
HttpRequest |
ifModifiedSince(long ifModifiedSince)
将“if - modified - since”请求头设置为给定值
|
HttpRequest |
ifNoneMatch(java.lang.String ifNoneMatch)
将“if - none - match”请求标头设置为给定值
|
boolean |
ignoreCloseExceptions()
获得抛出的异常是
被忽视的
|
HttpRequest |
ignoreCloseExceptions(boolean ignore)
设置是否忽略调用过程中发生的异常
Closeable.close() |
int |
intHeader(java.lang.String name)
从响应中得到一个整数头,如果是,则返回- 1
消息头丢失或解析失败
|
int |
intHeader(java.lang.String name,
int defaultValue)
从响应返回到给定的响应中,获得一个整数标题值
如果消息头丢失或解析失败,则默认值
|
boolean |
isBodyEmpty()
响应主体是空的吗?
|
static void |
keepAlive(boolean keepAlive)
设置http.keepAlive。将属性保存到给定值。
|
long |
lastModified()
从响应中获取“Last-Modified”标题
|
java.lang.String |
location()
从响应中获取“Location”标题
|
static void |
maxConnections(int maxConnections)
设置 'http.maxConnections' 将属性保存到给定值。
|
java.lang.String |
message()
获取响应的状态消息
|
java.lang.String |
method()
Get the HTTP method of this request
获取该请求的HTTP方法
|
boolean |
noContent()
响应码是204 OK吗?
|
static void |
nonProxyHosts(java.lang.String... hosts)
设置 'http.nonProxyHosts' 属性到给定的主机值。.
|
boolean |
notFound()
响应码是404没有找到的吗?
|
boolean |
notModified()
响应码是304没有修改吗?
|
boolean |
ok()
响应码是200 OK吗?
|
protected HttpRequest |
openOutput()
Open output stream
打开输出流
|
static HttpRequest |
options(java.lang.CharSequence url)
启动“选项”请求到给定的URL
|
static HttpRequest |
options(java.net.URL url)
启动“选项”请求到给定的URL
|
java.lang.String |
parameter(java.lang.String headerName,
java.lang.String paramName)
从响应头值中获取给定名称的参数
|
java.util.Map<java.lang.String,java.lang.String> |
parameters(java.lang.String headerName)
从报头值中获取所有参数
|
HttpRequest |
part(java.lang.String name,
java.io.File part)
Write part of a multipart request to the request body
将多个部分请求写入请求体
|
HttpRequest |
part(java.lang.String name,
java.io.InputStream part)
将多个部分请求写入请求体
|
HttpRequest |
part(java.lang.String name,
java.lang.Number part)
Write part of a multipart request to the request body
将多个部分请求写入请求体
|
HttpRequest |
part(java.lang.String name,
java.lang.String part)
将多个部分请求写入请求体
|
HttpRequest |
part(java.lang.String name,
java.lang.String filename,
java.io.File part)
Write part of a multipart request to the request body
将多个部分请求写入请求体
|
HttpRequest |
part(java.lang.String name,
java.lang.String filename,
java.lang.Number part)
Write part of a multipart request to the request body
将多个部分请求写入请求体
|
HttpRequest |
part(java.lang.String name,
java.lang.String filename,
java.lang.String part)
Write part of a multipart request to the request body
将多个部分请求写入请求体
|
HttpRequest |
part(java.lang.String name,
java.lang.String filename,
java.lang.String contentType,
java.io.File part)
Write part of a multipart request to the request body
将多个部分请求写入请求体
|
HttpRequest |
part(java.lang.String name,
java.lang.String filename,
java.lang.String contentType,
java.io.InputStream part)
Write part of a multipart request to the request body
将多个部分请求写入请求体
|
HttpRequest |
part(java.lang.String name,
java.lang.String filename,
java.lang.String contentType,
java.lang.String part)
Write part of a multipart request to the request body
将多个部分请求写入请求体
|
HttpRequest |
partHeader(java.lang.String name,
java.lang.String value)
Write a multipart header to the response body
将多个部分请求写入请求体
|
static HttpRequest |
post(java.lang.CharSequence url)
启动“POST”请求到给定的URL
|
static HttpRequest |
post(java.lang.CharSequence baseUrl,
boolean encode,
java.lang.Object... params)
在给定URL和查询参数一起启动“POST”请求
|
static HttpRequest |
post(java.lang.CharSequence baseUrl,
java.util.Map<?,?> params,
boolean encode)
在给定URL和查询参数一起启动“POST”请求
|
static HttpRequest |
post(java.net.URL url)
启动“POST”请求到给定的URL
|
HttpRequest |
progress(HttpRequest.UploadProgress callback)
Set the UploadProgress callback for this request
为此请求设置UploadProgress回调
|
HttpRequest |
proxyAuthorization(java.lang.String proxyAuthorization)
将“Proxy-Authorization”头设置为给定值
|
HttpRequest |
proxyBasic(java.lang.String name,
java.lang.String password)
将“Proxy-Authorization”头设置为在基本身份验证中给定的值
格式
|
static void |
proxyHost(java.lang.String host)
设置 'http.proxyHost' 和 'https.proxyHost' 属性到给定主机
value.
|
static void |
proxyPort(int port)
设置 'http.proxyPort' 和 'https.proxyPort' 属性到给定主机
number.
|
static HttpRequest |
put(java.lang.CharSequence url)
启动对给定URL的“PUT”请求
|
static HttpRequest |
put(java.lang.CharSequence baseUrl,
boolean encode,
java.lang.Object... params)
启动对给定URL的“PUT”请求,以及查询参数
|
static HttpRequest |
put(java.lang.CharSequence baseUrl,
java.util.Map<?,?> params,
boolean encode)
启动对给定URL的“PUT”请求,以及查询参数
|
static HttpRequest |
put(java.net.URL url)
启动对给定URL的“PUT”请求
|
java.io.InputStreamReader |
reader()
Get reader to response body using the character set returned from
charset() |
java.io.InputStreamReader |
reader(java.lang.String charset)
使用给定的字符集让读者响应正文。
|
HttpRequest |
readTimeout(int timeout)
设置读超时与给定值的连接
|
HttpRequest |
receive(java.lang.Appendable appendable)
接收对给定的可应用程序的响应
|
HttpRequest |
receive(java.io.File file)
流响应主体文件
|
HttpRequest |
receive(java.io.OutputStream output)
对给定输出流的流响应
|
HttpRequest |
receive(java.io.PrintStream output)
对给定的打印流的流响应
|
HttpRequest |
receive(java.io.Writer writer)
接收对给定写入器的响应
|
HttpRequest |
referer(java.lang.String referer)
将“Referer”头设置为给定值
|
HttpRequest |
send(byte[] input)
Write byte array to request body
写入字节数组以请求正文
|
HttpRequest |
send(java.lang.CharSequence value)
Write char sequence to request body:写入char序列以请求正文
|
HttpRequest |
send(java.io.File input)
Write contents of file to request body
将多个部分请求写入请求体
|
HttpRequest |
send(java.io.InputStream input)
Write stream to request body:写入流请求正文
|
HttpRequest |
send(java.io.Reader input)
Write reader to request body
读写请求体
|
java.lang.String |
server()
从响应中获取“Server”头
|
boolean |
serverError()
响应码是500个内部服务器错误吗?
|
static void |
setConnectionFactory(HttpRequest.ConnectionFactory connectionFactory)
指定用于创建新请求的。
|
protected HttpRequest |
startPart()
Start part of a multipart
开始多部分的一部分
|
java.io.InputStream |
stream()
获取流到响应主体
|
java.lang.String |
toString() |
static HttpRequest |
trace(java.lang.CharSequence url)
启动“跟踪”请求到给定的URL
|
static HttpRequest |
trace(java.net.URL url)
启动“跟踪”请求到给定的URL
|
HttpRequest |
trustAllCerts()
Configure HTTPS connection to trust all certificates
:配置HTTPS连接以信任所有证书
|
HttpRequest |
trustAllHosts()
Configure HTTPS connection to trust all hosts using a custom
HostnameVerifier that always returns true for each
host verified
:配置HTTPS连接以使用自定义信任所有主机
HostnameVerifier,它总是返回<代码> true for each
主机验证 |
HttpRequest |
uncompress(boolean uncompress)
设置响应主体是否应该自动解压读的时候。
|
java.net.URL |
url()
Get the
URL of this request's connection
:获取该请求连接的 |
HttpRequest |
useCaches(boolean useCaches)
设置值为
URLConnection.setUseCaches(boolean) |
HttpRequest |
useProxy(java.lang.String proxyHost,
int proxyPort)
Configure an HTTP proxy on this connection.
|
HttpRequest |
userAgent(java.lang.String userAgent)
将“User-Agent”头设置为给定值
|
protected HttpRequest |
writePartHeader(java.lang.String name,
java.lang.String filename)
Write part header
写标题部分
|
protected HttpRequest |
writePartHeader(java.lang.String name,
java.lang.String filename,
java.lang.String contentType)
Write part header
写标题部分
|
java.io.OutputStreamWriter |
writer()
Create writer to request output stream
:创建写入器请求输出流
|
public static final java.lang.String CHARSET_UTF8
public static final java.lang.String CONTENT_TYPE_FORM
public static final java.lang.String CONTENT_TYPE_JSON
public static final java.lang.String ENCODING_GZIP
public static final java.lang.String HEADER_ACCEPT
public static final java.lang.String HEADER_ACCEPT_CHARSET
public static final java.lang.String HEADER_ACCEPT_ENCODING
public static final java.lang.String HEADER_AUTHORIZATION
public static final java.lang.String HEADER_CACHE_CONTROL
public static final java.lang.String HEADER_CONTENT_ENCODING
public static final java.lang.String HEADER_CONTENT_LENGTH
public static final java.lang.String HEADER_CONTENT_TYPE
public static final java.lang.String HEADER_DATE
public static final java.lang.String HEADER_ETAG
public static final java.lang.String HEADER_EXPIRES
public static final java.lang.String HEADER_IF_NONE_MATCH
public static final java.lang.String HEADER_LAST_MODIFIED
public static final java.lang.String HEADER_LOCATION
public static final java.lang.String HEADER_PROXY_AUTHORIZATION
public static final java.lang.String HEADER_REFERER
public static final java.lang.String HEADER_SERVER
public static final java.lang.String HEADER_USER_AGENT
public static final java.lang.String METHOD_DELETE
public static final java.lang.String METHOD_GET
public static final java.lang.String METHOD_HEAD
public static final java.lang.String METHOD_OPTIONS
public static final java.lang.String METHOD_POST
public static final java.lang.String METHOD_PUT
public static final java.lang.String METHOD_TRACE
public static final java.lang.String PARAM_CHARSET
public HttpRequest(java.lang.CharSequence url,
java.lang.String method)
throws HttpRequest.HttpRequestException
url - 远程资源的URL。method - HTTP request method (e.g., "GET", "POST").HttpRequest.HttpRequestExceptionpublic HttpRequest(java.net.URL url,
java.lang.String method)
throws HttpRequest.HttpRequestException
url - 远程资源的URL。method - HTTP request method (e.g., "GET", "POST").HttpRequest.HttpRequestExceptionpublic static void setConnectionFactory(HttpRequest.ConnectionFactory connectionFactory)
public static java.lang.String encode(java.lang.CharSequence url)
throws HttpRequest.HttpRequestException
HttpRequest构造函数,如果需要URL编码
在调用构造函数之前,应该调用*方法。url - HttpRequest.HttpRequestExceptionpublic static java.lang.String append(java.lang.CharSequence url,
java.util.Map<?,?> params)
每个映射条目的键将是一个参数名和值 将是参数值。
url - params - public static java.lang.String append(java.lang.CharSequence url,
java.lang.Object... params)
params参数被解释为名称/值对序列,因此 给定的参数必须能被2整除。
url - params - 名称/值对public static HttpRequest get(java.lang.CharSequence url) throws HttpRequest.HttpRequestException
url - HttpRequest.HttpRequestExceptionpublic static HttpRequest get(java.net.URL url) throws HttpRequest.HttpRequestException
url - HttpRequest.HttpRequestExceptionpublic static HttpRequest get(java.lang.CharSequence baseUrl, java.util.Map<?,?> params, boolean encode)
baseUrl - params - 查询参数包括作为baseUrl的一部分encode - 正确编码完整的URLappend(CharSequence, Map),
encode(CharSequence)public static HttpRequest get(java.lang.CharSequence baseUrl, boolean encode, java.lang.Object... params)
baseUrl - encode - 正确编码完整的URLparams - 名称/值查询参数对包括作为一部分
baseUrlappend(CharSequence, Object...),
encode(CharSequence)public static HttpRequest post(java.lang.CharSequence url) throws HttpRequest.HttpRequestException
url - HttpRequest.HttpRequestExceptionpublic static HttpRequest post(java.net.URL url) throws HttpRequest.HttpRequestException
url - HttpRequest.HttpRequestExceptionpublic static HttpRequest post(java.lang.CharSequence baseUrl, java.util.Map<?,?> params, boolean encode)
baseUrl - params - 查询参数包括作为baseUrl的一部分encode - 正确编码完整的URLappend(CharSequence, Map),
encode(CharSequence)public static HttpRequest post(java.lang.CharSequence baseUrl, boolean encode, java.lang.Object... params)
baseUrl - encode - 正确编码完整的URLparams - 名称/值查询参数对包括作为一部分
baseUrlappend(CharSequence, Object...),
encode(CharSequence)public static HttpRequest put(java.lang.CharSequence url) throws HttpRequest.HttpRequestException
url - HttpRequest.HttpRequestExceptionpublic static HttpRequest put(java.net.URL url) throws HttpRequest.HttpRequestException
url - HttpRequest.HttpRequestExceptionpublic static HttpRequest put(java.lang.CharSequence baseUrl, java.util.Map<?,?> params, boolean encode)
baseUrl - params - 查询参数包括作为baseUrl的一部分encode - 正确编码完整的URLappend(CharSequence, Map),
encode(CharSequence)public static HttpRequest put(java.lang.CharSequence baseUrl, boolean encode, java.lang.Object... params)
baseUrl - encode - 正确编码完整的URLparams - 查询参数包括作为baseUrl的一部分
baseUrlappend(CharSequence, Object...),
encode(CharSequence)public static HttpRequest delete(java.lang.CharSequence url) throws HttpRequest.HttpRequestException
url - HttpRequest.HttpRequestExceptionpublic static HttpRequest delete(java.net.URL url) throws HttpRequest.HttpRequestException
url - HttpRequest.HttpRequestExceptionpublic static HttpRequest delete(java.lang.CharSequence baseUrl, java.util.Map<?,?> params, boolean encode)
baseUrl - params - 查询参数包括作为baseUrl的一部分encode - 正确的编码完整的urlappend(CharSequence, Map),
encode(CharSequence)public static HttpRequest delete(java.lang.CharSequence baseUrl, boolean encode, java.lang.Object... params)
baseUrl - encode - 正确的编码完整的urlparams - 名称/值查询参数对包括作为一部分
baseUrlappend(CharSequence, Object...),
encode(CharSequence)public static HttpRequest head(java.lang.CharSequence url) throws HttpRequest.HttpRequestException
url - HttpRequest.HttpRequestExceptionpublic static HttpRequest head(java.net.URL url) throws HttpRequest.HttpRequestException
url - HttpRequest.HttpRequestExceptionpublic static HttpRequest head(java.lang.CharSequence baseUrl, java.util.Map<?,?> params, boolean encode)
baseUrl - params - 查询参数包括作为baseUrl的一部分encode - 正确编码完整的URLappend(CharSequence, Map),
encode(CharSequence)public static HttpRequest head(java.lang.CharSequence baseUrl, boolean encode, java.lang.Object... params)
baseUrl - encode - 正确编码完整的urlparams - 名称/值查询参数对包括作为一部分
baseUrlappend(CharSequence, Object...),
encode(CharSequence)public static HttpRequest options(java.lang.CharSequence url) throws HttpRequest.HttpRequestException
url - HttpRequest.HttpRequestExceptionpublic static HttpRequest options(java.net.URL url) throws HttpRequest.HttpRequestException
url - HttpRequest.HttpRequestExceptionpublic static HttpRequest trace(java.lang.CharSequence url) throws HttpRequest.HttpRequestException
url - HttpRequest.HttpRequestExceptionpublic static HttpRequest trace(java.net.URL url) throws HttpRequest.HttpRequestException
url - HttpRequest.HttpRequestExceptionpublic static void keepAlive(boolean keepAlive)
此设置将适用于所有请求。
keepAlive - public static void maxConnections(int maxConnections)
此设置将适用于所有请求.
maxConnections - public static void proxyHost(java.lang.String host)
此设置将适用于所有请求.
host - public static void proxyPort(int port)
此设置将适用于所有请求.
port - public static void nonProxyHosts(java.lang.String... hosts)
主机将被一个“|”字符隔开。
此设置将适用于所有请求
hosts - public java.lang.String toString()
toString in class java.lang.Objectpublic java.net.HttpURLConnection getConnection()
public HttpRequest ignoreCloseExceptions(boolean ignore)
Closeable.close()
这个设置的默认值是< code>true
ignore - public boolean ignoreCloseExceptions()
public int code()
throws HttpRequest.HttpRequestException
HttpRequest.HttpRequestExceptionpublic HttpRequest code(java.util.concurrent.atomic.AtomicInteger output) throws HttpRequest.HttpRequestException
output - HttpRequest.HttpRequestExceptionpublic boolean ok()
throws HttpRequest.HttpRequestException
HttpRequest.HttpRequestExceptionpublic boolean created()
throws HttpRequest.HttpRequestException
HttpRequest.HttpRequestExceptionpublic boolean noContent()
throws HttpRequest.HttpRequestException
HttpRequest.HttpRequestExceptionpublic boolean serverError()
throws HttpRequest.HttpRequestException
HttpRequest.HttpRequestExceptionpublic boolean badRequest()
throws HttpRequest.HttpRequestException
HttpRequest.HttpRequestExceptionpublic boolean notFound()
throws HttpRequest.HttpRequestException
HttpRequest.HttpRequestExceptionpublic boolean notModified()
throws HttpRequest.HttpRequestException
HttpRequest.HttpRequestExceptionpublic java.lang.String message()
throws HttpRequest.HttpRequestException
HttpRequest.HttpRequestExceptionpublic HttpRequest disconnect()
public HttpRequest chunk(int size)
size - public HttpRequest bufferSize(int size)
这个大小也用于发送和接收为两个char创建的缓冲区 和字节数组
默认的缓冲区大小是8192个字节
size - public int bufferSize()
默认的缓冲区大小是8192个字节
public HttpRequest uncompress(boolean uncompress)
这只会影响有“'Content-Encoding”响应的请求 头设置为“gzip”
这导致所有接收方法都使用 可适用于更高级别的流和读取器读取数据 未压缩的。.
设置此选项不会导致设置任何请求头
自动so acceptGzipEncoding()应该被使用
与此设置一起告诉服务器gzip响应。
uncompress - protected java.io.ByteArrayOutputStream byteStream()
public java.lang.String body(java.lang.String charset)
throws HttpRequest.HttpRequestException
如果给定的字符集,将使用utf - 8字符集返回 为空
charset - HttpRequest.HttpRequestExceptionpublic java.lang.String body()
throws HttpRequest.HttpRequestException
charset()HttpRequest.HttpRequestExceptionpublic HttpRequest body(java.util.concurrent.atomic.AtomicReference<java.lang.String> output) throws HttpRequest.HttpRequestException
output - HttpRequest.HttpRequestExceptionpublic HttpRequest body(java.util.concurrent.atomic.AtomicReference<java.lang.String> output, java.lang.String charset) throws HttpRequest.HttpRequestException
output - charset - HttpRequest.HttpRequestExceptionpublic boolean isBodyEmpty()
throws HttpRequest.HttpRequestException
HttpRequest.HttpRequestExceptionpublic byte[] bytes()
throws HttpRequest.HttpRequestException
HttpRequest.HttpRequestExceptionpublic java.io.BufferedInputStream buffer()
throws HttpRequest.HttpRequestException
HttpRequest.HttpRequestExceptionbufferSize(int)public java.io.InputStream stream()
throws HttpRequest.HttpRequestException
HttpRequest.HttpRequestExceptionpublic java.io.InputStreamReader reader(java.lang.String charset)
throws HttpRequest.HttpRequestException
如果给定的字符集,将使用utf - 8字符集返回 为空
charset - HttpRequest.HttpRequestExceptionpublic java.io.InputStreamReader reader()
throws HttpRequest.HttpRequestException
charset()HttpRequest.HttpRequestExceptionpublic java.io.BufferedReader bufferedReader(java.lang.String charset)
throws HttpRequest.HttpRequestException
charset - HttpRequest.HttpRequestExceptionbufferSize(int)public java.io.BufferedReader bufferedReader()
throws HttpRequest.HttpRequestException
charset()和配置的缓冲区大小HttpRequest.HttpRequestExceptionbufferSize(int)public HttpRequest receive(java.io.File file) throws HttpRequest.HttpRequestException
file - HttpRequest.HttpRequestExceptionpublic HttpRequest receive(java.io.OutputStream output) throws HttpRequest.HttpRequestException
output - HttpRequest.HttpRequestExceptionpublic HttpRequest receive(java.io.PrintStream output) throws HttpRequest.HttpRequestException
output - HttpRequest.HttpRequestExceptionpublic HttpRequest receive(java.lang.Appendable appendable) throws HttpRequest.HttpRequestException
appendable - HttpRequest.HttpRequestExceptionpublic HttpRequest receive(java.io.Writer writer) throws HttpRequest.HttpRequestException
writer - HttpRequest.HttpRequestExceptionpublic HttpRequest readTimeout(int timeout)
timeout - public HttpRequest connectTimeout(int timeout)
timeout - public HttpRequest header(java.lang.String name, java.lang.String value)
name - value - public HttpRequest header(java.lang.String name, java.lang.Number value)
name - value - public HttpRequest headers(java.util.Map<java.lang.String,java.lang.String> headers)
headers - public HttpRequest header(java.util.Map.Entry<java.lang.String,java.lang.String> header)
header - public java.lang.String header(java.lang.String name)
throws HttpRequest.HttpRequestException
name - HttpRequest.HttpRequestExceptionpublic java.util.Map<java.lang.String,java.util.List<java.lang.String>> headers()
throws HttpRequest.HttpRequestException
HttpRequest.HttpRequestExceptionpublic long dateHeader(java.lang.String name)
throws HttpRequest.HttpRequestException
name - HttpRequest.HttpRequestExceptionpublic long dateHeader(java.lang.String name,
long defaultValue)
throws HttpRequest.HttpRequestException
name - defaultValue - HttpRequest.HttpRequestExceptionpublic int intHeader(java.lang.String name)
throws HttpRequest.HttpRequestException
name - HttpRequest.HttpRequestExceptionpublic int intHeader(java.lang.String name,
int defaultValue)
throws HttpRequest.HttpRequestException
name - defaultValue - HttpRequest.HttpRequestExceptionpublic java.lang.String[] headers(java.lang.String name)
name - String header valuespublic java.lang.String parameter(java.lang.String headerName,
java.lang.String paramName)
headerName - paramName - public java.util.Map<java.lang.String,java.lang.String> parameters(java.lang.String headerName)
This will be all key=value pairs after the first ';' that are separated by a ';'
headerName - protected java.util.Map<java.lang.String,java.lang.String> getParams(java.lang.String header)
header - protected java.lang.String getParam(java.lang.String value,
java.lang.String paramName)
value - paramName - public java.lang.String charset()
public HttpRequest userAgent(java.lang.String userAgent)
userAgent - public HttpRequest referer(java.lang.String referer)
referer - public HttpRequest useCaches(boolean useCaches)
URLConnection.setUseCaches(boolean)useCaches - public HttpRequest acceptEncoding(java.lang.String acceptEncoding)
acceptEncoding - public HttpRequest acceptGzipEncoding()
uncompress(boolean)public HttpRequest acceptCharset(java.lang.String acceptCharset)
acceptCharset - public java.lang.String contentEncoding()
public java.lang.String server()
public long date()
public java.lang.String cacheControl()
public java.lang.String eTag()
public long expires()
public long lastModified()
public java.lang.String location()
public HttpRequest authorization(java.lang.String authorization)
authorization - public HttpRequest proxyAuthorization(java.lang.String proxyAuthorization)
proxyAuthorization - public HttpRequest basic(java.lang.String name, java.lang.String password)
name - password - public HttpRequest proxyBasic(java.lang.String name, java.lang.String password)
name - password - public HttpRequest ifModifiedSince(long ifModifiedSince)
ifModifiedSince - public HttpRequest ifNoneMatch(java.lang.String ifNoneMatch)
ifNoneMatch - public HttpRequest contentType(java.lang.String contentType)
contentType - public HttpRequest contentType(java.lang.String contentType, java.lang.String charset)
contentType - charset - public java.lang.String contentType()
public int contentLength()
public HttpRequest contentLength(java.lang.String contentLength)
contentLength - public HttpRequest contentLength(int contentLength)
contentLength - public HttpRequest accept(java.lang.String accept)
accept - public HttpRequest acceptJson()
protected HttpRequest copy(java.io.InputStream input, java.io.OutputStream output) throws java.io.IOException
input - output - java.io.IOExceptionprotected HttpRequest copy(java.io.Reader input, java.io.Writer output) throws java.io.IOException
input - output - java.io.IOExceptionpublic HttpRequest progress(HttpRequest.UploadProgress callback)
callback - protected HttpRequest closeOutput() throws java.io.IOException
HttpRequest.HttpRequestExceptionjava.io.IOExceptionprotected HttpRequest closeOutputQuietly() throws HttpRequest.HttpRequestException
HttpRequest.HttpRequestExceptionprotected HttpRequest openOutput() throws java.io.IOException
java.io.IOExceptionprotected HttpRequest startPart() throws java.io.IOException
java.io.IOExceptionprotected HttpRequest writePartHeader(java.lang.String name, java.lang.String filename) throws java.io.IOException
name - filename - java.io.IOExceptionprotected HttpRequest writePartHeader(java.lang.String name, java.lang.String filename, java.lang.String contentType) throws java.io.IOException
name - filename - contentType - java.io.IOExceptionpublic HttpRequest part(java.lang.String name, java.lang.String part)
name - part - public HttpRequest part(java.lang.String name, java.lang.String filename, java.lang.String part) throws HttpRequest.HttpRequestException
name - filename - part - HttpRequest.HttpRequestExceptionpublic HttpRequest part(java.lang.String name, java.lang.String filename, java.lang.String contentType, java.lang.String part) throws HttpRequest.HttpRequestException
name - filename - contentType - value of the Content-Type part header :Content-Type部件头的值part - HttpRequest.HttpRequestExceptionpublic HttpRequest part(java.lang.String name, java.lang.Number part) throws HttpRequest.HttpRequestException
name - part - HttpRequest.HttpRequestExceptionpublic HttpRequest part(java.lang.String name, java.lang.String filename, java.lang.Number part) throws HttpRequest.HttpRequestException
name - filename - part - HttpRequest.HttpRequestExceptionpublic HttpRequest part(java.lang.String name, java.io.File part) throws HttpRequest.HttpRequestException
name - part - HttpRequest.HttpRequestExceptionpublic HttpRequest part(java.lang.String name, java.lang.String filename, java.io.File part) throws HttpRequest.HttpRequestException
name - filename - part - HttpRequest.HttpRequestExceptionpublic HttpRequest part(java.lang.String name, java.lang.String filename, java.lang.String contentType, java.io.File part) throws HttpRequest.HttpRequestException
name - filename - contentType - value of the Content-Type part header :Content-Type部件头的值part - HttpRequest.HttpRequestExceptionpublic HttpRequest part(java.lang.String name, java.io.InputStream part) throws HttpRequest.HttpRequestException
name - part - HttpRequest.HttpRequestExceptionpublic HttpRequest part(java.lang.String name, java.lang.String filename, java.lang.String contentType, java.io.InputStream part) throws HttpRequest.HttpRequestException
name - filename - contentType - value of the Content-Type part header:Content-Type部件头的值part - HttpRequest.HttpRequestExceptionpublic HttpRequest partHeader(java.lang.String name, java.lang.String value) throws HttpRequest.HttpRequestException
name - value - HttpRequest.HttpRequestExceptionpublic HttpRequest send(java.io.File input) throws HttpRequest.HttpRequestException
input - HttpRequest.HttpRequestExceptionpublic HttpRequest send(byte[] input) throws HttpRequest.HttpRequestException
input - HttpRequest.HttpRequestExceptionpublic HttpRequest send(java.io.InputStream input) throws HttpRequest.HttpRequestException
The given stream will be closed once sending completes :一旦发送完成,给定的流将被关闭
input - HttpRequest.HttpRequestExceptionpublic HttpRequest send(java.io.Reader input) throws HttpRequest.HttpRequestException
The given reader will be closed once sending completes :一旦发送完成,给定的阅读器将被关闭
input - HttpRequest.HttpRequestExceptionpublic HttpRequest send(java.lang.CharSequence value) throws HttpRequest.HttpRequestException
The charset configured via contentType(String) will be used and
UTF-8 will be used if it is unset.
:通过配置的charset将被使用,如果未设置,将使用utf - 8。
value - HttpRequest.HttpRequestExceptionpublic java.io.OutputStreamWriter writer()
throws HttpRequest.HttpRequestException
HttpRequest.HttpRequestExceptionpublic HttpRequest form(java.util.Map<?,?> values) throws HttpRequest.HttpRequestException
The pairs specified will be URL-encoded in UTF-8 and sent with the 'application/x-www-form-urlencoded' content-type :指定的成对将用utf - 8编码,并与之一起发送 “application/ x-www-form-urlencoded”内容类型
values - HttpRequest.HttpRequestExceptionpublic HttpRequest form(java.util.Map.Entry<?,?> entry) throws HttpRequest.HttpRequestException
The pair specified will be URL-encoded in UTF-8 and sent with the 'application/x-www-form-urlencoded' content-type :指定的组合将用utf - 8编码,并与之一起发送 “application/ x-www-form-urlencoded”内容类型
entry - HttpRequest.HttpRequestExceptionpublic HttpRequest form(java.util.Map.Entry<?,?> entry, java.lang.String charset) throws HttpRequest.HttpRequestException
The pair specified will be URL-encoded and sent with the 'application/x-www-form-urlencoded' content-type :指定的这对将被url编码并发送 “application/ x-www-form-urlencoded”内容类型
entry - charset - HttpRequest.HttpRequestExceptionpublic HttpRequest form(java.lang.Object name, java.lang.Object value) throws HttpRequest.HttpRequestException
The pair specified will be URL-encoded in UTF-8 and sent with the 'application/x-www-form-urlencoded' content-type :指定的组合将用utf - 8编码,并与之一起发送 “application/ x-www-form-urlencoded”内容类型
name - value - HttpRequest.HttpRequestExceptionpublic HttpRequest form(java.lang.Object name, java.lang.Object value, java.lang.String charset) throws HttpRequest.HttpRequestException
The values specified will be URL-encoded and sent with the 'application/x-www-form-urlencoded' content-type :指定的值将被url编码并发送 “应用程序/ x-www-form-urlencoded”内容类型
name - value - charset - HttpRequest.HttpRequestExceptionpublic HttpRequest form(java.util.Map<?,?> values, java.lang.String charset) throws HttpRequest.HttpRequestException
values - charset - HttpRequest.HttpRequestExceptionpublic HttpRequest trustAllCerts() throws HttpRequest.HttpRequestException
This method does nothing if the current request is not a HTTPS request :如果当前请求不是HTTPS请求,则该方法不会执行任何操作
HttpRequest.HttpRequestExceptionpublic HttpRequest trustAllHosts()
HostnameVerifier that always returns true for each
host verified
:配置HTTPS连接以使用自定义信任所有主机
HostnameVerifier,它总是返回<代码> true for each
主机验证
This method does nothing if the current request is not a HTTPS request :如果当前请求不是HTTPS请求,则该方法不会执行任何操作
public java.net.URL url()
URL of this request's connection
:获取该请求连接的public java.lang.String method()
public HttpRequest useProxy(java.lang.String proxyHost, int proxyPort)
proxyBasic(String, String) if
this proxy requires basic authentication.
:在此连接上配置一个HTTP代理。使用{
此代理需要基本身份验证。proxyHost - proxyPort - public HttpRequest followRedirects(boolean followRedirects)
followRedirects - - true fo follow redirects, false to not.