上一篇中我们介绍了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方法

再简单介绍一下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 paramMap = new HashMap();

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这个功能没有实现，不过实现也非常简单，不懂得可以看一下官方的文档，官网地址上文中有给出了。

最后，欢迎留言交流学习！