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

該庫是封裝了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