Android Asynchronous Http Client 中文手册 1.4.6

简介

基于Apache的HttpClient 的一个android异步包.

回调逻辑执行的线程 == 创建Callback的线程（不是创建Httpclient的线程）

举例：

 

 new Thread(new Runnable() {
                @Override
                public void run() {
                    Log.d(LOG_TAG, "Before Request");
                    client.get(Activity.this, URL, headers, null, responseHandler);
                    Log.d(LOG_TAG, "After Request");
                }
            }).start();

//在callback的时候，就要用runOnUiThread

 

 

 

特点：

1.异步请求，匿名回调处理响应

2.http请求在UI线程之外

3.请求试用线程池，共用资源

4.GET/POST 参数构建（RequestParams）

5.多文件上传，并且不需要多余3方库

6.JSON流上传

7.处理循环和定向跳转

8.包只有90k

9.自动重连，根据不同的网络连接方式

10.2进制通讯协议BinaryHttpResponseHandler

11.内置JSON解析JsonHttpResponseHandler

12.文件保存FileAsyncHttpResponseHandler

13。持续cookie存储，保存在SharedPreferences里

14支持多个Json解析，包括GSON，使用BaseJsonHttpResponseHandler

15.支持SAX解析SaxAsyncHttpResponseHandler

16.支持多语言，不止UTF8

 

top榜上的应用

。。。

 

安装和使用

安装

 

compile 'com.loopj.android:android-async-http:1.4.5'

 包含

 

 

import com.loopj.android.http.*;

 创建一个异步的请求

 

 

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
	}
});

 

 

最佳实践：创建静态的Http client

创建静态的一个Httpclient类

 

import com.loopj.android.http.*;

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;
  }
}

 很方便的使用

 

 

import org.json.*;
import com.loopj.android.http.*;

class TwitterRestClientUsage {
    public void getPublicTimeline() throws JSONException {
        TwitterRestClient.get("statuses/public_timeline.json", null, new JsonHttpResponseHandler() {
            @Override
            public void onSuccess(int statusCode, Header[] headers, JSONObject response) {
                // If the response is JSONObject instead of expected JSONArray
            }
            
            @Override
            public void onSuccess(int statusCode, Header[] headers, JSONArray timeline) {
                // Pull out the first event on the public timeline
                JSONObject firstEvent = timeline.get(0);
                String tweetText = firstEvent.getString("text");

                // Do something with the response
                System.out.println(tweetText);
            }
        });
    }
}

 更多的可以看文档： AsyncHttpClient, RequestParams and AsyncHttpResponseHandler

 

 

持续的Cookie的存储 PersistentCookieStore

库中包含PersistentCookieStore是实现了Apache的HttpClient的CookieStore接口，会自动持续存储

下面是一个例子：

AsyncHttpClient myClient = new AsyncHttpClient();
//设置要存储的Cookie对象
PersistentCookieStore myCookieStore = new PersistentCookieStore(this);
myClient.setCookieStore(myCookieStore);
//等收到响应的时候，对象会自动存储起来。
//还可以自己添加cookie

 

更多的看 PersistentCookieStore Javadoc

 

添加 参数

RequestParams params = new RequestParams();
params.put("key", "value");
params.put("more", "data");

//方法二
RequestParams params = new RequestParams("single", "value");

//方法三
HashMap<String, String> paramMap = new HashMap<String, String>();
paramMap.put("key", "value");
RequestParams params = new RequestParams(paramMap);

 See the RequestParams Javadoc for more information.

 

上传文件（RequestParams）

可进行多文件上传

//以流的形式
InputStream myInputStream = blah;
RequestParams params = new RequestParams();
params.put("secret_passwords", myInputStream, "passwords.txt");

//以File文件
File myFile = new File("/path/to/file.png");
RequestParams params = new RequestParams();
try {
    params.put("profile_picture", myFile);
} catch(FileNotFoundException e) {}

//以byte[]
byte[] myByteArray = blah;
RequestParams params = new RequestParams();
params.put("soundtrack", new ByteArrayInputStream(myByteArray), "she-wolf.mp3");

 See the RequestParams Javadoc for more information.

 

下载二进制文件（FileAsyncHttpResponseHandler)

AsyncHttpClient client = new AsyncHttpClient();
client.get("http://example.com/file.png", new FileAsyncHttpResponseHandler() {
    @Override
    public void onSuccess(int statusCode, Header[] headers, File response) {
        // Do something with the file `response`
    }
});

 See the FileAsyncHttpResponseHandler Javadoc for more information.

 

添加http基本授权认证

很多请求要带有 用户名/密码 授权。

AsyncHttpClient client = new AsyncHttpClient();
client.setBasicAuth("username","password/token");
client.get("http://example.com");

AsyncHttpClient client = new AsyncHttpClient();
client.setBasicAuth("username","password", new AuthScope("example.com", 80, AuthScope.ANY_REALM));
client.get("http://example.com");

 See the RequestParams Javadoc for more information.

 

 

结束