Retrofit2源码学习笔记（一）

作者：@荒井。
所分析的源代码基于Retrofit 2.3.0版本。

一般我在刚接触一个库时，会先大致了解一下它解决什么问题，使用了什么技术等等，这之后我会动手写一个小例子并运行起来看看效果，那么首先我来写一个例子。

根据官网描述，使用Retrofit2时，是把HTTP请求写成Java接口形式，例如：

public interface ArticleService {
    @GET("users/{user}/articles")
    Call listArticles(@Path("user") String user);
}

然后，构建一个Retrofit对象，并使用它生成ArticleService接口的实现，例如：

Retrofit retrofit = new Retrofit.Builder()
    .baseUrl("article.sample.com")
    .build();
ArticleService service = retrofit.create(ArticleService.class);

接下来，使用生成的"service"对象，调用其中的方法得到一个Call类型对象"articles"，代码如下：

Call articles = service.listArticles("arai");

最后我将这个请求加入队列，并等待返回结果回调：

articles.enqueue(new Callback() {
    @Override
    public void onResponse(Call call, Response response) {
        //成功。
    }

    @Override
    public void onFailure(Call call, Throwable t) {
        //失败。
    }
});

如果请求发送成功，即可在onResponse回调方法中拿到返回的数据，如果失败则会回调onFailure方法。这样就是一个比较完整和基本的Retrofit2使用例子了。为了更好地熟悉和使用Retrofit2这个库，我准备稍微深入地分析其源代码，那么这篇文章打算从Retrofit.create(Class service)方法开始，一步一步揭开其神秘的面纱。由于这个方法的篇幅不算长，先大致看一下它的全貌：

public  T create(final Class service) {
    /* 代码段 1 */
    Utils.validateServiceInterface(service);

    /* 代码段 2 */
    if (validateEagerly) {
        eagerlyValidateMethods(service);
    }

    /* 代码段 3 */
    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, @Nullable 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