com.loopj.android.http

类 AsyncHttpClient

java.lang.Object

com.loopj.android.http.AsyncHttpClient

直接已知子类:

SyncHttpClient

public class AsyncHttpClient
extends java.lang.Object

The AsyncHttpClient can be used to make asynchronous GET, POST, PUT and DELETE HTTP requests in your Android applications. Requests can be made with additional parameters by passing a RequestParams instance, and responses can be handled by passing an anonymously overridden ResponseHandlerInterface instance.

For example:

 AsyncHttpClient client = new AsyncHttpClient();
 client.get("http://www.google.com", new AsyncHttpResponseHandler() {
     @Override
     public void onSuccess(int statusCode, Header[] headers, byte[] responseBody) {
          System.out.println(response);
     }
     @Override
     public void onFailure(int statusCode, Header[] headers, byte[] responseBody, Throwable
 error)
 {
          error.printStackTrace(System.out);
     }
 });
 

另请参阅:

AsyncHttpResponseHandler, ResponseHandlerInterface, RequestParams

字段概要

字段

限定符和类型	字段和说明
static int	DEFAULT_MAX_CONNECTIONS
static int	DEFAULT_MAX_RETRIES
static int	DEFAULT_RETRY_SLEEP_TIME_MILLIS
static int	DEFAULT_SOCKET_BUFFER_SIZE
static int	DEFAULT_SOCKET_TIMEOUT
static java.lang.String	ENCODING_GZIP
static java.lang.String	HEADER_ACCEPT_ENCODING
static java.lang.String	HEADER_CONTENT_DISPOSITION
static java.lang.String	HEADER_CONTENT_ENCODING
static java.lang.String	HEADER_CONTENT_RANGE
static java.lang.String	HEADER_CONTENT_TYPE
static java.lang.String	LOG_TAG

构造器概要

构造器

构造器和说明
AsyncHttpClient() Creates a new AsyncHttpClient with default constructor arguments values
AsyncHttpClient(boolean fixNoHttpResponseException, int httpPort, int httpsPort) Creates new AsyncHttpClient using given params
AsyncHttpClient(int httpPort) Creates a new AsyncHttpClient.
AsyncHttpClient(int httpPort, int httpsPort) Creates a new AsyncHttpClient.
AsyncHttpClient(SchemeRegistry schemeRegistry) Creates a new AsyncHttpClient.

方法概要

