標籤:android-async-http 非同步請求
介紹:
Android-Async-Http是一個Android的開源網路請求類庫。官方項目地址:http://loopj.com/android-async-http/。網路請求無非就是從伺服器上擷取資料,往伺服器上上傳資料,這個網路請求庫是基於Apache HttpClient庫之上的一個非同步網路請求處理庫,網路處理均基於Android的非UI線程,不會阻塞主UI線程,並且通過回調方法處理請求結果。Android-Async-Http處理正常的擷取內容,下載,上傳,包括帶cookies訪問都是沒有問題的,大名鼎鼎的Instagram就是用的這個類庫。
使用:
從官網下載依賴jar包,匯入工程中libs檔案夾下並添加到工程路徑即可。
先看一下基本用法:
AsyncHttpClient client = new AsyncHttpClient();client.get("http://www.google.com", new AsyncHttpResponseHandler() { @Override public void onStart() { // called before request is started } @Override public void onSuccess(int statusCode, Header[] headers, byte[] response) { // called when response HTTP status is "200 OK" } @Override public void onFailure(int statusCode, Header[] headers, byte[] errorResponse, Throwable e) { // called when response HTTP status is "4XX" (eg. 401, 403, 404) } @Override public void onRetry(int retryNo) { // called when request is retried}}); 可以看出,所有的網路請求都是通過AsyncHttpClient執行個體來實現的。
類庫的目錄結構
先看下主要的類的介紹:
- AsyncHttpClient:非同步請求用戶端,類庫進行網路請求的執行個體
- AsyncHttpRequest:繼承Runnabler,被submit至線程池執行網路請求並發送start,success等訊息
- AsyncHttpResponseHandler:處理網路請求成功 失敗 開始 完成 等自訂的訊息
- BaseJsonHttpResponseHandler:繼承TextHttpResponseHandler,是一個泛型類,提供了parseResponse方法,子類需要提供實現,將請求結果解析成需要的類型。
- BinaryHttpResponseHandler :繼承 AsyncHttpResponseHandler ,位元組流返回處理 該庫用於處理圖片等
- JsonHttpResponseHandler:繼承TextHttpResponseHandler,同樣是重寫onSuccess和onFailure方法,將請求結果由String轉換為JSONObject或JSONArray
- SerializableCookie:整合 Serializable,用於序列化cookie,以便存取cookie
- TextHttpResponseHandler:繼承AsyncHttpResponseHandler,重寫了AsyncHttpResponseHandler的onSuccess和onFailure方法,將請求結果由byte數群組轉換為String
官方建議使用一個靜態AsyncHttpClient,官方樣本:
public class TwitterRestClient { private static final String BASE_URL = "http://api.twitter.com/1/"; private static AsyncHttpClient client = new AsyncHttpClient(); public static void get(String url, RequestParams params, AsyncHttpResponseHandler responseHandler) { client.get(getAbsoluteUrl(url), params, responseHandler); } public static void post(String url, RequestParams params, AsyncHttpResponseHandler responseHandler) { client.post(getAbsoluteUrl(url), params, responseHandler); } private static String getAbsoluteUrl(String relativeUrl) { return BASE_URL + relativeUrl; }} 在用的時候,我們可以直接通過類名調用需要的要求方法,你可以多封裝一些不同的要求方法,比如參數不同的方法,下載方法,上傳方法等。
這是我自己的封裝好的一些常用的方法:
public class HttpUtil {private static AsyncHttpClient httpclient = new AsyncHttpClient();static{httpclient.setTimeout(5000);}public static void get(String urlString,AsyncHttpResponseHandler res) //用一個完整url擷取一個string對象 {httpclient.get(urlString, res); } public static void get(String urlString,RequestParams params,AsyncHttpResponseHandler res) //url裡面帶參數 { httpclient.get(urlString, params,res); } public static void get(String urlString,JsonHttpResponseHandler res) //不帶參數,擷取json對象或者數組 { httpclient.get(urlString, res); } public static void get(String urlString,RequestParams params,JsonHttpResponseHandler res) //帶參數,擷取json對象或者數組 { httpclient.get(urlString, params,res); } public static void get(String uString, BinaryHttpResponseHandler bHandler) //下載資料使用,會返回byte資料 { httpclient.get(uString, bHandler); } public static void post(String uString,RequestParams params, JsonHttpResponseHandler bHandler) //post資料使用,會返回json資料 { httpclient.post(uString,params,bHandler); } public static void post(String uString,RequestParams params,AsyncHttpResponseHandler res) //post資料使用,返回普通的手 { httpclient.post(uString, params,res); } public static AsyncHttpClient getClient() { return httpclient; }}
Android-Async-Http使用記錄