前言
Retrofit是Square出品的Android Http请求框架，封装了OKHttp库。Retrofit是基于RESTful架构设计的。
如果想对Retrofit有比较全面的了解，推荐以下博客：
Retrofit解析
本文着重于阐述对Retrofit的思考
1. 为什么使用Retrofit？
我们先来看看Retrofit的基本使用：
public interface GitHub {
@GET("/repos/{owner}/{repo}/contributors")
Call<List<Contributor>> contributors(
@Path("owner") String owner,
@Path("repo") String repo);
}
public static void main(String... args) throws IOException {
// Create a very simple REST adapter which points the GitHub API.
Retrofit retrofit = new Retrofit.Builder()
.baseUrl(API_URL)
.addConverterFactory(GsonConverterFactory.create())
.build();
// Create an instance of our GitHub API interface.
GitHub github = retrofit.create(GitHub.class);
// Create a call instance for looking up Retrofit contributors.
Call<List<Contributor>> call = github.contributors("square", "retrofit");
// Fetch and print a list of the contributors to the library.
List<Contributor> contributors = call.execute().body();
for (Contributor contributor : contributors) {
System.out.println(contributor.login + " (" + contributor.contributions + ")");
}
}
正如代码所看到的，使用Retrofit只需要通过注解的方式去声明接口并注入到create方法中就成功构建了http请求。而对于HttpURLConnection和OkHttpClient，你还要手动去拼接URL和构造请求实体，另外还需要手动对上传或返回的数据流进行操作。如果想进行解析，还需要自己再去手动引入一些解析框架如Gson等。此外，还需要用异步控制的方案或者框架如AyncTask/handler/Rxjava等，手动再与网络请求进行耦合。如果设计不当，会导致这几个框架之间耦合较大，导致如果有一天想替换掉某一部分(比如想用Rxjava替换Call或Gson替换Jackson)会很困难。
总结下Retrofit的优势：
- 使用注解搞定请求方法构建，高效方便；
- 解藕，retrofit与项目代码耦合度低；
- 支持同步，异步，RxJava；
- 无需手动解析请求和响应数据；
- Retrofit继承了OkHttp优秀性能
2. 怎么用的？为什么这样用？
现在广泛采纳的用法是RxJava+Retrofit结合使用。这也是Retrofit一个优势，可以支持Rxjava的使用。
使用上只需要为Retrofit的builder增加RxJavaCallAdapterFactory，就可以将Call接口转换成了RxJava的相应接口。
而这么使用的好处就是可以直接复用RxJava的优点。
比如响应式编程，调度器实现线程切换、自带错误处理等
扩展阅读：
什么是响应式编程，响应式编程的好处
3. 有没有了解它的源码？
Retrofit和okhttp源码解读可以阅读如下链接：
Retrofit源码的整体流程图可以参考如下：（图片来源于以上扩展阅读）
如果说要简单介绍下Retrofit的源码，可以描述如下：
伪代码如下：
Retrofit{
Retrofit build() {
callAdapter = callAdapter;
converter = converter;
return new Retrofit(callAdapter, converter);
}
// 动态代理生成接口代理类
<T> T create(Class<T> service) {
return (T)Proxy.newProxyInstance(service.getClassLoader, new InvocationHandler() {
public Object invoke(Object proxy, Method method, Object[] args) {
return new ServiceMethod(callAdapter, converter)
.invoke(args);
}
});
}
}
ServiceMethod{
CallAdapter callAdapter;
Converter converter;
invoke(Object[] args) {
OkHttpCall call = new OkHttpCall(callAdapter, converter, args);
return callAdapter.adapt(call);
}
}
// 这是你传入的Rxjava适配器
RxJavaCallAdapter extends CallAdapter{
adapt(OkHttpCall call){
// 在这里通过Rxjava订阅方式封装Observable并返回
return Observable(call);
}
}
- 建造者模式构建Retrofit，传入converter和callAdapter，converter是网络数据实体和JavaBean之间的转换器，你可以用Gson，Jackson，xml等。也可以自定义converter。
callAdapter是Retrofit请求返回的类型的适配转换器。你可以通过传入Rxjava的适配器。将Retrofit返回的call类型转换成Observable类型，也就可以配合Rxjava使用。 - 构建好Retrofit后，调用create传入自定义的请求接口，并通过动态代理的方式创建serviceMethod并对应一个接口method对象。serviceMethod的子类Http serviceMethod中持有了OkhttpCall，并传入converter和callAdapter。
- 调用adapt方法绑定okhttpcall并转换成输出的类型。
对于Rxjava的适配器，adapt的实现就是将okhttpcall转换成Observable类型。 - 转换器converter是在执行了okhttpcall内部的enqueue和execute后对response进行转换输出。
4. 项目中如何更好的使用？
项目在接入第三方开源库的时候，一定要考虑与项目代码解藕，因为随着项目演进，或者市面上有更好的更适合的开源库时，项目可能就需要替换这个库。
所以这个时候需要秉持基本设计原则去设计我们的网络请求框架。
比如mvp+rxjava+retrofit的项目架构中，model层需要和网络层进行解藕。那么就需要面向接口编程。把项目中需要的网络请求抽象成接口，定义好输入和输出。然后通过一个实现类用Retrofit实现网路请求。而model层就只需要依赖抽象接口就行。
