1. 程式人生 > >android -------- OkGo (讓網絡請求更簡單的框架)

android -------- OkGo (讓網絡請求更簡單的框架)

功能 過期 pat ada 上傳下載 ast xutils 隊列 trac

項目地址:https://github.com/jeasonlzy

該庫是封裝了okhttp的網絡框架,可以與RxJava完美結合,比Retrofit更簡單易用。支持大文件上傳下載,上傳進度回調,下載進度回調,表單上傳(多文件和多參數一起上傳),鏈式調用,可以自定義返回對象,支持Https和自簽名證書,支持cookie自動管理,支持四種緩存模式緩存網絡數據,支持301、302重定向,擴展了統一的上傳管理和下載管理功能

其中Demo中用到的圖片選擇是我的另一個開源項目,完全仿微信的圖片選擇庫,自帶 矩形圖片裁剪 和 圓形圖片裁剪 功能,有需要的可以去下載使用,附上地址:https://github.com/jeasonlzy/ImagePicker

其中的九宮格控件也是我的開源項目,類似QQ空間,微信朋友圈,微博主頁等,展示圖片的九宮格控件,自動根據圖片的數量確定圖片大小和控件大小,使用Adapter模式設置圖片,對外提供接口回調,使用接口加載圖片,支持任意的圖片加載框架,如 Glide,ImageLoader,Fresco,xUtils3,Picasso 等,支持點擊圖片全屏預覽大圖。附上地址:https://github.com/jeasonlzy/NineGridView



演示

技術分享圖片技術分享圖片技術分享圖片技術分享圖片技術分享圖片技術分享圖片

Android Studio用戶

般來說,只需要添加第一個okgo的核心包即可,其余的三個庫根據自己的需要選擇添加!!!

//必須使用
compile ‘com.lzy.net:okgo:3.0.4‘

//
以下三個選擇添加,okrx和okrx2不能同時使用 compile ‘com.lzy.net:okrx:1.0.2‘ compile ‘com.lzy.net:okrx2:2.0.2‘ compile ‘com.lzy.net:okserver:2.0.5‘

OkGo主要功能

  • 基本的get、post、put、delete、head、options、trace、patch八種請求
  • 支持upString,upJson,upBytes,upFile等up類方法上傳特定數據
  • 支持一個key上傳一個文件,也可以一個key上傳多個文件,也可以多文件和多參數一起上傳
  • 大文件下載和下載進度回調
  • 大文件上傳和上傳進度回調
  • 支持cookie的自動管理,並可自定義cookie管理策略
  • 支持緩存模式,不僅支持http緩存協議,也支持自定義緩存策略
  • 支持重定向
  • 支持自定義超時自動重連次數
  • 支持鏈式調用
  • 支持https訪問,支持雙向認證
  • 支持根據tag取消請求,也可全部取消
  • 支持自定義Callback,自動解析網絡數據


舉例 get請求

OkGo.<String>get("https://api.github.com/repos/square/retrofit/contributors")                            // 請求方式和請求url
                .tag(this)                       // 請求的 tag, 主要用於取消對應的請求
                .cacheKey("cacheKey")            // 設置當前請求的緩存key,建議每個不同功能的請求設置一個
                .cacheMode(CacheMode.NO_CACHE)    // 緩存模式,詳細請看緩存介紹
              //  .cacheTime(3000)//緩存時間
                .execute(new StringCallback() {

                    @Override
                    public void onSuccess(Response<String> response) {
                        Log.i("get",response.body());
                        tvText.setText(response.body());
                       
                    }

                     @Override
                     public void onError(Response<String> response) {
                         super.onError(response);
                     }
                });

post請求

 OkGo.<String>post("url")
                 .tag(this)
                .cacheKey("cachePostKey")
                .cacheMode(CacheMode.NO_CACHE)
                .params("shopperId", "9356")
                .params("machineId", "5117")
                .params("orderType", "2")
                .params("orderId", "108")
                .execute(new StringCallback() {
                    @Override
                    public void onSuccess(Response<String> response) {
                        Log.i("aaa",response.body());
                        Log.i("time2",System.currentTimeMillis()+"s");
                        BorrowRecordInfo borrowRecordInfo = JSON.parseObject(response.body(),BorrowRecordInfo.class);
                        if (borrowRecordInfo != null){
                            tvText.setText(response.body());
                            Toast.makeText(Demo1.this,borrowRecordInfo.getOrder().getNickName(),Toast.LENGTH_LONG).show();
                        }

                    }

                    @Override
                    public void onError(Response<String> response) {
                        super.onError(response);
                    }
                });

post請求查看Header

頭多了一個字段叫Content-Type:application/x-www-form-urlencoded,這個表示當前請求是http普通的表單請求,並且請求的參數經過了URL編碼。這個請求頭不要嘗試自己修改,也不支持修改,就算你修改了,也不會生效

OkGo的優勢

  • 優勢一:性能高,專註於簡單易用的網絡請求,使用主流的okhttp進行封裝,對於okhttp大家都知道,在Android4.4的源碼中可以看到HttpURLConnection已經替換成OkHttp實現了,並且支持HTTP2/SPDY黑科技,支持socket自動選擇最好路線,並支持自動重連,擁有自動維護的socket連接池,減少握手次數,擁有隊列線程池,輕松寫並發。
  • 優勢二:特有的網絡緩存模式,是大多數網絡框架所不具備的,說一個應用場景,老板說我們的app不僅需要在有網的情況下展示最新的網絡數據,還要在沒網的情況下使用緩存數據,這時候是不是項目中出現了大量的代碼判斷當前網絡狀況,根據不同的狀態保存不同的數據,然後決定是否使用緩存。細想一下,這是個通用的寫法,於是OkGo提供了五種緩存模式,讓你不用關心緩存的實現,而專註於數據的處理。(具體緩存的使用方法請看最後第四章節)。
  • 優勢三:方便易用的擴展接口,可以添加全局的公共參數,全局攔截器,全局超時時間,更可以對單個請求定制攔截器,超時時間,請求參數修改等等,在使用上更是方便,原生支持的鏈式調用讓你的請求更加清晰。
  • 優勢四:強大的Cookie保持策略,我們知道在客戶端對cookie的獲取是個不太簡單的事情,特別是還要處理cookie的過期時間,持久化策略等等,OkGo幫你徹底解決Cookie的難題,默認擁有內存存儲和持久化存儲兩種實現,cookie全程自動管理,並且提供了額外的addCookie方式,允許介入到自動管理的過程中,添加你想創建的任何cookie。

所以就說這麽多啦,選最適合項目的,選大多數人選擇的,選簡單易用的,選擇使用流行技術的,就這麽個標準,而OkGo正是在這種情況下誕生啦!!



OkGo詳細文檔

https://github.com/jeasonlzy/okhttp-OkGo/wiki/OkGo

常見問題

https://github.com/jeasonlzy/okhttp-OkGo/wiki/%E4%BC%A0%E5%8F%82%E4%B8%8E%E6%8A%93%E5%8C%85%EF%BC%88%E5%BF%85%E7%9C%8B%EF%BC%89#1-%E4%B8%8A%E4%BC%A0%E8%AF%B7%E6%B1%82%E5%A4%B4


參考文章

https://www.jianshu.com/p/6aa5cb272514

android -------- OkGo (讓網絡請求更簡單的框架)