简介
基于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.
?
?
结束
?
?
?
?
?
?
?
?
?
?
?
?
?
?
?
?
?
?
?