在寫作業項目處理網絡請求問題時了解了幾個框架，比如Google的Volley，Square的OkHttp和Retrofit等，后來看到大家都在推薦使用Retrofit2。然后在實際使用中也發現使用起來很方便代碼很簡潔，只需要定義接口然后調用即可。這也讓我對這個框架的原理感到了好奇。下面分享一下它的基本原理以及我對于其源碼學習的一些小小的心得體會。
Retrofit2的使用
什么是Retrofit2
（這里就直接復制粘貼了）
Retrofit是針對于Android/Java的、基于okHttp的、一種輕量級且安全的、并使用注解方式的網絡請求框架。
Retrofit2的使用詳解
這里先放上Retrofit2的官方文檔，其實看文檔對其的使用應該就沒有什么問題了，因為真的很簡單很好用！這里就大致過一下它的使用步驟：
1）在gradle中加入依賴
compile 'com.squareup.retrofit2:retrofit:2.3.0'
compile 'com.google.code.gson:gson:2.8.1'
compile 'com.squareup.retrofit2:converter-gson:2.3.0'
（如果要和rxjava整合可以再加入retrofit2:adapter-rxjava）
2）在AndroidManifest文件中打開訪問網絡的權限
<uses-permission android:name="android.permission.INTERNET"/>
3）創建Retrofit2實例
// 定義訪問的主機地址
retrofit = new Retrofit.Builder().baseUrl(BASEURL)
//解析方法
.addConverterFactory(GsonConverterFactory.create()) .build();
4）定義接口
public interface GitHubService {
@GET("users/{user}/repos")
Call<List<Repo>> listRepos(@Path("user") String user);
}
這里就直接使用官方文檔給出的例子了，注解的話參見下圖
5）創建對象調用接口
GitHubService service = retrofit.create(GitHubService.class);
Call<List<Repo>> repos = service.listRepos("octocat");
這段代碼的意思大概是首先獲取Retrofit對象，然后通過動態代理獲取到所定義的接口，通過調用接口里面的方法獲取到Call類型返回值，最后進行網絡請求操作
Retrofit的原理
Retrofit的思想主要是動態代理，看了幾個源碼的解析感覺ServiceMethod像一個中央處理器很重要，這里就主要解析一下ServiceMethod的創建過程，先看一段Retrofit的源碼（這是上面調用接口時的create方法源碼）：
public <T> T create(final Class<T> service) {
Utils.validateServiceInterface(service);
if (validateEagerly) {
eagerlyValidateMethods(service);
}
return (T) Proxy.newProxyInstance(service.getClassLoader(), new Class<?>[] { service },
new InvocationHandler() {
private final Platform platform = Platform.get();
@Override public Object invoke(Object proxy, Method method, Object... args)
throws Throwable {
if (method.getDeclaringClass() == Object.class) {
return method.invoke(this, args);
}
if (platform.isDefaultMethod(method)) {
return platform.invokeDefaultMethod(method, service, proxy, args);
}
//轉換成ServiceMethod
ServiceMethod serviceMethod = loadServiceMethod(method);
//通過serviceMethod, args獲取到okHttpCall 對象
OkHttpCall okHttpCall = new OkHttpCall<>(serviceMethod, args);
//進一步封裝okHttpCall并返回Call對象
return serviceMethod.callAdapter.adapt(okHttpCall);
}
});
在接口調用的時候調用的這個create方法可以看到其實是用newProxyInstance()方法來返回一個類的代理實例，它需要的參數有調用的方法名method、參數列表args。這兩者可以轉換成一個ServiceMethod對象。上面用到的方法的源碼如下
ServiceMethod loadServiceMethod(Method method) {
ServiceMethod result;
synchronized (serviceMethodCache) {
result = serviceMethodCache.get(method);
if (result == null) {
//通過ServiceMethod.Builder()方法來構建ServiceMethod
result = new ServiceMethod.Builder(this, method).build();
//放入緩存方便之后使用
serviceMethodCache.put(method, result);
}
}
return result;
}
public ServiceMethod build() {
//構建CallAdapter對象
callAdapter = createCallAdapter();
//構建responseConverter轉換器對象(轉換成合適的類型)
responseType = callAdapter.responseType();
if (responseType == Response.class || responseType == okhttp3.Response.class) {
throw methodError("'"
+ Utils.getRawType(responseType).getName()
+ "' is not a valid response body type. Did you mean ResponseBody?");
}
responseConverter = createResponseConverter();
...
return new ServiceMethod<>(this);
}
有了ServiceMethod后，下面的工作大致是OkHttpCall調用ServiceMethod獲得一個可以執行的Request對象，然后等到Http請求返回后，再將response body傳入ServiceMethod中，ServiceMethod調用Converter接口將response body轉成一個Java對象
參考文獻：
Android 網絡框架之Retrofit2使用詳解及從源碼中解析原理
你真的會用Retrofit2嗎?Retrofit2完全教程
Retrofit2 源碼解析
