首页 > 代码库 > Android开源库--Asynchronous Http Client异步http客户端

Android开源库--Asynchronous Http Client异步http客户端

如果说我比别人看得更远些,那是因为我站在了巨人的肩上。

github地址:https://github.com/loopj/android-async-http

Api文档地址:http://loopj.com/android-async-http/doc/

http通信作为开发android最基本的模块,相信大家开发网络应用时都会需要用到。

在初学android的时候自己通过Apache的HttpClient类库实现了一个简单的http通信模块,线程安全,每次都要新建一个线程,通过Hander完成异步加载。

后面通过github找到了这个类库,原理也类似,也用的是Apache的HttpClient,而Android官方的类库是HttpUrlConnection。

目前还没有认真研究过源码,设计封装的很好,今天就主要介绍一下这个类库。

介绍

AHC是基于Apache的HttpClient 库,所有的网络请求过程在UI线程之外进行,而回调是在Handler里面处理。也可以再Service或者后台程序里面使用,这个库会自动识别并在相应的Context进行处理。

特性

  1. 异步发送HTTP请求,在回调函数中处理响应
  2. HTTP请求过程不在UI线程进行
  3. 使用线程池来管理并发数
  4. 支持GET/POST请求参数单独设置
  5. 无需其他库上传序列化JSON数据
  6. 处理重定向
  7. 体积小,只有90K
  8. 针对不同的网络连接对重试次数进行智能优化
  9. 支持gzip
  10. 二进制通信协议使用BinaryHttpResponseHandler处理
  11. 内置Json解析,使用JsonHttpResponseHandler对响应进行处理
  12. 使用FileAsyncHttpResponseHandler直接将响应保存到文件中
  13. 动态保存Cookie,将Cookie保存到应用的SharedPreferences中
  14. 使用BaseJsonHttpResponseHandler可以搭配Jackson JSON,Gson或者其他的Json反序列化库
  15. 支持SAX解析,使用SaxAsyncHttpResponseHandler
  16. 支持多语言多种编码方式,不只是UTF-8

主要类介绍

  • 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方法。

 

使用方法在官方网站写的比较详细,demo里面也有,大家看看就懂了

以上内容参考:

http://www.cnblogs.com/angeldevil/p/3729808.html

http://blog.csdn.net/qduningning/article/details/34829429

 

目前主流数据都是用REST模式,json格式通信,因为我还是比较喜欢Gson(因为可以直接泛型转换),JsonHttpResponseHandler用不习惯。在实际项目中我又自己封装了一次,使用TextHttpResponseHandler获取结果后,用Gson解析。

android-async-http的封装

import com.loopj.android.http.AsyncHttpClient;import com.loopj.android.http.AsyncHttpResponseHandler;import com.loopj.android.http.RequestParams;public class RestHttpUtils {    private static AsyncHttpClient client = new AsyncHttpClient();    static {        client.addHeader("accept", "application/json");    }    public static void get(String url, RequestParams params, AsyncHttpResponseHandler responseHandler) {        client.get(url, params, responseHandler);    }    public static void get(String url, AsyncHttpResponseHandler responseHandler) {        client.get(url, null, responseHandler);    }    public interface RestHttpHandler<T> {        public  void onSuccess(T result);    }}

Gson的封装

public class GsonUtils {    private static Gson _gson = new Gson();    public static <T> T parse(String json, Class<T> T) {        return _gson.fromJson(json, T);    }    public static <T> T parseList(String json, Type type) {        return _gson.fromJson(json, type);    }}

业务逻辑Controller

public class Controller {
public static void getDetail(final Context ctx, int id, final RestHttpHandler<Entity> handler) { RestHttpUtils.get(ApiUrls.getDetail() + "/id/" + id, new TextHttpResponseHandler() { @Override public void onFailure(int arg0, Header[] arg1, String arg2, Throwable arg3) { Toast.makeText(ctx, "获取详情失败", Toast.LENGTH_SHORT).show(); } @Override public void onSuccess(int arg0, Header[] arg1, String arg2) { Entity result = GsonUtils.parse(arg2, Entity.class); handler.onSuccess(result); } }); }
}

具体使用

Controller.getDetail(DetailActivity.this, getIntent().getIntExtra("Id", 0),                new RestHttpHandler<Entity>() {                    @Override                    public void onSuccess(Entity result) {
              //获取结果,进行一系列ui操作 }
});

 

Android开源库--Asynchronous Http Client异步http客户端