限定符和类型	方法和说明
void	addHeader(java.lang.String header, java.lang.String value) Sets headers that will be added to all requests this client makes (before sending).
static void	allowRetryExceptionClass(java.lang.Class<?> cls)
static void	blockRetryExceptionClass(java.lang.Class<?> cls)
void	cancelAllRequests(boolean mayInterruptIfRunning) Cancels all pending (or potentially active) requests.
void	cancelRequests(android.content.Context context, boolean mayInterruptIfRunning) Cancels any pending (or potentially active) requests associated with the passed Context.
void	clearBasicAuth() 已过时。
void	clearCredentialsProvider() Removes previously set auth credentials
protected ClientConnectionManager	createConnectionManager(SchemeRegistry schemeRegistry, BasicHttpParams httpParams) Provided so it is easier for developers to provide custom ThreadSafeClientConnManager implementation
RequestHandle	delete(android.content.Context context, java.lang.String url, Header[] headers, RequestParams params, ResponseHandlerInterface responseHandler) Perform a HTTP DELETE request.
RequestHandle	delete(android.content.Context context, java.lang.String url, Header[] headers, ResponseHandlerInterface responseHandler) Perform a HTTP DELETE request.
RequestHandle	delete(android.content.Context context, java.lang.String url, HttpEntity entity, java.lang.String contentType, ResponseHandlerInterface responseHandler) Perform a HTTP DELETE request and track the Android Context which initiated the request.
RequestHandle	delete(android.content.Context context, java.lang.String url, ResponseHandlerInterface responseHandler) Perform a HTTP DELETE request.
void	delete(java.lang.String url, RequestParams params, AsyncHttpResponseHandler responseHandler) Perform a HTTP DELETE request.
RequestHandle	delete(java.lang.String url, ResponseHandlerInterface responseHandler) Perform a HTTP DELETE request.
static void	endEntityViaReflection(HttpEntity entity) This horrible hack is required on Android, due to implementation of BasicManagedEntity, which doesn't chain call consumeContent on underlying wrapped HttpEntity
RequestHandle	get(android.content.Context context, java.lang.String url, Header[] headers, RequestParams params, ResponseHandlerInterface responseHandler) Perform a HTTP GET request and track the Android Context which initiated the request with customized headers
RequestHandle	get(android.content.Context context, java.lang.String url, HttpEntity entity, java.lang.String contentType, ResponseHandlerInterface responseHandler) Perform a HTTP GET request and track the Android Context which initiated the request.
RequestHandle	get(android.content.Context context, java.lang.String url, RequestParams params, ResponseHandlerInterface responseHandler) Perform a HTTP GET request and track the Android Context which initiated the request.
RequestHandle	get(android.content.Context context, java.lang.String url, ResponseHandlerInterface responseHandler) Perform a HTTP GET request without any parameters and track the Android Context which initiated the request.
RequestHandle	get(java.lang.String url, RequestParams params, ResponseHandlerInterface responseHandler) Perform a HTTP GET request with parameters.
RequestHandle	get(java.lang.String url, ResponseHandlerInterface responseHandler) Perform a HTTP GET request, without any parameters.
int	getConnectTimeout() Returns current connection timeout limit (milliseconds).
protected java.util.concurrent.ExecutorService	getDefaultThreadPool() Get the default threading pool to be used for this HTTP client.
HttpClient	getHttpClient() Get the underlying HttpClient instance.
HttpContext	getHttpContext() Get the underlying HttpContext instance.
int	getMaxConnections() Returns current limit of parallel connections
int	getResponseTimeout() Returns current response timeout limit (milliseconds).
java.util.concurrent.ExecutorService	getThreadPool() Returns the current executor service used.
int	getTimeout() 已过时。 Use either getConnectTimeout() or getResponseTimeout()
protected java.net.URI	getURI(java.lang.String url) Returns a URI instance for the specified, absolute URL string.
static java.lang.String	getUrlWithQueryString(boolean shouldEncodeUrl, java.lang.String url, RequestParams params) Will encode url, if not disabled, and adds params on the end of it
RequestHandle	head(android.content.Context context, java.lang.String url, Header[] headers, RequestParams params, ResponseHandlerInterface responseHandler) Perform a HTTP HEAD request and track the Android Context which initiated the request with customized headers
RequestHandle	head(android.content.Context context, java.lang.String url, RequestParams params, ResponseHandlerInterface responseHandler) Perform a HTTP HEAD request and track the Android Context which initiated the request.
RequestHandle	head(android.content.Context context, java.lang.String url, ResponseHandlerInterface responseHandler) Perform a HTTP HEAD request without any parameters and track the Android Context which initiated the request.
RequestHandle	head(java.lang.String url, RequestParams params, ResponseHandlerInterface responseHandler) Perform a HTTP HEAD request with parameters.
RequestHandle	head(java.lang.String url, ResponseHandlerInterface responseHandler) Perform a HTTP HEAD request, without any parameters.
static boolean	isInputStreamGZIPCompressed(java.io.PushbackInputStream inputStream) Checks the InputStream if it contains GZIP compressed data
boolean	isUrlEncodingEnabled()
protected AsyncHttpRequest	newAsyncHttpRequest(DefaultHttpClient client, HttpContext httpContext, HttpUriRequest uriRequest, java.lang.String contentType, ResponseHandlerInterface responseHandler, android.content.Context context) Instantiate a new asynchronous HTTP request for the passed parameters.
RequestHandle	patch(android.content.Context context, java.lang.String url, Header[] headers, HttpEntity entity, java.lang.String contentType, ResponseHandlerInterface responseHandler) Perform a HTTP PATCH request and track the Android Context which initiated the request.
RequestHandle	patch(android.content.Context context, java.lang.String url, HttpEntity entity, java.lang.String contentType, ResponseHandlerInterface responseHandler) Perform a HTTP PATCH request and track the Android Context which initiated the request.
RequestHandle	patch(android.content.Context context, java.lang.String url, RequestParams params, ResponseHandlerInterface responseHandler) Perform a HTTP PATCH request and track the Android Context which initiated the request.
RequestHandle	patch(java.lang.String url, RequestParams params, ResponseHandlerInterface responseHandler) Perform a HTTP PATCH request with parameters.
RequestHandle	patch(java.lang.String url, ResponseHandlerInterface responseHandler) Perform a HTTP PATCH request, without any parameters.
RequestHandle	post(android.content.Context context, java.lang.String url, Header[] headers, HttpEntity entity, java.lang.String contentType, ResponseHandlerInterface responseHandler) Perform a HTTP POST request and track the Android Context which initiated the request.
RequestHandle	post(android.content.Context context, java.lang.String url, Header[] headers, RequestParams params, java.lang.String contentType, ResponseHandlerInterface responseHandler) Perform a HTTP POST request and track the Android Context which initiated the request.
RequestHandle	post(android.content.Context context, java.lang.String url, HttpEntity entity, java.lang.String contentType, ResponseHandlerInterface responseHandler) Perform a HTTP POST request and track the Android Context which initiated the request.
RequestHandle	post(android.content.Context context, java.lang.String url, RequestParams params, ResponseHandlerInterface responseHandler) Perform a HTTP POST request and track the Android Context which initiated the request.
RequestHandle	post(java.lang.String url, RequestParams params, ResponseHandlerInterface responseHandler) Perform a HTTP POST request with parameters.
RequestHandle	post(java.lang.String url, ResponseHandlerInterface responseHandler) Perform a HTTP POST request, without any parameters.
RequestHandle	put(android.content.Context context, java.lang.String url, Header[] headers, HttpEntity entity, java.lang.String contentType, ResponseHandlerInterface responseHandler) Perform a HTTP PUT request and track the Android Context which initiated the request.
RequestHandle	put(android.content.Context context, java.lang.String url, HttpEntity entity, java.lang.String contentType, ResponseHandlerInterface responseHandler) Perform a HTTP PUT request and track the Android Context which initiated the request.
RequestHandle	put(android.content.Context context, java.lang.String url, RequestParams params, ResponseHandlerInterface responseHandler) Perform a HTTP PUT request and track the Android Context which initiated the request.
RequestHandle	put(java.lang.String url, RequestParams params, ResponseHandlerInterface responseHandler) Perform a HTTP PUT request with parameters.
RequestHandle	put(java.lang.String url, ResponseHandlerInterface responseHandler) Perform a HTTP PUT request, without any parameters.
void	removeAllHeaders() Will, before sending, remove all headers currently present in AsyncHttpClient instance, which applies on all requests this client makes
void	removeHeader(java.lang.String header) Remove header from all requests this client makes (before sending).
protected RequestHandle	sendRequest(DefaultHttpClient client, HttpContext httpContext, HttpUriRequest uriRequest, java.lang.String contentType, ResponseHandlerInterface responseHandler, android.content.Context context) Puts a new request in queue as a new thread in pool to be executed
void	setAuthenticationPreemptive(boolean isPreemtive) Sets HttpRequestInterceptor which handles authorization in preemtive way, as workaround you can use call `AsyncHttpClient.addHeader("Authorization","Basic base64OfUsernameAndPassword==")`
void	setBasicAuth(java.lang.String username, java.lang.String password) Sets basic authentication for the request.
void	setBasicAuth(java.lang.String username, java.lang.String password, AuthScope scope) Sets basic authentication for the request.
void	setBasicAuth(java.lang.String username, java.lang.String password, AuthScope scope, boolean preemtive) Sets basic authentication for the request.
void	setBasicAuth(java.lang.String username, java.lang.String password, boolean preemtive) Sets basic authentication for the request.
void	setConnectTimeout(int value) Set connection timeout limit (milliseconds).
void	setCookieStore(CookieStore cookieStore) Sets an optional CookieStore to use when making requests
void	setCredentials(AuthScope authScope, Credentials credentials)
void	setEnableRedirects(boolean enableRedirects)
void	setEnableRedirects(boolean enableRedirects, boolean enableRelativeRedirects) Circular redirects are enabled by default
void	setEnableRedirects(boolean enableRedirects, boolean enableRelativeRedirects, boolean enableCircularRedirects) Simple interface method, to enable or disable redirects.
void	setMaxConnections(int maxConnections) Sets maximum limit of parallel connections
void	setMaxRetriesAndTimeout(int retries, int timeout) Sets the maximum number of retries and timeout for a particular Request.
void	setProxy(java.lang.String hostname, int port) Sets the Proxy by it's hostname and port
void	setProxy(java.lang.String hostname, int port, java.lang.String username, java.lang.String password) Sets the Proxy by it's hostname,port,username and password
void	setRedirectHandler(RedirectHandler customRedirectHandler) Allows you to set custom RedirectHandler implementation, if the default provided doesn't suit your needs
void	setResponseTimeout(int value) Set response timeout limit (milliseconds).
void	setSSLSocketFactory(org.apache.http.conn.ssl.SSLSocketFactory sslSocketFactory) Sets the SSLSocketFactory to user when making requests.
void	setThreadPool(java.util.concurrent.ExecutorService threadPool) Overrides the threadpool implementation used when queuing/pooling requests.
void	setTimeout(int value) Set both the connection and socket timeouts.
void	setURLEncodingEnabled(boolean enabled) Sets state of URL encoding feature, see bug #227, this method allows you to turn off and on this auto-magic feature on-demand.
void	setUserAgent(java.lang.String userAgent) Sets the User-Agent header to be sent with each request.
static void	silentCloseInputStream(java.io.InputStream is) A utility function to close an input stream without raising an exception.
static void	silentCloseOutputStream(java.io.OutputStream os) A utility function to close an output stream without raising an exception.

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

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

