关于Retrofit，你必须思考这四个问题

前言

Retrofit是Square出品的Android Http请求框架，封装了OKHttp库。Retrofit是基于RESTful架构设计的。

如果想对Retrofit有比较全面的了解，推荐以下博客：
Retrofit解析

本文着重于阐述对Retrofit的思考

1. 为什么使用Retrofit？

我们先来看看Retrofit的基本使用：

  public interface GitHub {
    @GET("/repos/{owner}/{repo}/contributors")
    Call> 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> call = github.contributors("square", "retrofit");

    // Fetch and print a list of the contributors to the library.
    List 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分析-漂亮的解耦套路
Android开源框架源码鉴赏：Okhttp

Retrofit源码的整体流程图可以参考如下：（图片来源于以上扩展阅读）

Retrofit源码流程图

如果说要简单介绍下Retrofit的源码，可以描述如下：

伪代码如下：

Retrofit{
Retrofit build() {
callAdapter = callAdapter; 
converter = converter;
return new Retrofit(callAdapter, converter);
}

// 动态代理生成接口代理类
 T create(Class 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);
  }
}

1. 建造者模式构建Retrofit，传入converter和callAdapter，converter是网络数据实体和JavaBean之间的转换器，你可以用Gson，Jackson，xml等。也可以自定义converter。
   callAdapter是Retrofit请求返回的类型的适配转换器。你可以通过传入Rxjava的适配器。将Retrofit返回的call类型转换成Observable类型，也就可以配合Rxjava使用。
2. 构建好Retrofit后，调用create传入自定义的请求接口，并通过动态代理的方式创建serviceMethod并对应一个接口method对象。serviceMethod的子类Http serviceMethod中持有了OkhttpCall，并传入converter和callAdapter。
3. 调用adapt方法绑定okhttpcall并转换成输出的类型。
   对于Rxjava的适配器，adapt的实现就是将okhttpcall转换成Observable类型。
4. 转换器converter是在执行了okhttpcall内部的enqueue和execute后对response进行转换输出。

4. 项目中如何更好的使用？

项目在接入第三方开源库的时候，一定要考虑与项目代码解藕，因为随着项目演进，或者市面上有更好的更适合的开源库时，项目可能就需要替换这个库。
所以这个时候需要秉持基本设计原则去设计我们的网络请求框架。
比如mvp+rxjava+retrofit的项目架构中，model层需要和网络层进行解藕。那么就需要面向接口编程。把项目中需要的网络请求抽象成接口，定义好输入和输出。然后通过一个实现类用Retrofit实现网路请求。而model层就只需要依赖抽象接口就行。