Android平臺下輕量級http網絡傳輸庫
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
本文由用戶 jopen 自行上傳分享,僅供網友學習交流。所有權歸原作者,若您的權利被侵害,請聯系管理員。
轉載本站原創文章,請注明出處,并保留原始鏈接、圖片水印。
本站是一個以用戶分享為主的開源技術平臺,歡迎各類分享!