字段详细资料

LOG_TAG

public static final java.lang.String LOG_TAG

另请参阅:

常量字段值

HEADER_CONTENT_TYPE

public static final java.lang.String HEADER_CONTENT_TYPE

另请参阅:

常量字段值

HEADER_CONTENT_RANGE

public static final java.lang.String HEADER_CONTENT_RANGE

另请参阅:

常量字段值

HEADER_CONTENT_ENCODING

public static final java.lang.String HEADER_CONTENT_ENCODING

另请参阅:

常量字段值

HEADER_CONTENT_DISPOSITION

public static final java.lang.String HEADER_CONTENT_DISPOSITION

另请参阅:

常量字段值

HEADER_ACCEPT_ENCODING

public static final java.lang.String HEADER_ACCEPT_ENCODING

另请参阅:

常量字段值

ENCODING_GZIP

public static final java.lang.String ENCODING_GZIP

另请参阅:

常量字段值

DEFAULT_MAX_CONNECTIONS

public static final int DEFAULT_MAX_CONNECTIONS

另请参阅:

常量字段值

DEFAULT_SOCKET_TIMEOUT

public static final int DEFAULT_SOCKET_TIMEOUT

另请参阅:

常量字段值

DEFAULT_MAX_RETRIES

public static final int DEFAULT_MAX_RETRIES

另请参阅:

常量字段值

DEFAULT_RETRY_SLEEP_TIME_MILLIS

public static final int DEFAULT_RETRY_SLEEP_TIME_MILLIS

另请参阅:

常量字段值

DEFAULT_SOCKET_BUFFER_SIZE

public static final int DEFAULT_SOCKET_BUFFER_SIZE

另请参阅:

常量字段值

构造器详细资料

AsyncHttpClient

public AsyncHttpClient()

Creates a new AsyncHttpClient with default constructor arguments values

AsyncHttpClient

public AsyncHttpClient(int httpPort)

Creates a new AsyncHttpClient.

参数:

httpPort - non-standard HTTP-only port

AsyncHttpClient

public AsyncHttpClient(int httpPort,
                       int httpsPort)

Creates a new AsyncHttpClient.

参数:

httpPort - non-standard HTTP-only port

httpsPort - non-standard HTTPS-only port

AsyncHttpClient

public AsyncHttpClient(boolean fixNoHttpResponseException,
                       int httpPort,
                       int httpsPort)

Creates new AsyncHttpClient using given params

参数:

fixNoHttpResponseException - Whether to fix issue or not, by omitting SSL verification

httpPort - HTTP port to be used, must be greater than 0

httpsPort - HTTPS port to be used, must be greater than 0

AsyncHttpClient

