Android 网络框架--Retrofit2 源码分析（上）

Retrofit是Square公司出品的一款产品，主要完成封装符合RESTful风格 的 HTTP的网络框架。Retrofit在2.0之后，HTTP网络框架内置了OKHttp，不能再配置其他的HTTP网络框架。它是一个高聚低耦的的代码结构，Client可以根据需要选择采用何种数据格式（XML/Json等）与Server交换数据，以及异步的请求结果以何种方式通知主线程（Call/Observable等）。

先从一个简单的例子说起

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 {
        Retrofit retrofit = new Retrofit.Builder()
                .baseUrl(API_URL)
                .addConverterFactory(GsonConverterFactory.create())
                .build();
        GitHub github = retrofit.create(GitHub.class);
        Call> call = github.contributors("square", "retrofit");
        List contributors = call.execute().body();
        call.enqueue(new Callback>() {
            @Override
            public void onResponse(Call> call, Response> response) {
                List data = response.body();
            }
            @Override
            public void onFailure(Call> call, Throwable t) {
            }
        });
        for (Contributor contributor : contributors) {
            System.out.println(contributor.login + " (" + contributor.contributions + ")");
        }
    }

以上的代码演示了retrofit的基本使用方法和步骤：

1. 定义数据Bean结构
2. 设计api接口
3. 配置Retrofit对象
4. 获得api接口的代理对象
5. 执行http请求并处理返回的数据

需要一提的是，api接口的设计采用了注解的方式，好处是省去了开发者复杂的数据封装。
本篇文章主要对以上步骤3,4,5内容分析。

Retrofit类分析

retrofit类.png

Retrofit类内部主要管理3个对象

• Converter.Factory列表：主要用来管理数据序列化的，每一个converter代表一种数据格式，例如Json、Protobuf等。Retrofit允许client和server之间的数据传输可以采用多种数据格式。
• CallAdapter.Factory列表：主要管理返回结果异步处理方式，每一个callAdater代表了一种异步的处理方式，如Call，Rxjava等。Retrofit允许同时配置多种异步处理方式，默认的情况是Call的方式，现在比较流行的是Rxjava。
• ServiceMethod列表：serviceMethod是retrofit中关键的类，它完成了主要的请求封装，以及根据数据类型和api的返回类型完成converter和callAdapter的选择。

Retrofit的 配置主要就是设置Converter.Factory和 CallAdapter.Factory，以及配置一些okhttp相关的url，拦截器等。

api接口代理对象的产生过程

retrofit_stay.png

上图简单的展示了代理对象的产生过程：（图片来源 http://www.jianshu.com/p/45cb536be2f4）

public  T create(final Class 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 the method is a method from Object then defer to normal invocation.
            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);
            OkHttpCall