Android平台下轻量级http网络传输库

AsyncHttpHelp是一个android平台下基于httpclient开发的HTTP网络请求工具。

优点

• 功能齐全，提供常用的http网络访问接口。
• 轻量级，无任何第三方库依赖，库大小为90K左右。
• 定制化，自定义json解析库，支持请求参数，返回内容预处理。
• 易用性，简单易用，只需几行代码即可完成请求，可随意设置cookie、http头部等信息。
  

功能

1、普通get请求
2、普通post请求
3、Form表单提交数据
4、二进制数据传输
5、json格式内容传输（json字符串自动转java对象，java对象自动转json字符串）
6、普通文件上传/下载
7、断点上传/下载
8、分块上传文件
9、session保持
10、自定义cookie、http头部信息等
11、取消请求
12、自定义json解析器
13、请求内容，返回内容预处理
14、设置请求结果是否在UI线程执行
测试示例

用法示例

GET请求

AsyncHttpRequest request = new AsyncHttpUtil.Builder()
      .url("http://www.luoxudong.com/")
      .setCallable(new SimpleRequestCallable() {
        @Override
        public void onFailed(int errorCode, String errorMsg) {
          //请求失败
        }

        @Override
        public void onSuccess(String responseInfo) {
          //请求成功
        }
      })
      .build().get();

GET请求（返回结果为JSON，自动转换成JAVA对象）

  AsyncHttpRequest request = new AsyncHttpUtil.Builder()
      .url("http://www.bchun.com/fund/service.do?func=getProvinces")
      .setResponseClass(Response.class)//返回的json对象类型，自动转换改类的对象
      .setJsonResponseInterceptor(new JsonResponseInterceptor<Response>() {//返回结果拦截器，方便自定义json解析器以及对返回结果作简单预处理。
        @Override
        public Response convertJsonToObj(String responseStr, Class<Response> mResponseClass) {
          return new Gson().fromJson(responseStr, mResponseClass);
        }

        @Override
        public boolean checkResponse(Response response) {//可以根据返回的结果判定该请求是否成功，如果返回true，则在callable中调用onSuccess回调方法，为false时调用onFailed回调方法
          if (response.getServerResult().getResultCode() == 0){
            return true;
          }
          setErrorCode(AsyncHttpExceptionCode.defaultExceptionCode.getErrorCode());
          setErrorMsg(response.getServerResult().getResultMessage());
          return false;
        }

      })
      .setCallable(new JsonRequestCallable<Response>() {//回调

        @Override
        public void onFailed(int errorCode, String errorMsg) {
          //请求失败
        }

        @Override
        public void onSuccess(Response responseInfo) {
          //请求成功
        }
      })
      .build().get();

POST请求

 AsyncHttpRequest request = new AsyncHttpUtil.Builder()
      .url("http://www.bchun.com/fund/service.do?func=getProvinces")
      .setStrBody("body内容")//post内容
      .setCallable(new SimpleRequestCallable() {
        @Override
        public void onFailed(int errorCode, String errorMsg) {
          //请求失败
        }

        @Override
        public void onSuccess(String responseInfo) {
          //请求成功
        }
      })
      .build().post();

POST请求（模拟Form表单）

  AsyncHttpRequest request = new AsyncHttpUtil.Builder()
      .url("http://www.bchun.com/fund/service.do?func=getProvinces")
      .addFormData("a", "1")//设置form表单数据，也可以调用setFormDatas方法
      .addFormData("b", "luoxudong")
      .setCallable(new SimpleRequestCallable() {
        @Override
        public void onFailed(int errorCode, String errorMsg) {
          //请求失败
        }

        @Override
        public void onSuccess(String responseInfo) {
          //请求成功
        }
      })
      .build().post();

POST请求（内容为二进制数据）

  AsyncHttpRequest request = new AsyncHttpUtil.Builder()
      .url("http://www.bchun.com/fund/service.do?func=getProvinces")
      .setBinaryBody(new byte[]{1,2,3,4,5})
      .setCallable(new BinaryRequestCallable() {

        @Override
        public void onFailed(int errorCode, String errorMsg) {
          //请求失败
        }

        @Override
        public void onSuccess(byte[] buffer) {
          //请求成功
        }
      })
      .build().post();

POST请求（JSON字符串自动转换对象）

  List<String> list = new ArrayList<String>();
      list.add("item1");
      list.add("item2");
      Request req = new Request();
      req.setKey1("value1");
      req.setKey2(1);
      req.setKey3(true);
      req.setKey4(list);

      AsyncHttpRequest request = new AsyncHttpUtil.Builder()
      .url("http://www.bchun.com/fund/service.do?func=getProvinces")
      .setRequestObj(req)//json格式请求内容
      .setJsonRequestInterceptor(new JsonRequestInterceptor() {//请求数据拦截器，自定义json解析器

        @Override
        public String convertJsonToObj(Object requestObj) {
          return new Gson().toJson(requestObj);
        }
      })
      .setResponseClass(Response.class)
      .setJsonResponseInterceptor(new JsonResponseInterceptor<Response>() {//返回结果拦截器，方便自定义json解析器以及对返回结果作简单预处理。

        @Override
        public Response convertJsonToObj(String responseStr, Class<Response> mResponseClass) {
          return new Gson().fromJson(responseStr, mResponseClass);
        }

        @Override
        public boolean checkResponse(Response response) {
          if (response.getServerResult().getResultCode() == 0){
            return true;
          }
          setErrorCode(AsyncHttpExceptionCode.defaultExceptionCode.getErrorCode());
          setErrorMsg(response.getServerResult().getResultMessage());
          return false;
        }

      })
      .setCallable(new JsonRequestCallable<Response>() {
        @Override
        public void onFailed(int errorCode, String errorMsg) {
          //请求失败
        }

        @Override
        public void onSuccess(Response responseInfo) {
          //请求成功
        }
      })
      .build().post();

普通下载

  AsyncHttpRequest request = new AsyncHttpUtil.Builder()
      .url("http://shouji.360tpcdn.com/151125/1259d7ddba8a048c2b9e778c9b5a9d04/com.bchun.fundqa_5.apk")
      .setDownloadFileDir("/sdcard")//文件本地保存路径
      .setDownloadfileName("fund.apk")//文件名称
      .setCallable(new DownloadRequestCallable() {

        @Override
        public void onFailed(int errorCode, String errorMsg) {
          //下载失败
        }

        @Override
        public void onTransfering(long totalLength, long transferedLength) {
          //下载进度
        }

        @Override
        public void onSuccess(String responseInfo) {
          //下载完成
        }
      })
      .build().download();

断点下载

AsyncHttpRequest request = new AsyncHttpUtil.Builder()
      .url("http://shouji.360tpcdn.com/151125/1259d7ddba8a048c2b9e778c9b5a9d04/com.bchun.fundqa_5.apk")
      .setDownloadFileDir("/sdcard")//文件本地保存路径
      .setDownloadfileName("fund.apk.temp")//文件名称
      .setFileStartPos(1000)//设置续下载开始位置
      .setCallable(new DownloadRequestCallable() {

        @Override
        public void onFailed(int errorCode, String errorMsg) {
          //下载失败
        }

        @Override
        public void onTransfering(long totalLength, long transferedLength) {
          //下载进度
        }

        @Override
        public void onSuccess(String responseInfo) {
          //下载完成
        }
      })
      .build().download();

普通上传

 AsyncHttpRequest request = new AsyncHttpUtil.Builder()
      .url("http://192.168.100.62:8080/MyHost/fund/upload.do")
      .addUploadFile("file", new File("/sdcard/Fund.apk"))//添加文件，也可以调用setFileWrappers方法，同时添加多个文件
      .addUploadFile("file1", new File("/sdcard/wifi_config.log"))
      .addFormData("md5", "aadfsdf")//添加form参数
      .setCallable(new UploadRequestCallable() {

        @Override
        public void onFailed(int errorCode, String errorMsg) {
          //上传失败
        }

        @Override
        public void onTransfering(String name, long totalLength, long transferedLength) {
          //上传进度
        }

        @Override
        public void onTransferSuc(String name) {
          //文件name上传完成
        }

        @Override
        public void onSuccess(String responseInfo) {
          //全部上传成功！
        }

        @Override
        public void onCancel() {
          //上传取消
        }
      })
      .build().upload();

断点上传

 FileWrapper fileWrapper = new FileWrapper();
      fileWrapper.setFile(new File("/sdcard/Fund.apk"));
      fileWrapper.setBlockSize(100000);//上传100000字节数据，默认为0，上传至文件末尾
      fileWrapper.setStartPos(1000);//从1000字节开始上传
      AsyncHttpRequest request = new AsyncHttpUtil.Builder()
      .url("http://192.168.100.62:8080/MyHost/fund/upload.do")
      .addFileWrapper("file", fileWrapper)//自定义上传文件，支持断点续传，支持上传指定数据大小
      .addFormData("md5", "aadfsdf")//添加form参数
      .setCallable(new UploadRequestCallable() {

        @Override
        public void onFailed(int errorCode, String errorMsg) {
          //上传失败
        }

        @Override
        public void onTransfering(String name, long totalLength, long transferedLength) {
          //上传进度
        }

        @Override
        public void onTransferSuc(String name) {
          //文件name上传完成
        }

        @Override
        public void onSuccess(String responseInfo) {
          //上传成功！
        }

        @Override
        public void onCancel() {
          //上传取消
        }
      })
      .build().upload();

中断请求

 request.cancel();

打开/关闭日志输出

 AsyncHttpLog.enableLog();

AsyncHttpLog.disableLog();

以上就是本文的全部内容，希望对大家的学习有所帮助。