public AsyncHttpClient(SchemeRegistry schemeRegistry)

Creates a new AsyncHttpClient.

参数:

schemeRegistry - SchemeRegistry to be used

方法详细资料

allowRetryExceptionClass

public static void allowRetryExceptionClass(java.lang.Class<?> cls)

blockRetryExceptionClass

public static void blockRetryExceptionClass(java.lang.Class<?> cls)

getHttpClient

public HttpClient getHttpClient()

Get the underlying HttpClient instance. This is useful for setting additional fine-grained settings for requests by accessing the client's ConnectionManager, HttpParams and SchemeRegistry.

返回:

underlying HttpClient instance

getHttpContext

public HttpContext getHttpContext()

Get the underlying HttpContext instance. This is useful for getting and setting fine-grained settings for requests by accessing the context's attributes such as the CookieStore.

返回:

underlying HttpContext instance

setCookieStore

public void setCookieStore(CookieStore cookieStore)

Sets an optional CookieStore to use when making requests

参数:

cookieStore - The CookieStore implementation to use, usually an instance of PersistentCookieStore

setThreadPool

public void setThreadPool(java.util.concurrent.ExecutorService threadPool)

Overrides the threadpool implementation used when queuing/pooling requests. By default, Executors.newCachedThreadPool() is used.

参数:

threadPool - an instance of ExecutorService to use for queuing/pooling requests.

getThreadPool

public java.util.concurrent.ExecutorService getThreadPool()

Returns the current executor service used. By default, Executors.newCachedThreadPool() is used.

返回:

current executor service used

getDefaultThreadPool

protected java.util.concurrent.ExecutorService getDefaultThreadPool()

Get the default threading pool to be used for this HTTP client.

返回:

The default threading pool to be used

createConnectionManager

protected ClientConnectionManager createConnectionManager(SchemeRegistry schemeRegistry,
                                                          BasicHttpParams httpParams)

Provided so it is easier for developers to provide custom ThreadSafeClientConnManager implementation

参数:

schemeRegistry - SchemeRegistry, usually provided by getDefaultSchemeRegistry(boolean, int, int)

httpParams - BasicHttpParams

返回:

ClientConnectionManager instance

setEnableRedirects

public void setEnableRedirects(boolean enableRedirects,
                               boolean enableRelativeRedirects,
                               boolean enableCircularRedirects)

Simple interface method, to enable or disable redirects. If you set manually RedirectHandler on underlying HttpClient, effects of this method will be canceled.

Default setting is to disallow redirects.

参数:

enableRedirects - boolean

enableRelativeRedirects - boolean

enableCircularRedirects - boolean

setEnableRedirects

public void setEnableRedirects(boolean enableRedirects,
                               boolean enableRelativeRedirects)

Circular redirects are enabled by default

参数:

enableRedirects - boolean

enableRelativeRedirects - boolean

另请参阅:

setEnableRedirects(boolean, boolean, boolean)

setEnableRedirects

public void setEnableRedirects(boolean enableRedirects)

参数:

enableRedirects - boolean

另请参阅:

setEnableRedirects(boolean, boolean, boolean)

setRedirectHandler

public void setRedirectHandler(RedirectHandler customRedirectHandler)

Allows you to set custom RedirectHandler implementation, if the default provided doesn't suit your needs

参数:

customRedirectHandler - RedirectHandler instance

另请参阅:

MyRedirectHandler

setUserAgent

public void setUserAgent(java.lang.String userAgent)

Sets the User-Agent header to be sent with each request. By default, "Android Asynchronous Http Client/VERSION (http://loopj.com/android-async-http/)" is used.

参数:

userAgent - the string to use in the User-Agent header.

getMaxConnections

public int getMaxConnections()

Returns current limit of parallel connections

返回:

maximum limit of parallel connections, default is 10

setMaxConnections

public void setMaxConnections(int maxConnections)

Sets maximum limit of parallel connections

参数:

maxConnections - maximum parallel connections, must be at least 1

getTimeout

public int getTimeout()

已过时。 Use either getConnectTimeout() or getResponseTimeout()

Returns current socket timeout limit (milliseconds). By default, this is set to 10 seconds.

返回:

Socket Timeout limit in milliseconds

setTimeout

public void setTimeout(int value)

Set both the connection and socket timeouts. By default, both are set to 10 seconds.

参数:

value - the connect/socket timeout in milliseconds, at least 1 second

另请参阅:

setConnectTimeout(int), setResponseTimeout(int)

getConnectTimeout

public int getConnectTimeout()

Returns current connection timeout limit (milliseconds). By default, this is set to 10 seconds.

返回:

Connection timeout limit in milliseconds

setConnectTimeout

public void setConnectTimeout(int value)

Set connection timeout limit (milliseconds). By default, this is set to 10 seconds.

参数:

value - Connection timeout in milliseconds, minimal value is 1000 (1 second).

getResponseTimeout

public int getResponseTimeout()

Returns current response timeout limit (milliseconds). By default, this is set to 10 seconds.

返回:

Response timeout limit in milliseconds

setResponseTimeout

public void setResponseTimeout(int value)

Set response timeout limit (milliseconds). By default, this is set to 10 seconds.

参数:

value - Response timeout in milliseconds, minimal value is 1000 (1 second).

setProxy

public void setProxy(java.lang.String hostname,
                     int port)

Sets the Proxy by it's hostname and port

参数:

hostname - the hostname (IP or DNS name)

port - the port number. -1 indicates the scheme default port.

setProxy

public void setProxy(java.lang.String hostname,
                     int port,
                     java.lang.String username,
                     java.lang.String password)

