上一篇中我们介绍了OkHttp3.0框架的基本使用方法，这一篇我们学习一下Android的另外一个网络请求框架——AsyncHttpClient框架。Asynchttpclient框架是一个开源的异步网络请求框架，所有的网络都在Android的非UI线程中，通过回调方法处理请求结果，无论是向网络请求数据还是上传数据都非常方便，而且这个框架非常体积非常小，只有90K左右的大小，我们可以轻松使用它，下面我们介绍一下这个框架：
概述
Asynchttpclient框架有如下的特征：
处理异步Http请求，并通过匿名内部类处理回调结果
Http异步请求均位于非UI线程，不会阻塞UI操作
通过线程池处理并发请求处理文件上传、下载,响应结果自动打包JSON格式
自动处理连接断开时请求重连
永久的cookie保存，内部实现用的是Android的SharedPreferences
通过BaseJsonHttpResponseHandler和各种json库集成
支持SAX解析器
支持各种语言和content编码，不仅仅是UTF-8
自动的gzip响应解码
内置多种形式的响应解析，有原生的字节流，string，json对象，甚至可以将response写到文件中
这里只是简单的介绍一下，具体需要实现细节需要我们在开发中实际去体会。
我们来学习一下Asynchttpclient里面的具体的类：
AsyncHttpRequest类：继承自Runnabler，被submit至线程池执行网络请求并发送start，success等消息
AsyncHttpResponseHandler类：接收请求结果，一般重写onSuccess及onFailure接收请求成功或失败的消息，还有onStart，onFinish等消息
TextHttpResponseHandler类：继承自AsyncHttpResponseHandler，只是重写了AsyncHttpResponseHandler的onSuccess和onFailure方法，将请求结果由byte数组转换为String
JsonHttpResponseHandler类：继承自TextHttpResponseHandler，同样是重写onSuccess和onFailure方法，将请求结果由String转换为JSONObject或JSONArray
BaseJsonHttpResponseHandler类：继承自TextHttpResponseHandler，是一个泛型类，提供了parseResponse方法，子类需要提供实现，将请求结果解析成需要的类型，子类可以灵活地使用解析方法，可以直接原始解析，使用gson等
RequestParams类：请求参数，可以添加普通的字符串参数，并可添加File，InputStream上传文件
AsyncHttpClient类：核心类，使用HttpClient执行网络请求，提供了get，put，post，delete，head等请求方法，使用起来很简单，只需以url及RequestParams调用相应的方法即可，还可以选择性地传入Context，用于取消Content相关的请求，同时必须提供ResponseHandlerInterface（AsyncHttpResponseHandler继承自ResponseHandlerInterface）的实现类，一般为AsyncHttpResponseHandler的子类，AsyncHttpClient内部有一个线程池，当使用AsyncHttpClient执行网络请求时，最终都会调用sendRequest方法，在这个方法内部将请求参数封装成AsyncHttpRequest（继承自Runnable）交由内部的线程池执行
SyncHttpClient类：继承自AsyncHttpClient，同步执行网络请求，AsyncHttpClient把请求封装成AsyncHttpRequest后提交至线程池，SyncHttpClient把请求封装成AsyncHttpRequest后直接调用它的run方法
这里就不介绍里面的方法了，具体的可以去Github看一下源码：https://github.com/loopj/android-async-http
或者可以看一下API：https://loopj.com/android-async-http/doc/
再简单介绍一下Asynchttpclient框架的请求流程：
首先调用AsyncHttpClient的get或post等方法发起网络请求
所有的请求都走了sendRequest，在sendRequest中把请求封装为了AsyncHttpRequest，并添加到线程池执行
当请求被执行时（即AsyncHttpRequest的run方法），执行AsyncHttpRequest的makeRequestWithRetries方法执行实际的请求，当请求失败时可以重试。并在请求开始，结束，成功或失败时向请求时传的ResponseHandlerInterface实例发送消息
基本上使用的都是AsyncHttpResponseHandler的子类，调用其onStart，onSuccess等方法返回请求结果
关于Asynchttpclient就简单介绍到这里，下面介绍一下Asynchttpclient的具体使用
使用
Asynchttpclient框架的使用步骤基本是：
创建一个AsyncHttpClient对象
通过RequestParams对象设置请求参数，这个是可选择的
调用AsyncHttpClient对象里面的方法，实现请求或者上传数据。这里需要实现内部类回调，框架自己有实现有，不需要我们自己手动实现，我们只需要调用即可。
如果是在Android Studio中使用，需要在gradle中添加：
compile 'com.loopj.android:android-async-http:1.4.9'
如果是Eclipse的话需要去GitHub或者官网下载相应版本的JAR吧，GitHub地址在上文中有给出，下面是Asynchttpclient的官网：http://loopj.com/android-async-http/
下面看一下具体的代码：
AsyncHttpClient client = new AsyncHttpClient();
client.get("https://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
}
});
这里是Get请求的写法，官方推荐我们使用静态的写法：
import com.loopj.android.http.*;
public class TwitterRestClient {
private static final String BASE_URL = "https://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;
}
}
这样方便我们使用。
下面我们使用这个框架实现GET请求、POST请求、文件上传、文件下载这四个功能，这里没有实现保存Cookie的功能，有需要的可以扩展实现：
实现GET请求
我们先看一下具体实现的代码：
AsyncHttpUtils.get(UrlUtils.REQUEST_URL + UrlUtils.URL_KEY, null, new JsonHttpResponseHandler() {
@Override
public void onSuccess(int statusCode, Header[] headers, JSONObject response) {
super.onSuccess(statusCode, headers, response);
Log.i(TAG, getResources().getString(R.string.req_success));
Log.i(TAG, "======================================================================");
Log.i(TAG, response.toString());
Log.i(TAG, "======================================================================");
}
@Override
public void onFailure(int statusCode, Header[] headers, Throwable throwable, JSONArray errorResponse) {
super.onFailure(statusCode, headers, throwable, errorResponse);
Log.i(TAG, getResources().getString(R.string.req_failed));
}
});
这样就可以实现一个GET请求，请求是在非UI线程中，有请求成功的回调和请求失败的回调，我们更新UI需要通过发消息或者其它方式实现，不能再请求成功的回调方法里面直接更新UI。其中RequestParams是可以选择的，没有请求参数可以直接设置为null。非常简单，就不在做过多的介绍了。
实现POST请求
我们还是先看一下具体的代码：
RequestParams requestParams = new RequestParams();
requestParams.put("username", "Devin");
requestParams.put("password", "Devin");
AsyncHttpUtils.post(UrlUtils.POST_URL, requestParams, new AsyncHttpResponseHandler() {
@Override
public void onSuccess(int statusCode, Header[] headers, byte[] responseBody) {
Log.i(TAG, getResources().getString(R.string.req_success));
}
@Override
public void onFailure(int statusCode, Header[] headers, byte[] responseBody, Throwable error) {
Log.i(TAG, getResources().getString(R.string.req_failed));
}
});
POST请求需要上传一些参数，框架提供了设置参数的类RequestParams，其中，RequestParams类似于Map，是键值对的形式，添加请求参数有三种方式：
第一种就是像我上面代码一样，创建一个空的RequestParams对象，然后通过put方法将参数写入；
第二种则是创建的时候就直接添加，例如：
RequestParams params = new RequestParams("single", "value");
第三种是将参数写入一个Map中，然后将Map赋给RequestParams，例如：
HashMap<String, String> paramMap = new HashMap<String, String>();
paramMap.put("key", "value");
RequestParams params = new RequestParams(paramMap);
这三种方式无论哪一种都可以实现封装请求参数。
实现文件上传
使用Asynchttpclient实现文件上传也非常简单，我们先看一下代码：
RequestParams requestParams = new RequestParams();
File file = new File("/sdcard/okhttp-3.4.1.jar");
try {
requestParams.put("file", file);
AsyncHttpUtils.post(UrlUtils.UPLOAD_URL, requestParams, new AsyncHttpResponseHandler() {
@Override
public void onSuccess(int statusCode, Header[] headers, byte[] responseBody) {
Log.i(TAG, getResources().getString(R.string.req_success));
}
@Override
public void onFailure(int statusCode, Header[] headers, byte[] responseBody, Throwable error) {
Log.i(TAG, getResources().getString(R.string.req_failed));
}
});
} catch (FileNotFoundException e) {
e.printStackTrace();
}
可以看到，这里文件上传是将文件封装到RequestParams中的，Asynchttpclient框架提供的封装文件到RequestParams中有三种方法，分别是：
第一种是将文件转成流的形式封装到RequestParams中，例如：
InputStream myInputStream = blah;
RequestParams params = new RequestParams();
params.put("secret_passwords", myInputStream, "passwords.txt");
第二种就是像上面的代码一样，将文件直接封装到RequestParams中
第三种是将文件转成二进制数组的形式，例如：
byte[] myByteArray = blah;
RequestParams params = new RequestParams();
params.put("soundtrack", new ByteArrayInputStream(myByteArray), "she-wolf.mp3");
这三种方法无论哪一种都可以实现封装文件到RequestParams中，然后调用AsyncHttpClient对象中的方法实现上传，具体使用哪一种看个人喜欢了。
实现文件下载
使用Asynchttpclient框架实现文件下载也非常简单，我们先看一下代码：
AsyncHttpUtils.download(UrlUtils.DOWNLOAD_URL, null, new FileAsyncHttpResponseHandler(getActivity()) {
@Override
public void onFailure(int statusCode, Header[] headers, Throwable throwable, File file) {
Log.i(TAG, getResources().getString(R.string.req_failed));
}
@Override
public void onSuccess(int statusCode, Header[] headers, File file) {
Log.i(TAG, getResources().getString(R.string.req_success));
}
});
实现文件下载，回调选择的就是FileAsyncHttpResponseHandler这个Asynchttpclient框架提供的类，这可以非常方便的实现文件的下载。
关于Asynchttpclient框架就简单介绍到这里了，还有保存Cookie这个功能没有实现，不过实现也非常简单，不懂得可以看一下官方的文档，官网地址上文中有给出了。
文中Demo已经上传到GitHub中，有兴趣的可以去了解一下：https://github.com/Devin1102/AndroidFrameDemo
最后，欢迎留言交流学习！
