rxjava+retrofit+okhttp3
重所周知 當下最流行的網絡請求的框架非rxjava+retrofit+okhttp3三合一了 但是在網絡上總是找不到一個比較全面的介紹 于是呼我自己研究了一套網絡請求的發開框架 目前已經寫入我開發的項目當中 目前還在學習的小伙伴們可以學習一下
(此篇文章主要針對我的demo 很多細節的東西講的不是很到位 但是我會把我在網上看的比較好的文章貼上去 讓大家詳細的了解)
簡潔：對于rxjava的理解 我個人認為就是一個異步線程一個基于事件處理的庫 讓人們可以更簡潔的處理一個事件的邏輯關系 簡單性 可讀性 重復性。再往深處的理解大家也可以認為他是擴展了開發者模式演變過來的
舉例：觀察者(大s) 被觀察者(小s) 只有當小s發生了事件 或者說小s處罰了某個事件 大s 才會對小s 進行相應的處理 否則 大s 會一直處于一個等待的狀態
當然我說的可能會比較粗糙，我給大家介紹一個對Rxjava理解比較好的作者 相信你們看了他的講解 會比我這里更加的明白和理解。點擊－拋物線
簡潔：Retrofit與okhttp共同出自于Square公司，retrofit就是對okhttp做了一層封裝。把網絡請求都交給給了Okhttp，我們只需要通過簡單的配置就能使用retrofit來進行網絡請求。
Retrofit與Okhttp不同的是，Retrofit需要定義一個接口，用來返回我們的Call對象
public interface RequestServes {
@POST("mobileLogin/submit.html")
Call getReslut(@Query("loginname") String loginname);
}
或
public interface ApiManagerService {
@POST("/biz/bizserver/news/list.do")
Observable getReslut(@QueryMap Map option);
}
我先說一下Result類，這是我自己demo中使用的實體類接數據的，我是結合了rxjava的Subscriber(觀察者)來封裝的后面的文段我會在次講解 這里給大家留個懸念
顯而易見@POST，@GET的是請求方式，參數注解有@PATH和@Query，@QueryMap等。 @Query @QueryMap 參數依舊遵循了http協議 以鍵值對的形式進行請求。
到此接口我們就定義完成了需要來定義Retrofit對象來進行請求了
俺就不再廢話了 直接貼上代碼 讓大家伙看個明白地
// OkHttp3 的監聽
private static class LogInterceptor implements Interceptor {
@Override
public okhttp3.Response intercept(Chain chain) throws IOException {
Request request = chain.request();
Log.e(TAG, "okhttp3:" + request.toString());//輸出請求前整個url
long t1 = System.nanoTime();
okhttp3.Response response = chain.proceed(chain.request());
long t2 = System.nanoTime();
//? ? ? ? ? Log.v(TAG,response.request().url()+response.headers());//輸出一個請求的網絡信息
okhttp3.MediaType mediaType = response.body().contentType();
String content = response.body().string();
Log.e(TAG, "response body:" + content);//輸出返回信息
return response.newBuilder()
.body(okhttp3.ResponseBody.create(mediaType, content))
.build();
}
}
這是OkHttp3自帶的監聽可以輸出整個url 還可以打印請求數據的時間 讓開發者很清楚的了解請求的耗時操作流程－真心的良心制作
//初始化OkHttp3的初始化
private static OkHttpClient client = new OkHttpClient.Builder()
.addInterceptor(new LogInterceptor())
.cache(new Cache(new File("C://okhttp"), 10 * 1024 * 102))//緩存
.retryOnConnectionFailure(true)
//? ? ? ? ? .connectTimeout(3, TimeUnit.SECONDS)
//? ? ? ? ? .writeTimeout(5, TimeUnit.SECONDS)
//? ? ? ? ? .readTimeout(5, TimeUnit.SECONDS)
.build();
這是化OkHttp3的初始化
//初始化Retrofit
private static final Retrofit sRetrofit = new Retrofit.Builder()
.baseUrl("http://api.1-blog.com")
.client(client)
.addConverterFactory(JacksonConverterFactory.create())//加入jackjson解析
.addCallAdapterFactory(RxJavaCallAdapterFactory.create()) // 使用RxJava作為回調適配器
.build();
初始化Retrofit
2:添加okhttp的對象(前面也說了－retrofit就是對okhttp做了一層封裝)
Gson: com.squareup.retrofit2:converter-gson
Jackson: com.squareup.retrofit2:converter-jackson
Moshi: com.squareup.retrofit2:converter-moshi
Protobuf: com.squareup.retrofit2:converter-protobuf
Wire: com.squareup.retrofit2:converter-wire
Simple XML: com.squareup.retrofit2:converter-simplexml
Scalars (primitives, boxed, and String): com.squareup.retrofit2:converter-scalars
總有一款你需要的解析形式 附贈官網retrofit 官網地址：http://square.github.io/retrofit/啟動你的翻譯器慢慢看吧！(英語大神除外哈) 大家可以看到 我添加的是jackjson解析 這是我demo中所需要的 后續一起講解。 在此介紹一片文章點擊一下吧
@OnClick(R.id.btn)
void more() {
Map result = ApiManager.getBasicMap();
result.put("size", "3");
ApiManager.apiManager.getReslut(result)
.subscribeOn(Schedulers.io())
.observeOn(AndroidSchedulers.mainThread())
.subscribe(new MySubscriber() {
@Override
public void onMyNext(String jsonStr) {
LogUtil.defLog(jsonStr);
data.setText(jsonStr);
}
@Override
public void onMyError(String msg) {
}
@Override
public void onMyCompleted() {
}
});
}
朋友 看到這請你告訴我 你是不是一臉的懵b 別著急 前面介紹了半天 現在正主正在一點點的出來了 咱們一步步的走我來給你解釋一下
###### 1 :Map集合ApiManager.getBasicMap() 自己封裝了一下 可以將以后項目中的公共參數放進去
/**
* 設置公共參數
*/
public static Map getBasicMap() {
if (objectMapper == null) {
objectMapper = new ObjectMapper();
objectMapper.enable(DeserializationFeature.ACCEPT_SINGLE_VALUE_AS_ARRAY);
objectMapper.configure(SerializationFeature.FAIL_ON_EMPTY_BEANS, false);
}
if (map == null) {
map = new HashMap<>();
} else {
map.clear();
}
//打印MAP
Set> entrySet = map.entrySet();
for (Map.Entry entry : entrySet) {
LogUtil.printI(LogUtil.APP_TAG, entry.getKey() + "http://" + entry.getValue() + "");
}
return map;
}
其中objectMapper 即是jackjson的解析設置
a）objectMapper.enable 一個簡單的映射過程 確保數據能夠全部請求過來
b）objectMapper.configure 設置當返回的參數為null時可自動執行序列化操作 當然 記得把你的實體類寫個空的構造方法。
以上兩個配置我個人介意還是加上 省的大家走很多的彎路 (我不哭)
2:ApiManager.apiManager.getReslut(result)
在此調用網絡請求
public static ApiManagerService apiManager = sRetrofit.create(ApiManagerService.class);
在開始介紹的由Retrofit定義的接口類 各種的封裝啊。。。。 OK
.subscribeOn(Schedulers.io())
.observeOn(AndroidSchedulers.mainThread())
設置流文件處理，設置執行在主線程。
4:.subscribe(new MySubscriber() What is fuck?
你猜對了 我又給封裝了
public abstract class MySubscriber extends Subscriber {
String TAG = MySubscriber.class.getName();
@Override
public void onStart() {
onMyStart();
}
@Override
public void onCompleted() {
onMyCompleted();
}
@Override
public void onError(Throwable errorMsg) {
String stringErr = errorMsg.getLocalizedMessage();
//TODO 需要完善異常的判斷
if (stringErr.contains("UnknownHostException")) {
onMyError("無法連接服務器，請檢查網絡是否正常");
} else {
onMyError(stringErr);
}
}
@Override
public void onNext(T t) {
if (Result.class.isInstance(t)) {
Result result = (Result) t;
if (!result.getStatus().equals("success")) {
onMyError(result.getInfo());
} else {
if (null == result.getData() && "".equals(result.getData())) {
onMyError("返回數據為空");
return;
} else {
try {
String jsonStr = ApiManager.objectMapper.writeValueAsString(result.getData());
onMyNext(jsonStr);
} catch (JsonProcessingException e) {
e.printStackTrace();
}
}
}
} else {
//如果沒返回數據沒指向Result，打印數據。后期有返回特殊數據格式的時候可以單獨解析jsonStr
try {
String jsonStr = ApiManager.objectMapper.writeValueAsString(t);
//? ? ? ? ? ? ? ? onMyNext(jsonStr);
LogUtil.printE(TAG, "原始數據" + jsonStr);
} catch (JsonProcessingException e) {
}
}
}
public abstract void onMyStart();
public abstract void onMyNext(String jsonStr);
public abstract void onMyError(String msg);
public abstract void onMyCompleted();
雖然這里類在代碼里有 但是我還是選擇了全部貼出來 講解開始：
1:創建一個抽象類MySubscriber 繼承Subscriber 人有會問 為啥里面帶范型 T 呢
范型的定義：泛型，即“參數化類型”。一提到參數，最熟悉的就是定義方法時有形參，然后調用此方法時傳遞實參。那么參數化類型怎么理解呢？顧名思義，就是將類型由原來的具體的類型參數化，類似于方法中的變量參數，此時類型也定義成參數形式（可以稱之為類型形參），然后在使用/調用時傳入具體的類型（類型實參）
所以在接收參數的時候 我可以任意的將參數實例化(避免了參數寫死) 說大白話就是：我在項目a中的根節點是｛1，2，3｝那我在項目b中的根節點可能就要變成{a,b,c,d}
值得注意的是在你的實體類Result中 也要使用范型來接收數據即Result < T > 否則無效，甚至報錯。到時候大家可以往底層的代碼看看 其實Subscriber是實現了觀察者Observer的方法的 在這里我不再深多解釋－雙手將鏈接奉上點擊－拋物線
好了 當我的MySubscriber< T > 繼承Subscriber 我同樣也是實現了它內部的方法
onStart()
onCompleted()
onError(Throwable errorMsg)
onNext(T t)
同時 我自己也寫了四個抽象的方法來作為整個抽象類的返回值 在此處 onNext(T t) 承載了返回的數據 到時大家可以根據自己(公司的)項目來更改 ,方法中 唯一必須要寫的就是
String jsonStr = ApiManager.objectMapper.writeValueAsString(result.getData());
此方法是jackjson中 將返回的json 轉化成字符串的形式返回出去，在我的MainActivity中 我又自己寫了個ParseJsonUtil類 來處理返回的字符串(這樣很大問題解決了重復性) 可轉化集合 或者單個的實體 具體的可在log中打印出來 哦 對了 我的GoodVideoBean只是個樣品 沒有實例的數據返回 大家可以嘗試寫一下 假如在又不明白的可以加我的qq 2215719882 來詢問我
項目地址 SmithGao https://github.com/SmithGao/rxjava_retrofit3.0_okhttp