Sets the Proxy by it's hostname,port,username and password

参数:

hostname - the hostname (IP or DNS name)

port - the port number. -1 indicates the scheme default port.

username - the username

password - the password

setSSLSocketFactory

public void setSSLSocketFactory(org.apache.http.conn.ssl.SSLSocketFactory sslSocketFactory)

Sets the SSLSocketFactory to user when making requests. By default, a new, default SSLSocketFactory is used.

参数:

sslSocketFactory - the socket factory to use for https requests.

setMaxRetriesAndTimeout

public void setMaxRetriesAndTimeout(int retries,
                                    int timeout)

Sets the maximum number of retries and timeout for a particular Request.

参数:

retries - maximum number of retries per request

timeout - sleep between retries in milliseconds

removeAllHeaders

public void removeAllHeaders()

Will, before sending, remove all headers currently present in AsyncHttpClient instance, which applies on all requests this client makes

addHeader

public void addHeader(java.lang.String header,
                      java.lang.String value)

Sets headers that will be added to all requests this client makes (before sending).

参数:

header - the name of the header

value - the contents of the header

removeHeader

public void removeHeader(java.lang.String header)

Remove header from all requests this client makes (before sending).

参数:

header - the name of the header

setBasicAuth

public void setBasicAuth(java.lang.String username,
                         java.lang.String password)

Sets basic authentication for the request. Uses AuthScope.ANY. This is the same as setBasicAuth('username','password',AuthScope.ANY)

参数:

username - Basic Auth username

password - Basic Auth password

setBasicAuth

public void setBasicAuth(java.lang.String username,
                         java.lang.String password,
                         boolean preemtive)

Sets basic authentication for the request. Uses AuthScope.ANY. This is the same as setBasicAuth('username','password',AuthScope.ANY)

参数:

username - Basic Auth username

password - Basic Auth password

preemtive - sets authorization in preemtive manner

setBasicAuth

public void setBasicAuth(java.lang.String username,
                         java.lang.String password,
                         AuthScope scope)

Sets basic authentication for the request. You should pass in your AuthScope for security. It should be like this setBasicAuth("username","password", new AuthScope("host",port,AuthScope.ANY_REALM))

参数:

username - Basic Auth username

password - Basic Auth password

scope - - an AuthScope object

setBasicAuth

public void setBasicAuth(java.lang.String username,
                         java.lang.String password,
                         AuthScope scope,
                         boolean preemtive)

Sets basic authentication for the request. You should pass in your AuthScope for security. It should be like this setBasicAuth("username","password", new AuthScope("host",port,AuthScope.ANY_REALM))

参数:

username - Basic Auth username

password - Basic Auth password

scope - an AuthScope object

preemtive - sets authorization in preemtive manner

setCredentials

public void setCredentials(AuthScope authScope,
                           Credentials credentials)

setAuthenticationPreemptive

public void setAuthenticationPreemptive(boolean isPreemtive)

Sets HttpRequestInterceptor which handles authorization in preemtive way, as workaround you can use call `AsyncHttpClient.addHeader("Authorization","Basic base64OfUsernameAndPassword==")`

参数:

isPreemtive - whether the authorization is processed in preemtive way

clearBasicAuth

@Deprecated
public void clearBasicAuth()

已过时。

Removes previously set basic auth credentials

clearCredentialsProvider

public void clearCredentialsProvider()

Removes previously set auth credentials

cancelRequests

public void cancelRequests(android.content.Context context,
                           boolean mayInterruptIfRunning)

Cancels any pending (or potentially active) requests associated with the passed Context.

Note: This will only affect requests which were created with a non-null android Context. This method is intended to be used in the onDestroy method of your android activities to destroy all requests which are no longer required.

参数:

context - the android Context instance associated to the request.

mayInterruptIfRunning - specifies if active requests should be cancelled along with pending requests.

cancelAllRequests

public void cancelAllRequests(boolean mayInterruptIfRunning)

Cancels all pending (or potentially active) requests.

Note: This will only affect requests which were created with a non-null android Context. This method is intended to be used in the onDestroy method of your android activities to destroy all requests which are no longer required.

参数:

mayInterruptIfRunning - specifies if active requests should be cancelled along with pending requests.

head

public RequestHandle head(java.lang.String url,
                          ResponseHandlerInterface responseHandler)

Perform a HTTP HEAD request, without any parameters.

参数:

url - the URL to send the request to.

responseHandler - the response handler instance that should handle the response.

返回:

RequestHandle of future request process

head

public RequestHandle head(java.lang.String url,
                          RequestParams params,
                          ResponseHandlerInterface responseHandler)

Perform a HTTP HEAD request with parameters.

参数:

url - the URL to send the request to.

params - additional HEAD parameters to send with the request.

responseHandler - the response handler instance that should handle the response.

返回:

RequestHandle of future request process

head

public RequestHandle head(android.content.Context context,
                          java.lang.String url,
                          ResponseHandlerInterface responseHandler)

Perform a HTTP HEAD request without any parameters and track the Android Context which initiated the request.

参数:

context - the Android Context which initiated the request.

url - the URL to send the request to.

responseHandler - the response handler instance that should handle the response.

返回:

RequestHandle of future request process

head

public RequestHandle head(android.content.Context context,
                          java.lang.String url,
                          RequestParams params,
                          ResponseHandlerInterface responseHandler)

Perform a HTTP HEAD request and track the Android Context which initiated the request.

参数:

context - the Android Context which initiated the request.

url - the URL to send the request to.

params - additional HEAD parameters to send with the request.

responseHandler - the response handler instance that should handle the response.

返回:

