Retrofit2系列（源码解析篇）

前言

Retrofit是Jake Wharton 大神的作品，它被分为三部分分别是retrofit，adapter和convert，在源码对应3个module,本文是基于Retrofit2.2版本的，本文用到关键依赖moudle的build.gradle如下

compile "com.squareup.retrofit2:retrofit:${retrofit}"
compile "com.squareup.retrofit2:converter-gson:${retrofit}"
compile "com.squareup.retrofit2:converter-scalars:${retrofit}"
compile("com.squareup.retrofit2:converter-simplexml:${retrofit}")
compile "com.squareup.retrofit2:adapter-rxjava:${retrofit}"
compile "com.squareup.okhttp3:okhttp:${OKHTTP}"

gradle.properties

OKHTTP=3.6.0
retrofit = 2.2.0

PS: retrofit 默认就包含OkHttp的引用，这点可以在源码pom.xml看到有OkHttp的依赖
所以OkHttp的依赖可以不用加

结构图

本来还想自己画一下的，看到网上有人总结的比较好，这里就直接照搬了，感谢Stay

技术储备

1.注解
2.一些设计模式的了解：代理模式（动态代理），装饰模式，外观模式，适配器模式，策略模式

这一块网上资料很多，可以自己去查资料。另外插一句：设计模式这一块还是很重要的，以后进阶看源码以及自己写出高质量的代码都是需要这项硬技能

关键类简介

Retrofit
主要给开发者调用进行网络请求的类，负责把接口传入以及用户自定义的一些配置（解析配置，RxJava支持配置等）

• callFactory：调用工程，其实就是OKHttpClient的对象
• baseUrl：基础URL，用来拼上路径行程完整的URL
• converterFactories：转换器工厂集合，用来序列化和反序列化
• adapterFactories：适配器工厂集合，用来适配请求返回的类型
• callbackExecutor：请求方法回调时处理器
• validateEagerly：是否需要全部缓存申明的方法的标志位

ServiceMethod
对接口的方法解析成请求的Request

OkHttpCall
对网络请求的封装

如何识别注解(构造请求)

在Retrofit的create方法有句
ServiceMethod serviceMethod = (ServiceMethod) loadServiceMethod(method);
跳转到方法ServiceMethod loadServiceMethod(Method method)中可以看到Retrofit 169行ServiceMethod的构建方法result = new ServiceMethod.Builder<>(this, method).build();跳转到build()函数可以看到

  for (Annotation annotation : methodAnnotations) {
        parseMethodAnnotation(annotation);
      }

跳转到parseMethodAnnotation方法可以看到我们熟悉的“GET”,"POST"

 private void parseMethodAnnotation(Annotation annotation) {
      if (annotation instanceof DELETE) {
        parseHttpMethodAndPath("DELETE", ((DELETE) annotation).value(), false);
      } else if (annotation instanceof GET) {
        parseHttpMethodAndPath("GET", ((GET) annotation).value(), false);
      } else if (annotation instanceof HEAD) {
        parseHttpMethodAndPath("HEAD", ((HEAD) annotation).value(), false);
        if (!Void.class.equals(responseType)) {
          throw methodError("HEAD method must use Void as response type.");
        }
      } 
      ······
    }

这里是有关请求注解解析，另外的解析Header和请求地址方法拼接有相应方法Headers parseHeaders(String[] headers)和parseHttpMethodAndPath(String httpMethod, String value, boolean hasBody)

GitHubApi api = retrofit.create(GitHubApi.class)这里面用了什么设计模式，如何实现返回接口的对象

这里用到了动态代理的设计模式，方法如下

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