Android平台下轻量级http网络传输库
jopen
9年前
AsyncHttpHelp
AsyncHttpHelp是一个android平台下基于httpclient开发的HTTP网络请求工具。
优点
- 功能齐全，提供常用的http网络访问接口。
- 轻量级，无任何第三方库依赖，库大小为90K左右。
- 定制化，自定义json解析库，支持请求参数，返回内容预处理。
- 易用性，简单易用，只需几行代码即可完成请求，可随意设置cookie、http头部等信息。
功能
- 普通get请求
- 普通post请求
- Form表单提交数据
- 二进制数据传输
- json格式内容传输（json字符串自动转java对象，java对象自动转json字符串）
- 普通文件上传/下载
- 断点上传/下载
- 分块上传文件
- session保持
- 自定义cookie、http头部信息等
- 取消请求
- 自定义json解析器
- 请求内容，返回内容预处理
- 设置请求结果是否在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();
源码地址：AsyncHttpHelp
如有疑问可联系作者：hi@luoxudong.com或者rohsuton@gmail.com