該庫是封裝了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.get("https://api.github.com/repos/square/retrofit/contributors") //請求方式和請求url
.tag(this) //請求的 tag, 主要用於取消對應的請求
.cacheKey("cacheKey") //設置當前請求的緩存key,建議每個不同功能的請求設置一個
.cacheMode(CacheMode.NO_CACHE) //緩存模式,詳細請看緩存介紹//.cacheTime(3000)//緩存時間
.execute(newStringCallback() {
@Overridepublic void onSuccess(Responseresponse) {
Log.i("get",response.body());
tvText.setText(response.body());
}
@Overridepublic void onError(Responseresponse) {super.onError(response);
}
});
post請求
OkGo.post("url")
.tag(this)
.cacheKey("cachePostKey")
.cacheMode(CacheMode.NO_CACHE)
.params("shopperId", "9356")
.params("machineId", "5117")
.params("orderType", "2")
.params("orderId", "108")
.execute(newStringCallback() {
@Overridepublic void onSuccess(Responseresponse) {
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();
}
}
@Overridepublic void onError(Responseresponse) {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