RequestHandle of future request process

head

public RequestHandle head(android.content.Context context,
                          java.lang.String url,
                          Header[] headers,
                          RequestParams params,
                          ResponseHandlerInterface responseHandler)

Perform a HTTP HEAD request and track the Android Context which initiated the request with customized headers

参数:

context - Context to execute request against

url - the URL to send the request to.

headers - set headers only for this request

params - additional HEAD parameters to send with the request.

responseHandler - the response handler instance that should handle the response.

返回:

RequestHandle of future request process

get

public RequestHandle get(java.lang.String url,
                         ResponseHandlerInterface responseHandler)

Perform a HTTP GET request, without any parameters.

参数:

url - the URL to send the request to.

responseHandler - the response handler instance that should handle the response.

返回:

RequestHandle of future request process

get

public RequestHandle get(java.lang.String url,
                         RequestParams params,
                         ResponseHandlerInterface responseHandler)

Perform a HTTP GET request with parameters.

参数:

url - the URL to send the request to.

params - additional GET parameters to send with the request.

responseHandler - the response handler instance that should handle the response.

返回:

RequestHandle of future request process

get

public RequestHandle get(android.content.Context context,
                         java.lang.String url,
                         ResponseHandlerInterface responseHandler)

Perform a HTTP GET request without any parameters and track the Android Context which initiated the request.

参数:

context - the Android Context which initiated the request.

url - the URL to send the request to.

responseHandler - the response handler instance that should handle the response.

返回:

RequestHandle of future request process

get

public RequestHandle get(android.content.Context context,
                         java.lang.String url,
                         RequestParams params,
                         ResponseHandlerInterface responseHandler)

Perform a HTTP GET request and track the Android Context which initiated the request.

参数:

context - the Android Context which initiated the request.

url - the URL to send the request to.

params - additional GET parameters to send with the request.

responseHandler - the response handler instance that should handle the response.

返回:

RequestHandle of future request process

get

public RequestHandle get(android.content.Context context,
                         java.lang.String url,
                         Header[] headers,
                         RequestParams params,
                         ResponseHandlerInterface responseHandler)

Perform a HTTP GET request and track the Android Context which initiated the request with customized headers

参数:

context - Context to execute request against

url - the URL to send the request to.

headers - set headers only for this request

params - additional GET parameters to send with the request.

responseHandler - the response handler instance that should handle the response.

返回:

RequestHandle of future request process

get

public RequestHandle get(android.content.Context context,
                         java.lang.String url,
                         HttpEntity entity,
                         java.lang.String contentType,
                         ResponseHandlerInterface responseHandler)

Perform a HTTP GET request and track the Android Context which initiated the request.

参数:

context - the Android Context which initiated the request.

url - the URL to send the request to.

entity - a raw { HttpEntity} to send with the request, for example, use this to send string/json/xml payloads to a server by passing a { org.apache.http.entity.StringEntity}.

contentType - the content type of the payload you are sending, for example application/json if sending a json payload.

responseHandler - the response ha ndler instance that should handle the response.

返回:

RequestHandle of future request process

post

public RequestHandle post(java.lang.String url,
                          ResponseHandlerInterface responseHandler)

Perform a HTTP POST request, without any parameters.

参数:

url - the URL to send the request to.

responseHandler - the response handler instance that should handle the response.

返回:

RequestHandle of future request process

post

public RequestHandle post(java.lang.String url,
                          RequestParams params,
                          ResponseHandlerInterface responseHandler)

Perform a HTTP POST request with parameters.

参数:

url - the URL to send the request to.

params - additional POST parameters or files to send with the request.

responseHandler - the response handler instance that should handle the response.

返回:

RequestHandle of future request process

post

public RequestHandle post(android.content.Context context,
                          java.lang.String url,
                          RequestParams params,
                          ResponseHandlerInterface responseHandler)

Perform a HTTP POST request and track the Android Context which initiated the request.

参数:

context - the Android Context which initiated the request.

url - the URL to send the request to.

params - additional POST parameters or files to send with the request.

responseHandler - the response handler instance that should handle the response.

返回:

RequestHandle of future request process

post

public RequestHandle post(android.content.Context context,
                          java.lang.String url,
                          HttpEntity entity,
                          java.lang.String contentType,
                          ResponseHandlerInterface responseHandler)

Perform a HTTP POST request and track the Android Context which initiated the request.

参数:

context - the Android Context which initiated the request.

url - the URL to send the request to.

entity - a raw { HttpEntity} to send with the request, for example, use this to send string/json/xml payloads to a server by passing a { org.apache.http.entity.StringEntity}.

contentType - the content type of the payload you are sending, for example application/json if sending a json payload.

responseHandler - the response ha ndler instance that should handle the response.

返回:

RequestHandle of future request process

post

public RequestHandle post(android.content.Context context,
                          java.lang.String url,
                          Header[] headers,
                          RequestParams params,
                          java.lang.String contentType,
                          ResponseHandlerInterface responseHandler)

Perform a HTTP POST request and track the Android Context which initiated the request. Set headers only for this request

参数:

context - the Android Context which initiated the request.

url - the URL to send the request to.

headers - set headers only for this request

params - additional POST parameters to send with the request.

contentType - the content type of the payload you are sending, for example application/json if sending a json payload.

responseHandler - the response handler instance that should handle the response.

返回:

RequestHandle of future request process

post

public RequestHandle post(android.content.Context context,
                          java.lang.String url,
                          Header[] headers,
                          HttpEntity entity,
                          java.lang.String contentType,
                          ResponseHandlerInterface responseHandler)

Perform a HTTP POST request and track the Android Context which initiated the request. Set headers only for this request

参数:

context - the Android Context which initiated the request.

url - the URL to send the request to.

headers - set headers only for this request

entity - a raw { HttpEntity} to send with the request, for example, use this to send string/json/xml payloads to a server by passing a { org.apache.http.entity.StringEntity}.

contentType - the content type of the payload you are sending, for example application/json if sending a json payload.

responseHandler - the response handler instance that should handle the response.

返回:

RequestHandle of future request process

put

public RequestHandle put(java.lang.String url,
                         ResponseHandlerInterface responseHandler)

Perform a HTTP PUT request, without any parameters.

参数:

url - the URL to send the request to.

responseHandler - the response handler instance that should handle the response.

返回:

RequestHandle of future request process

put

public RequestHandle put(java.lang.String url,
                         RequestParams params,
                         ResponseHandlerInterface responseHandler)

Perform a HTTP PUT request with parameters.

参数:

url - the URL to send the request to.

params - additional PUT parameters or files to send with the request.

responseHandler - the response handler instance that should handle the response.

返回:

RequestHandle of future request process

put

public RequestHandle put(android.content.Context context,
                         java.lang.String url,
                         RequestParams params,
                         ResponseHandlerInterface responseHandler)

Perform a HTTP PUT request and track the Android Context which initiated the request.

参数:

context - the Android Context which initiated the request.

url - the URL to send the request to.

params - additional PUT parameters or files to send with the request.

responseHandler - the response handler instance that should handle the response.

返回:

RequestHandle of future request process

put

public RequestHandle put(android.content.Context context,
                         java.lang.String url,
                         HttpEntity entity,
                         java.lang.String contentType,
                         ResponseHandlerInterface responseHandler)

Perform a HTTP PUT request and track the Android Context which initiated the request. And set one-time headers for the request

参数:

context - the Android Context which initiated the request.

url - the URL to send the request to.

entity - a raw { HttpEntity} to send with the request, for example, use this to send string/json/xml payloads to a server by passing a { org.apache.http.entity.StringEntity}.

contentType - the content type of the payload you are sending, for example application/json if sending a json payload.

responseHandler - the response handler instance that should handle the response.

返回:

RequestHandle of future request process

put

public RequestHandle put(android.content.Context context,
                         java.lang.String url,
                         Header[] headers,
                         HttpEntity entity,
                         java.lang.String contentType,
                         ResponseHandlerInterface responseHandler)

Perform a HTTP PUT request and track the Android Context which initiated the request. And set one-time headers for the request

参数:

context - the Android Context which initiated the request.

url - the URL to send the request to.

headers - set one-time headers for this request

entity - a raw { HttpEntity} to send with the request, for example, use this to send string/json/xml payloads to a server by passing a { org.apache.http.entity.StringEntity}.

contentType - the content type of the payload you are sending, for example application/json if sending a json payload.

responseHandler - the response handler instance that should handle the response.

返回:

RequestHandle of future request process

patch

public RequestHandle patch(java.lang.String url,
                           ResponseHandlerInterface responseHandler)

Perform a HTTP PATCH request, without any parameters.

参数:

url - the URL to send the request to.

responseHandler - the response handler instance that should handle the response.

返回:

RequestHandle of future request process

patch

public RequestHandle patch(java.lang.String url,
                           RequestParams params,
                           ResponseHandlerInterface responseHandler)

Perform a HTTP PATCH request with parameters.

参数:

url - the URL to send the request to.

params - additional PUT parameters or files to send with the request.

responseHandler - the response handler instance that should handle the response.

返回:

RequestHandle of future request process

patch

public RequestHandle patch(android.content.Context context,
                           java.lang.String url,
                           RequestParams params,
                           ResponseHandlerInterface responseHandler)

Perform a HTTP PATCH request and track the Android Context which initiated the request.

参数:

context - the Android Context which initiated the request.

url - the URL to send the request to.

params - additional PUT parameters or files to send with the request.

responseHandler - the response handler instance that should handle the response.

返回:

RequestHandle of future request process

patch

public RequestHandle patch(android.content.Context context,
                           java.lang.String url,
                           HttpEntity entity,
                           java.lang.String contentType,
                           ResponseHandlerInterface responseHandler)

Perform a HTTP PATCH request and track the Android Context which initiated the request.

参数:

context - the Android Context which initiated the request.

url - the URL to send the request to.

responseHandler - the response handler instance that should handle the response.

返回:

RequestHandle of future request process

patch

public RequestHandle patch(android.content.Context context,
                           java.lang.String url,
                           Header[] headers,
                           HttpEntity entity,
                           java.lang.String contentType,
                           ResponseHandlerInterface responseHandler)

Perform a HTTP PATCH request and track the Android Context which initiated the request. And set one-time headers for the request

参数:

context - the Android Context which initiated the request.

url - the URL to send the request to.

headers - set one-time headers for this request

entity - a raw { HttpEntity} to send with the request, for example, use this to send string/json/xml payloads to a server by passing a { org.apache.http.entity.StringEntity}.

contentType - the content type of the payload you are sending, for example application/json if sending a json payload.

responseHandler - the response handler instance that should handle the response.

返回:

RequestHandle of future request process

delete

public RequestHandle delete(java.lang.String url,
                            ResponseHandlerInterface responseHandler)

Perform a HTTP DELETE request.

参数:

url - the URL to send the request to.

responseHandler - the response handler instance that should handle the response.

返回:

RequestHandle of future request process

delete

public RequestHandle delete(android.content.Context context,
                            java.lang.String url,
                            ResponseHandlerInterface responseHandler)

Perform a HTTP DELETE request.

参数:

context - the Android Context which initiated the request.

url - the URL to send the request to.

responseHandler - the response handler instance that should handle the response.

返回:

RequestHandle of future request process

delete

public RequestHandle delete(android.content.Context context,
                            java.lang.String url,
                            Header[] headers,
                            ResponseHandlerInterface responseHandler)

Perform a HTTP DELETE request.

参数:

context - the Android Context which initiated the request.

url - the URL to send the request to.

headers - set one-time headers for this request

responseHandler - the response handler instance that should handle the response.

返回:

RequestHandle of future request process

delete

public void delete(java.lang.String url,
                   RequestParams params,
                   AsyncHttpResponseHandler responseHandler)

Perform a HTTP DELETE request.

参数:

url - the URL to send the request to.

params - additional DELETE parameters or files to send with the request.

responseHandler - the response handler instance that should handle the response.

delete

public RequestHandle delete(android.content.Context context,
                            java.lang.String url,
                            Header[] headers,
                            RequestParams params,
                            ResponseHandlerInterface responseHandler)

Perform a HTTP DELETE request.

参数:

context - the Android Context which initiated the request.

url - the URL to send the request to.

headers - set one-time headers for this request

params - additional DELETE parameters or files to send along with request

responseHandler - the response handler instance that should handle the response.

返回:

RequestHandle of future request process

delete

public RequestHandle delete(android.content.Context context,
                            java.lang.String url,
                            HttpEntity entity,
                            java.lang.String contentType,
                            ResponseHandlerInterface responseHandler)

Perform a HTTP DELETE request and track the Android Context which initiated the request.

参数:

context - the Android Context which initiated the request.

url - the URL to send the request to.

entity - a raw {HttpEntity} to send with the request, for example, use this to send string/json/xml payloads to a server by passing a {org.apache.http.entity.StringEntity}.

contentType - the content type of the payload you are sending, for example application/json if sending a json payload.

responseHandler - the response ha ndler instance that should handle the response.

返回:

RequestHandle of future request process

newAsyncHttpRequest

protected AsyncHttpRequest newAsyncHttpRequest(DefaultHttpClient client,
                                               HttpContext httpContext,
                                               HttpUriRequest uriRequest,
                                               java.lang.String contentType,
                                               ResponseHandlerInterface responseHandler,
                                               android.content.Context context)

Instantiate a new asynchronous HTTP request for the passed parameters.

参数:

client - HttpClient to be used for request, can differ in single requests

contentType - MIME body type, for POST and PUT requests, may be null

context - Context of Android application, to hold the reference of request

httpContext - HttpContext in which the request will be executed

responseHandler - ResponseHandler or its subclass to put the response into

uriRequest - instance of HttpUriRequest, which means it must be of HttpDelete, HttpPost, HttpGet, HttpPut, etc.

返回:

AsyncHttpRequest ready to be dispatched

sendRequest

protected RequestHandle sendRequest(DefaultHttpClient client,
                                    HttpContext httpContext,
                                    HttpUriRequest uriRequest,
                                    java.lang.String contentType,
                                    ResponseHandlerInterface responseHandler,
                                    android.content.Context context)

Puts a new request in queue as a new thread in pool to be executed

参数:

client - HttpClient to be used for request, can differ in single requests

contentType - MIME body type, for POST and PUT requests, may be null

context - Context of Android application, to hold the reference of request

httpContext - HttpContext in which the request will be executed

responseHandler - ResponseHandler or its subclass to put the response into

uriRequest - instance of HttpUriRequest, which means it must be of HttpDelete, HttpPost, HttpGet, HttpPut, etc.

返回:

RequestHandle of future request process

getURI

protected java.net.URI getURI(java.lang.String url)

Returns a URI instance for the specified, absolute URL string.

参数:

url - absolute URL string, containing scheme, host and path

返回:

URI instance for the URL string

setURLEncodingEnabled

public void setURLEncodingEnabled(boolean enabled)

Sets state of URL encoding feature, see bug #227, this method allows you to turn off and on this auto-magic feature on-demand.

参数:

enabled - desired state of feature

getUrlWithQueryString

public static java.lang.String getUrlWithQueryString(boolean shouldEncodeUrl,
                                                     java.lang.String url,
                                                     RequestParams params)

Will encode url, if not disabled, and adds params on the end of it

参数:

url - String with URL, should be valid URL without params

params - RequestParams to be appended on the end of URL

shouldEncodeUrl - whether url should be encoded (replaces spaces with %20)

返回:

encoded url if requested with params appended if any available

isInputStreamGZIPCompressed

public static boolean isInputStreamGZIPCompressed(java.io.PushbackInputStream inputStream)
                                           throws java.io.IOException

Checks the InputStream if it contains GZIP compressed data

参数:

inputStream - InputStream to be checked

返回:

true or false if the stream contains GZIP compressed data

抛出:

java.io.IOException

silentCloseInputStream

public static void silentCloseInputStream(java.io.InputStream is)

A utility function to close an input stream without raising an exception.

参数:

is - input stream to close safely

silentCloseOutputStream

public static void silentCloseOutputStream(java.io.OutputStream os)

A utility function to close an output stream without raising an exception.

参数:

os - output stream to close safely

isUrlEncodingEnabled

public boolean isUrlEncodingEnabled()

endEntityViaReflection

public static void endEntityViaReflection(HttpEntity entity)

This horrible hack is required on Android, due to implementation of BasicManagedEntity, which doesn't chain call consumeContent on underlying wrapped HttpEntity

参数:

entity - HttpEntity, may be null