android-async-http使用

android-async-http是基于Apache HttpClient专门用于android的异步http请求，所有的请求都在非UI线程执行。API比较全面，使用比较简单，而且在CallBack中使用了Handler消息机制，我们可以在回调方法onSuccess，onFailure等中直接对UI进行操作。

GIT官方源码：https://github.com/loopj/android-async-http

官方使用教程：http://loopj.com/android-async-http/

我们通过官方教程首先来了解下其相关特性：

1，用HttpClient代替Android提供的DefaultHttpClient；

2，兼容Android API 23以及更高；

3，发送异步http请求，在匿名的callback对象中处理response信息；

4，在非UI线程执行http请求；

5，使用线程池处理并发请求；

6，RequestParams作为GET/POST参数构造器；

7，多部件文件上传，不需要引入第三方库；

8，JSON数据流上传，不需要引入库；

9，能处理循环行和相对重定向；

10，对应用来说库很小，总共只有90KB；

11，使多种多样的移动连接具备良好自动智能请求重试机制；

12，支持超快速请求的自动gzip响应解码；

13，BinaryHttpResponseHandler支持二进制通讯协议；

14，通过JsonHttpResponseHandler实现内置解析response成JSON格式；

15，通过FileAsyncHttpResponseHandler实现直接将response写入保存到文件中；

16，持久化的cookie存储，将cookie保存到应用程序的SharePreferences中；

17，通过BaseJsonHttpResponseHandler集成Jackson Json，Gson和其他的JSON序列化库；

18，通过SaxAsyncHttpResponseHandler支持SAX解析；

19，支持各种语言和内容编码，不是只有UTF-8；

集成方法：

在GIT源码中有介绍，这里不详细说，我们这里用的Android studio，只要在app/build.gradle文件加上：

dependencies {
    ......
    compile 'com.loopj.android:android-async-http:1.4.9'
}

使用步骤：

1，创建AsyncHttpClient对象；

2，如果需要参数，可以创建RequestParams对象添加参数，如果不需要参数，这一步可免；

3，按需要调用AsyncHttpClient的某个GET/POST的方法，传递需要的callback接口实现。

基础体验：

首先给出一个官方教程的建议，封装静态的HttpClient：

public class TwitterRestClient {
  private static final String BASE_URL = "https://......";

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

这样封装好了使用起来特别方便：

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

以上内容来自官方教程，详细请看： 官方文档

每次请求都需要传递一个实现ResponseHandlerInterface接口的实例，用来接收处理回调的事件，一般都继承AsyncHttpResponseHandler。

1，首先看下AsyncHttpResponseHandler：

                RequestParams params = new RequestParams();
                TestHttpClient.get(AsyncHttpActivity.this, url, params, new AsyncHttpResponseHandler() {
                    @Override
                    public void onSuccess(int statusCode, Header[] headers, byte[] responseBody) {

                    }

                    @Override
                    public void onFailure(int statusCode, Header[] headers, byte[] responseBody, Throwable error) {

                    }
                });

可以看出，返回的结果是byte类型的，可以转换成我们需要的格式。默认重写了onSuccess和onFailure两个方法，还可以重写onStart、onFinish、onCancle、onRetry等方法来实现数据的获取以及与界面的交互效果。

,2，BinaryHttpResponseHandler继承自AsyncHttpResponseHandler，可以发送二进制请求，如请求图片等：

                RequestParams params = new RequestParams();
                TestHttpClient.get(AsyncHttpActivity.this, url, params, new BinaryHttpResponseHandler() {
                    @Override
                    public void onSuccess(int statusCode, Header[] headers, byte[] binaryData) {

                    }

                    @Override
                    public void onFailure(int statusCode, Header[] headers, byte[] binaryData, Throwable error) {
                        
                    }
                });

这里返回给我们的也是byte类型，我们可以转换成Bitmap等。

3，TextHttpResponseHandler，继承自AsyncHttpResponseHandler，只重写了onSuccess和onFailure两个方法。

                RequestParams params = new RequestParams();
                TestHttpClient.get(AsyncHttpActivity.this, url, params, new TextHttpResponseHandler() {
                    @Override
                    public void onFailure(int statusCode, Header[] headers, String responseString, Throwable throwable) {

                    }

                    @Override
                    public void onSuccess(int statusCode, Header[] headers, String responseString) {
                        
                    }
                });

返回的结果由原来的byte类型转换成了String类型。

4，JsonHttpResponseHandler，继承自TextHttpResponseHandler，同样只重写了onSuccess和onFailure两个方法。

               RequestParams params = new RequestParams();
                TestHttpClient.get(AsyncHttpActivity.this, url, params, new JsonHttpResponseHandler(){
                    @Override
                    public void onSuccess(int statusCode, Header[] headers, JSONObject response) {
                        super.onSuccess(statusCode, headers, response);
                    }
                    @Override
                    public void onSuccess(int statusCode, Header[] headers, JSONArray response) {
                        super.onSuccess(statusCode, headers, response);
                    }
                    @Override
                    public void onSuccess(int statusCode, Header[] headers, String responseString) {
                        super.onSuccess(statusCode, headers, responseString);
                    }

                    @Override
                    public void onFailure(int statusCode, Header[] headers, String responseString, Throwable throwable) {
                        super.onFailure(statusCode, headers, responseString, throwable);
                    }
                    @Override
                    public void onFailure(int statusCode, Header[] headers, Throwable throwable, JSONObject errorResponse) {
                        super.onFailure(statusCode, headers, throwable, errorResponse);
                    }
                    @Override
                    public void onFailure(int statusCode, Header[] headers, Throwable throwable, JSONArray errorResponse) {
                        super.onFailure(statusCode, headers, throwable, errorResponse);
                    }
                });

这里有三个onSuccess和onFailure方法供重写，返回的结果分别转换成JSONObject、JSONArray和String类型。按照不同的返回值类型调用不同的方法，这个比较烦。

5，BaseJsonHttpResponseHandler，继承自TextHttpResponseHandler，同样只重写了onSuccess、onFailure两个方法，另外添加了一个方法parseResponse。

                RequestParams params = new RequestParams();
                TestHttpClient.get(AsyncHttpActivity.this, url, params, new BaseJsonHttpResponseHandler