|
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Objectcom.github.kevinsawicki.http.HttpRequest
public class HttpRequest
A fluid interface for making HTTP requests using an underlying
HttpURLConnection
(or sub-class).
Each instance supports making a single request and cannot be reused for further requests.
Nested Class Summary | |
---|---|
static class |
HttpRequest.Base64
Encodes and decodes to and from Base64 notation. |
protected static class |
HttpRequest.CloseOperation<V>
Class that ensures a Closeable gets closed with proper exception
handling. |
protected static class |
HttpRequest.FlushOperation<V>
Class that and ensures a Flushable gets flushed with proper
exception handling. |
static class |
HttpRequest.HttpRequestException
HTTP request exception whose cause is always an IOException |
protected static class |
HttpRequest.Operation<V>
Operation that handles executing a callback once complete and handling nested exceptions |
static class |
HttpRequest.RequestOutputStream
Request output stream |
Field Summary | |
---|---|
static String |
CHARSET_UTF8
'UTF-8' charset name |
static String |
HEADER_ACCEPT
'Accept' header name |
static String |
HEADER_ACCEPT_CHARSET
'Accept-Charset' header name |
static String |
HEADER_ACCEPT_ENCODING
'Accept-Encoding' header name |
static String |
HEADER_AUTHORIZATION
'Authorization' header name |
static String |
HEADER_CACHE_CONTROL
'Cache-Control' header name |
static String |
HEADER_CONTENT_ENCODING
'Content-Encoding' header name |
static String |
HEADER_CONTENT_LENGTH
'Content-Length' header name |
static String |
HEADER_CONTENT_TYPE
'Content-Type' header name |
static String |
HEADER_DATE
'Date' header name |
static String |
HEADER_ETAG
'ETag' header name |
static String |
HEADER_EXPIRES
'Expires' header name |
static String |
HEADER_IF_NONE_MATCH
'If-None-Match' header name |
static String |
HEADER_LAST_MODIFIED
'Last-Modified' header name |
static String |
HEADER_LOCATION
'Location' header name |
static String |
HEADER_SERVER
'Server' header name |
static String |
HEADER_USER_AGENT
'User-Agent' header name |
static String |
METHOD_DELETE
'DELETE' request method |
static String |
METHOD_GET
'GET' request method |
static String |
METHOD_HEAD
'HEAD' request method |
static String |
METHOD_OPTIONS
'OPTIONS' options method |
static String |
METHOD_POST
'POST' request method |
static String |
METHOD_PUT
'PUT' request method |
static String |
METHOD_TRACE
'TRACE' request method |
static String |
PARAM_CHARSET
'charset' header value parameter |
Constructor Summary | |
---|---|
HttpRequest(CharSequence url,
String method)
Create HTTP connection wrapper |
|
HttpRequest(URL url,
String method)
Create HTTP connection wrapper |
Method Summary | |
---|---|
HttpRequest |
accept(String value)
Set the 'Accept' header to given value |
HttpRequest |
acceptCharset(String value)
Set the 'Accept-Charset' header to given value |
HttpRequest |
acceptEncoding(String value)
Set the 'Accept-Encoding' header to given value |
HttpRequest |
acceptGzipEncoding()
Set the 'Accept-Encoding' header to 'gzip' |
HttpRequest |
acceptJson()
Set the 'Accept' header to 'application/json' |
static String |
append(CharSequence url,
Map<?,?> params)
Append given map as query parameters to the base URL |
static String |
append(CharSequence url,
String... params)
Append given name/value pairs as query parameters to the base URL |
HttpRequest |
authorization(String value)
Set the 'Authorization' header to given value |
boolean |
badRequest()
Is the response code a 400 Bad Request? |
HttpRequest |
basic(String name,
String password)
Set the 'Authorization' header to given values in Basic authentication format |
String |
body()
Get response as String using character set returned from
charset() |
String |
body(String charset)
Get response as String in given character set |
BufferedInputStream |
buffer()
Get response in a buffered stream |
BufferedReader |
bufferedReader()
Get buffered reader to response body using the character set returned from charset() and the configured buffer size |
BufferedReader |
bufferedReader(String charset)
Get buffered reader to response body using the given character set r and the configured buffer size |
int |
bufferSize()
Get the configured buffer size |
HttpRequest |
bufferSize(int size)
Set the size used when buffering and copying between streams |
byte[] |
bytes()
Get response as byte array |
protected ByteArrayOutputStream |
byteStream()
Create byte array output stream |
String |
cacheControl()
Get the 'Cache-Control' header from the response |
String |
charset()
Get 'charset' parameter from 'Content-Type' response header |
HttpRequest |
chunk(int size)
Set chunked streaming mode to the given size |
protected HttpRequest |
closeOutput()
Close output stream |
protected HttpRequest |
closeOutputQuietly()
Call closeOutput() and re-throw a caught IOException s as
an HttpRequest.HttpRequestException |
int |
code()
Get the status code of the response |
HttpRequest |
code(AtomicInteger output)
Set the value of the given AtomicInteger to the status code of the
response |
HttpRequest |
connectTimeout(int timeout)
Set connect timeout on connection to given value |
String |
contentEncoding()
Get the 'Content-Encoding' header from the response |
int |
contentLength()
Get the 'Content-Type' header from the response |
HttpRequest |
contentLength(int value)
Set the 'Content-Length' request header to the given value |
HttpRequest |
contentLength(String value)
Set the 'Content-Length' request header to the given value |
String |
contentType()
Get the 'Content-Type' header from the response |
HttpRequest |
contentType(String value)
Set the 'Content-Type' request header to the given value |
HttpRequest |
contentType(String value,
String charset)
Set the 'Content-Type' request header to the given value and charset |
protected HttpRequest |
copy(InputStream input,
OutputStream output)
Copy from input stream to output stream |
protected HttpRequest |
copy(Reader input,
Writer output)
Copy from reader to writer |
boolean |
created()
Is the response code a 201 Created? |
long |
date()
Get the 'Date' header from the response |
long |
dateHeader(String name)
Get a date header from the response falling back to returning -1 if the header is missing or parsing fails |
long |
dateHeader(String name,
long defaultValue)
Get a date header from the response falling back to returning the given default value if the header is missing or parsing fails |
static HttpRequest |
delete(CharSequence url)
Start a 'DELETE' request to the given URL |
static HttpRequest |
delete(CharSequence baseUrl,
boolean encode,
String... params)
Start a 'DELETE' request to the given URL along with the query params |
static HttpRequest |
delete(CharSequence baseUrl,
Map<?,?> params,
boolean encode)
Start a 'DELETE' request to the given URL along with the query params |
static HttpRequest |
delete(URL url)
Start a 'DELETE' request to the given URL |
HttpRequest |
disconnect()
Disconnect the connection |
static String |
encode(CharSequence url)
Encode the given URL as an ASCII String |
String |
eTag()
Get the 'ETag' header from the response |
long |
expires()
Get the 'Expires' header from the response |
HttpRequest |
form(Map.Entry<?,?> entry)
Write the key and value in the entry as form data to the request body |
HttpRequest |
form(Map.Entry<?,?> entry,
String charset)
Write the key and value in the entry as form data to the request body |
HttpRequest |
form(Map<?,?> values)
Write the values in the map as form data to the request body |
HttpRequest |
form(Map<?,?> values,
String charset)
Write the values in the map as encoded form data to the request body |
HttpRequest |
form(Object name,
Object value)
Write the name/value pair as form data to the request body |
HttpRequest |
form(Object name,
Object value,
String charset)
Write the name/value pair as form data to the request body |
static HttpRequest |
get(CharSequence url)
Start a 'GET' request to the given URL |
static HttpRequest |
get(CharSequence baseUrl,
boolean encode,
String... params)
Start a 'GET' request to the given URL along with the query params |
static HttpRequest |
get(CharSequence baseUrl,
Map<?,?> params,
boolean encode)
Start a 'GET' request to the given URL along with the query params |
static HttpRequest |
get(URL url)
Start a 'GET' request to the given URL |
HttpURLConnection |
getConnection()
Get underlying connection |
protected String |
getParam(String value,
String paramName)
Get parameter value from header value |
protected Map<String,String> |
getParams(String header)
Get parameter values from header value |
static HttpRequest |
head(CharSequence url)
Start a 'HEAD' request to the given URL |
static HttpRequest |
head(CharSequence baseUrl,
boolean encode,
String... params)
Start a 'GET' request to the given URL along with the query params |
static HttpRequest |
head(CharSequence baseUrl,
Map<?,?> params,
boolean encode)
Start a 'HEAD' request to the given URL along with the query params |
static HttpRequest |
head(URL url)
Start a 'HEAD' request to the given URL |
HttpRequest |
header(Map.Entry<String,String> header)
Set header to have given entry's key as the name and value as the value |
String |
header(String name)
Get a response header |
HttpRequest |
header(String name,
Number value)
Set header name to given value |
HttpRequest |
header(String name,
String value)
Set header name to given value |
Map<String,List<String>> |
headers()
Get all the response headers |
HttpRequest |
headers(Map<String,String> headers)
Set all headers found in given map where the keys are the header names and the values are the header values |
String[] |
headers(String name)
Get all values of the given header from the response |
HttpRequest |
ifModifiedSince(long value)
Set the 'If-Modified-Since' request header to the given value |
HttpRequest |
ifNoneMatch(String value)
Set the 'If-None-Match' request header to the given value |
boolean |
ignoreCloseExceptions()
Get whether or not exceptions thrown by Closeable.close() are
ignored |
HttpRequest |
ignoreCloseExceptions(boolean ignore)
Set whether or not to ignore exceptions that occur from calling Closeable.close() |
int |
intHeader(String name)
Get an integer header from the response falling back to returning -1 if the header is missing or parsing fails |
int |
intHeader(String name,
int defaultValue)
Get an integer header value from the response falling back to the given default value if the header is missing or if parsing fails |
static void |
keepAlive(boolean keepAlive)
Set the 'http.keepAlive' property to the given value. |
long |
lastModified()
Get the 'Last-Modified' header from the response |
String |
location()
Get the 'Location' header from the response |
String |
message()
Get status message of the response |
static void |
nonProxyHosts(String... hosts)
Set the 'http.nonProxyHosts' properties to the given host values. |
boolean |
notFound()
Is the response code a 404 Not Found? |
boolean |
notModified()
Is the response code a 304 Not Modified? |
boolean |
ok()
Is the response code a 200 OK? |
protected HttpRequest |
openOutput()
Open output stream |
static HttpRequest |
options(CharSequence url)
Start an 'OPTIONS' request to the given URL |
static HttpRequest |
options(URL url)
Start an 'OPTIONS' request to the given URL |
String |
parameter(String headerName,
String paramName)
Get parameter with given name from header value in response |
Map<String,String> |
parameters(String headerName)
Get all parameters from header value in response |
HttpRequest |
part(String name,
File part)
Write part of a multipart request to the request body |
HttpRequest |
part(String name,
InputStream part)
Write part of a multipart request to the request body |
HttpRequest |
part(String name,
Number part)
Write part of a multipart request to the request body |
HttpRequest |
part(String name,
String part)
Write part of a multipart request to the request body |
HttpRequest |
part(String name,
String filename,
File part)
Write part of a multipart request to the request body |
HttpRequest |
part(String name,
String filename,
InputStream part)
Write part of a multipart request to the request body |
HttpRequest |
part(String name,
String filename,
Number part)
Write part of a multipart request to the request body |
HttpRequest |
part(String name,
String filename,
String part)
Write part of a multipart request to the request body |
HttpRequest |
partHeader(String name,
String value)
Write a multipart header to the response body |
static HttpRequest |
post(CharSequence url)
Start a 'POST' request to the given URL |
static HttpRequest |
post(CharSequence baseUrl,
boolean encode,
String... params)
Start a 'POST' request to the given URL along with the query params |
static HttpRequest |
post(CharSequence baseUrl,
Map<?,?> params,
boolean encode)
Start a 'POST' request to the given URL along with the query params |
static HttpRequest |
post(URL url)
Start a 'POST' request to the given URL |
static void |
proxyHost(String host)
Set the 'http.proxyHost' & 'https.proxyHost' properties to the given host value. |
static void |
proxyPort(int port)
Set the 'http.proxyPort' & 'https.proxyPort' properties to the given port number. |
static HttpRequest |
put(CharSequence url)
Start a 'PUT' request to the given URL |
static HttpRequest |
put(CharSequence baseUrl,
boolean encode,
String... params)
Start a 'PUT' request to the given URL along with the query params |
static HttpRequest |
put(CharSequence baseUrl,
Map<?,?> params,
boolean encode)
Start a 'PUT' request to the given URL along with the query params |
static HttpRequest |
put(URL url)
Start a 'PUT' request to the given URL |
InputStreamReader |
reader()
Get reader to response body using the character set returned from charset() |
InputStreamReader |
reader(String charset)
Get reader to response body using given character set. |
HttpRequest |
readTimeout(int timeout)
Set read timeout on connection to given value |
HttpRequest |
receive(Appendable appendable)
Receive response into the given appendable |
HttpRequest |
receive(File file)
Stream response body to file |
HttpRequest |
receive(OutputStream output)
Stream response to given output stream |
HttpRequest |
receive(PrintStream output)
Stream response to given print stream |
HttpRequest |
receive(Writer writer)
Receive response into the given writer |
HttpRequest |
send(byte[] input)
Write byte array to request body |
HttpRequest |
send(CharSequence value)
Write char sequence to request body |
HttpRequest |
send(File input)
Write contents of file to request body |
HttpRequest |
send(InputStream input)
Write stream to request body |
HttpRequest |
send(Reader input)
Write reader to request body |
String |
server()
Get the 'Server' header from the response |
boolean |
serverError()
Is the response code a 500 Internal Server Error? |
protected HttpRequest |
startPart()
Start part of a multipart |
InputStream |
stream()
Get stream to response body |
String |
toString()
|
static HttpRequest |
trace(CharSequence url)
Start a 'TRACE' request to the given URL |
static HttpRequest |
trace(URL url)
Start a 'TRACE' request to the given URL |
HttpRequest |
trustAllCerts()
Configure HTTPS connection to trust all certificates |
HttpRequest |
trustAllHosts()
Configure HTTPS connection to trust all hosts using a custom HostnameVerifier that always returns true for each
host verified |
HttpRequest |
uncompress(boolean uncompress)
Set whether or not the response body should be automatically uncompressed when read from. |
HttpRequest |
useCaches(boolean useCaches)
Set value of URLConnection.setUseCaches(boolean) |
HttpRequest |
userAgent(String value)
Set the 'User-Agent' header to given value |
protected HttpRequest |
writePartHeader(String name,
String filename)
Write part header |
OutputStreamWriter |
writer()
Create writer to request output stream |
Methods inherited from class java.lang.Object |
---|
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait |
Field Detail |
---|
public static final String CHARSET_UTF8
public static final String HEADER_ACCEPT
public static final String HEADER_ACCEPT_CHARSET
public static final String HEADER_ACCEPT_ENCODING
public static final String HEADER_AUTHORIZATION
public static final String HEADER_CACHE_CONTROL
public static final String HEADER_CONTENT_ENCODING
public static final String HEADER_CONTENT_LENGTH
public static final String HEADER_CONTENT_TYPE
public static final String HEADER_DATE
public static final String HEADER_ETAG
public static final String HEADER_EXPIRES
public static final String HEADER_IF_NONE_MATCH
public static final String HEADER_LAST_MODIFIED
public static final String HEADER_LOCATION
public static final String HEADER_SERVER
public static final String HEADER_USER_AGENT
public static final String METHOD_DELETE
public static final String METHOD_GET
public static final String METHOD_HEAD
public static final String METHOD_OPTIONS
public static final String METHOD_POST
public static final String METHOD_PUT
public static final String METHOD_TRACE
public static final String PARAM_CHARSET
Constructor Detail |
---|
public HttpRequest(CharSequence url, String method) throws HttpRequest.HttpRequestException
url
- method
-
HttpRequest.HttpRequestException
public HttpRequest(URL url, String method) throws HttpRequest.HttpRequestException
url
- method
-
HttpRequest.HttpRequestException
Method Detail |
---|
public static String encode(CharSequence url) throws HttpRequest.HttpRequestException
String
This method ensures the path and query segments of the URL are properly
encoded such as ' ' characters being encoded to '%20' or any UTF-8
characters that are non-ASCII. No encoding of URLs is done by default by
the HttpRequest
constructors and so if URL encoding is needed this
method should be called before calling the HttpRequest
constructor.
url
-
HttpRequest.HttpRequestException
public static String append(CharSequence url, Map<?,?> params)
Each map entry's key will be a parameter name and the value's
Object.toString()
will be the parameter value.
url
- params
-
public static String append(CharSequence url, String... params)
The params argument is interpreted as a sequence of name/value pairs so the given number of params must be divisible by 2.
url
- params
- name/value pairs
public static HttpRequest get(CharSequence url) throws HttpRequest.HttpRequestException
url
-
HttpRequest.HttpRequestException
public static HttpRequest get(URL url) throws HttpRequest.HttpRequestException
url
-
HttpRequest.HttpRequestException
public static HttpRequest get(CharSequence baseUrl, Map<?,?> params, boolean encode)
baseUrl
- params
- The query parameters to include as part of the baseUrlencode
- true to encode the full URL
append(CharSequence, Map)
,
encode(CharSequence)
public static HttpRequest get(CharSequence baseUrl, boolean encode, String... params)
baseUrl
- encode
- true to encode the full URLparams
- the name/value query parameter pairs to include as part of the
baseUrl
append(CharSequence, String...)
,
encode(CharSequence)
public static HttpRequest post(CharSequence url) throws HttpRequest.HttpRequestException
url
-
HttpRequest.HttpRequestException
public static HttpRequest post(URL url) throws HttpRequest.HttpRequestException
url
-
HttpRequest.HttpRequestException
public static HttpRequest post(CharSequence baseUrl, Map<?,?> params, boolean encode)
baseUrl
- params
- the query parameters to include as part of the baseUrlencode
- true to encode the full URL
append(CharSequence, Map)
,
encode(CharSequence)
public static HttpRequest post(CharSequence baseUrl, boolean encode, String... params)
baseUrl
- encode
- true to encode the full URLparams
- the name/value query parameter pairs to include as part of the
baseUrl
append(CharSequence, String...)
,
encode(CharSequence)
public static HttpRequest put(CharSequence url) throws HttpRequest.HttpRequestException
url
-
HttpRequest.HttpRequestException
public static HttpRequest put(URL url) throws HttpRequest.HttpRequestException
url
-
HttpRequest.HttpRequestException
public static HttpRequest put(CharSequence baseUrl, Map<?,?> params, boolean encode)
baseUrl
- params
- the query parameters to include as part of the baseUrlencode
- true to encode the full URL
append(CharSequence, Map)
,
encode(CharSequence)
public static HttpRequest put(CharSequence baseUrl, boolean encode, String... params)
baseUrl
- encode
- true to encode the full URLparams
- the name/value query parameter pairs to include as part of the
baseUrl
append(CharSequence, String...)
,
encode(CharSequence)
public static HttpRequest delete(CharSequence url) throws HttpRequest.HttpRequestException
url
-
HttpRequest.HttpRequestException
public static HttpRequest delete(URL url) throws HttpRequest.HttpRequestException
url
-
HttpRequest.HttpRequestException
public static HttpRequest delete(CharSequence baseUrl, Map<?,?> params, boolean encode)
baseUrl
- params
- The query parameters to include as part of the baseUrlencode
- true to encode the full URL
append(CharSequence, Map)
,
encode(CharSequence)
public static HttpRequest delete(CharSequence baseUrl, boolean encode, String... params)
baseUrl
- encode
- true to encode the full URLparams
- the name/value query parameter pairs to include as part of the
baseUrl
append(CharSequence, String...)
,
encode(CharSequence)
public static HttpRequest head(CharSequence url) throws HttpRequest.HttpRequestException
url
-
HttpRequest.HttpRequestException
public static HttpRequest head(URL url) throws HttpRequest.HttpRequestException
url
-
HttpRequest.HttpRequestException
public static HttpRequest head(CharSequence baseUrl, Map<?,?> params, boolean encode)
baseUrl
- params
- The query parameters to include as part of the baseUrlencode
- true to encode the full URL
append(CharSequence, Map)
,
encode(CharSequence)
public static HttpRequest head(CharSequence baseUrl, boolean encode, String... params)
baseUrl
- encode
- true to encode the full URLparams
- the name/value query parameter pairs to include as part of the
baseUrl
append(CharSequence, String...)
,
encode(CharSequence)
public static HttpRequest options(CharSequence url) throws HttpRequest.HttpRequestException
url
-
HttpRequest.HttpRequestException
public static HttpRequest options(URL url) throws HttpRequest.HttpRequestException
url
-
HttpRequest.HttpRequestException
public static HttpRequest trace(CharSequence url) throws HttpRequest.HttpRequestException
url
-
HttpRequest.HttpRequestException
public static HttpRequest trace(URL url) throws HttpRequest.HttpRequestException
url
-
HttpRequest.HttpRequestException
public static void keepAlive(boolean keepAlive)
This setting will apply to requests.
keepAlive
- public static void proxyHost(String host)
This setting will apply to requests.
host
- public static void proxyPort(int port)
This setting will apply to requests.
port
- public static void nonProxyHosts(String... hosts)
This setting will apply to requests.
hosts
- public String toString()
toString
in class Object
public HttpURLConnection getConnection()
public HttpRequest ignoreCloseExceptions(boolean ignore)
Closeable.close()
The default value of this setting is true
ignore
-
public boolean ignoreCloseExceptions()
Closeable.close()
are
ignored
public int code() throws HttpRequest.HttpRequestException
HttpRequest.HttpRequestException
public HttpRequest code(AtomicInteger output) throws HttpRequest.HttpRequestException
AtomicInteger
to the status code of the
response
output
-
HttpRequest.HttpRequestException
public boolean ok() throws HttpRequest.HttpRequestException
HttpRequest.HttpRequestException
public boolean created() throws HttpRequest.HttpRequestException
HttpRequest.HttpRequestException
public boolean serverError() throws HttpRequest.HttpRequestException
HttpRequest.HttpRequestException
public boolean badRequest() throws HttpRequest.HttpRequestException
HttpRequest.HttpRequestException
public boolean notFound() throws HttpRequest.HttpRequestException
HttpRequest.HttpRequestException
public boolean notModified() throws HttpRequest.HttpRequestException
HttpRequest.HttpRequestException
public String message() throws HttpRequest.HttpRequestException
HttpRequest.HttpRequestException
public HttpRequest disconnect()
public HttpRequest chunk(int size)
size
-
public HttpRequest bufferSize(int size)
This size is also used for send and receive buffers created for both char and byte arrays
The default buffer size is 8,192 bytes
size
-
public int bufferSize()
The default buffer size is 8,192 bytes
public HttpRequest uncompress(boolean uncompress)
This will only affect requests that have the 'Content-Encoding' response header set to 'gzip'.
This causes all receive methods to use a GZIPInputStream
when
applicable so that higher level streams and readers can read the data
uncompressed.
Setting this option does not cause any request headers to be set
automatically so acceptGzipEncoding()
should be used in
conjunction with this setting to tell the server to gzip the response.
uncompress
-
protected ByteArrayOutputStream byteStream()
public String body(String charset) throws HttpRequest.HttpRequestException
String
in given character set
This will fall back to using the UTF-8 character set if the given charset is null
charset
-
HttpRequest.HttpRequestException
public String body() throws HttpRequest.HttpRequestException
String
using character set returned from
charset()
HttpRequest.HttpRequestException
public byte[] bytes() throws HttpRequest.HttpRequestException
HttpRequest.HttpRequestException
public BufferedInputStream buffer() throws HttpRequest.HttpRequestException
HttpRequest.HttpRequestException
bufferSize(int)
public InputStream stream() throws HttpRequest.HttpRequestException
HttpRequest.HttpRequestException
public InputStreamReader reader(String charset) throws HttpRequest.HttpRequestException
This will fall back to using the UTF-8 character set if the given charset is null
charset
-
HttpRequest.HttpRequestException
public InputStreamReader reader() throws HttpRequest.HttpRequestException
charset()
HttpRequest.HttpRequestException
public BufferedReader bufferedReader(String charset) throws HttpRequest.HttpRequestException
charset
-
HttpRequest.HttpRequestException
bufferSize(int)
public BufferedReader bufferedReader() throws HttpRequest.HttpRequestException
charset()
and the configured buffer size
HttpRequest.HttpRequestException
bufferSize(int)
public HttpRequest receive(File file) throws HttpRequest.HttpRequestException
file
-
HttpRequest.HttpRequestException
public HttpRequest receive(OutputStream output) throws HttpRequest.HttpRequestException
output
-
HttpRequest.HttpRequestException
public HttpRequest receive(PrintStream output) throws HttpRequest.HttpRequestException
output
-
HttpRequest.HttpRequestException
public HttpRequest receive(Appendable appendable) throws HttpRequest.HttpRequestException
appendable
-
HttpRequest.HttpRequestException
public HttpRequest receive(Writer writer) throws HttpRequest.HttpRequestException
writer
-
HttpRequest.HttpRequestException
public HttpRequest readTimeout(int timeout)
timeout
-
public HttpRequest connectTimeout(int timeout)
timeout
-
public HttpRequest header(String name, String value)
name
- value
-
public HttpRequest header(String name, Number value)
name
- value
-
public HttpRequest headers(Map<String,String> headers)
headers
-
public HttpRequest header(Map.Entry<String,String> header)
header
-
public String header(String name) throws HttpRequest.HttpRequestException
name
-
HttpRequest.HttpRequestException
public Map<String,List<String>> headers() throws HttpRequest.HttpRequestException
HttpRequest.HttpRequestException
public long dateHeader(String name) throws HttpRequest.HttpRequestException
name
-
HttpRequest.HttpRequestException
public long dateHeader(String name, long defaultValue) throws HttpRequest.HttpRequestException
name
- defaultValue
-
HttpRequest.HttpRequestException
public int intHeader(String name) throws HttpRequest.HttpRequestException
name
-
HttpRequest.HttpRequestException
public int intHeader(String name, int defaultValue) throws HttpRequest.HttpRequestException
name
- defaultValue
-
HttpRequest.HttpRequestException
public String[] headers(String name)
name
-
String
header valuespublic String parameter(String headerName, String paramName)
headerName
- paramName
-
public Map<String,String> parameters(String headerName)
This will be all key=value pairs after the first ';' that are separated by a ';'
headerName
-
protected Map<String,String> getParams(String header)
header
-
protected String getParam(String value, String paramName)
value
- paramName
-
public String charset()
public HttpRequest userAgent(String value)
value
-
public HttpRequest useCaches(boolean useCaches)
URLConnection.setUseCaches(boolean)
useCaches
-
public HttpRequest acceptEncoding(String value)
value
-
public HttpRequest acceptGzipEncoding()
uncompress(boolean)
public HttpRequest acceptCharset(String value)
value
-
public String contentEncoding()
public String server()
public long date()
public String cacheControl()
public String eTag()
public long expires()
public long lastModified()
public String location()
public HttpRequest authorization(String value)
value
-
public HttpRequest basic(String name, String password)
name
- password
-
public HttpRequest ifModifiedSince(long value)
value
-
public HttpRequest ifNoneMatch(String value)
value
-
public HttpRequest contentType(String value)
value
-
public HttpRequest contentType(String value, String charset)
value
- charset
-
public String contentType()
public int contentLength()
public HttpRequest contentLength(String value)
value
-
public HttpRequest contentLength(int value)
value
-
public HttpRequest accept(String value)
value
-
public HttpRequest acceptJson()
protected HttpRequest copy(InputStream input, OutputStream output) throws IOException
input
- output
-
IOException
protected HttpRequest copy(Reader input, Writer output) throws IOException
input
- output
-
IOException
protected HttpRequest closeOutput() throws IOException
HttpRequest.HttpRequestException
IOException
protected HttpRequest closeOutputQuietly() throws HttpRequest.HttpRequestException
closeOutput()
and re-throw a caught IOException
s as
an HttpRequest.HttpRequestException
HttpRequest.HttpRequestException
protected HttpRequest openOutput() throws IOException
IOException
protected HttpRequest startPart() throws IOException
IOException
protected HttpRequest writePartHeader(String name, String filename) throws IOException
name
- filename
-
IOException
public HttpRequest part(String name, String part)
name
- part
-
public HttpRequest part(String name, String filename, String part) throws HttpRequest.HttpRequestException
name
- filename
- part
-
HttpRequest.HttpRequestException
public HttpRequest part(String name, Number part) throws HttpRequest.HttpRequestException
name
- part
-
HttpRequest.HttpRequestException
public HttpRequest part(String name, String filename, Number part) throws HttpRequest.HttpRequestException
name
- filename
- part
-
HttpRequest.HttpRequestException
public HttpRequest part(String name, File part) throws HttpRequest.HttpRequestException
name
- part
-
HttpRequest.HttpRequestException
public HttpRequest part(String name, String filename, File part) throws HttpRequest.HttpRequestException
name
- filename
- part
-
HttpRequest.HttpRequestException
public HttpRequest part(String name, InputStream part) throws HttpRequest.HttpRequestException
name
- part
-
HttpRequest.HttpRequestException
public HttpRequest part(String name, String filename, InputStream part) throws HttpRequest.HttpRequestException
name
- filename
- part
-
HttpRequest.HttpRequestException
public HttpRequest partHeader(String name, String value) throws HttpRequest.HttpRequestException
name
- value
-
HttpRequest.HttpRequestException
public HttpRequest send(File input) throws HttpRequest.HttpRequestException
input
-
HttpRequest.HttpRequestException
public HttpRequest send(byte[] input) throws HttpRequest.HttpRequestException
input
-
HttpRequest.HttpRequestException
public HttpRequest send(InputStream input) throws HttpRequest.HttpRequestException
The given stream will be closed once sending completes
input
-
HttpRequest.HttpRequestException
public HttpRequest send(Reader input) throws HttpRequest.HttpRequestException
The given reader will be closed once sending completes
input
-
HttpRequest.HttpRequestException
public HttpRequest send(CharSequence value) throws HttpRequest.HttpRequestException
The charset configured via contentType(String)
will be used and
UTF-8 will be used if it is unset.
value
-
HttpRequest.HttpRequestException
public OutputStreamWriter writer() throws HttpRequest.HttpRequestException
HttpRequest.HttpRequestException
public HttpRequest form(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
values
-
HttpRequest.HttpRequestException
public HttpRequest form(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
entry
-
HttpRequest.HttpRequestException
public HttpRequest form(Map.Entry<?,?> entry, String charset) throws HttpRequest.HttpRequestException
The pair specified will be URL-encoded and sent with the 'application/x-www-form-urlencoded' content-type
entry
- charset
-
HttpRequest.HttpRequestException
public HttpRequest form(Object name, 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
name
- value
-
HttpRequest.HttpRequestException
public HttpRequest form(Object name, Object value, String charset) throws HttpRequest.HttpRequestException
The values specified will be URL-encoded and sent with the 'application/x-www-form-urlencoded' content-type
name
- value
- charset
-
HttpRequest.HttpRequestException
public HttpRequest form(Map<?,?> values, String charset) throws HttpRequest.HttpRequestException
values
- charset
-
HttpRequest.HttpRequestException
public HttpRequest trustAllCerts() throws HttpRequest.HttpRequestException
This method does nothing if the current request is not a HTTPS request
HttpRequest.HttpRequestException
public HttpRequest trustAllHosts()
HostnameVerifier
that always returns true
for each
host verified
This method does nothing if the current request is not a HTTPS request
|
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |