Android平臺下輕量級http網絡傳輸庫

jopen 8年前發布 | 10K 次閱讀 Android開發移動開發

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

來自： http://blog.csdn.net/rohsuton/article/details/50521611

本文由用戶 jopen 自行上傳分享，僅供網友學習交流。所有權歸原作者，若您的權利被侵害，請聯系管理員。

轉載本站原創文章，請注明出處，并保留原始鏈接、圖片水印。

本站是一個以用戶分享為主的開源技術平臺，歡迎各類分享！

本文地址：http://www.baiduhome.net/lib/view/open1452828874823.html

Android開發移動開發

Android平臺下輕量級http網絡傳輸庫

AsyncHttpHelp

優點

功能

測試示例

用法示例

相關經驗

相關資訊

相關文檔

目錄