这样一说你可能可以看的懂Retrofit了

Retrofit

Retrofit简介和使用

A type-safe HTTP client for Android and Java

大家用心体会反正就是和OkHttp是不一样的作用。

第一步

在gradle中增加Retrofit的引用

implementation 'com.squareup.retrofit2:retrofit:2.4.0'

第二步

写一个你Api的interface，下面简称Api.interface。

public interface GitHubService {

    @GET("users/{user}/repos")
    Call> listRepos(@Path("user") String user);

}

第三步

创建一个GitHubService的实例。

Retrofit retrofit = new Retrofit.Builder()
    .baseUrl("https://api.github.com/")
    .build();

GitHubService service = retrofit.create(GitHubService.class);

第四步

调用Git的方法请求数据。

Call> repos = service.listRepos("octocat");

好了，到这里Retrofit的使用流程都已经讲完了。其实使用非常简单，就这么几步。

Retrofit源代码分析

在分析源代码之前先说几个点，等会分析源代码的时候有用。

记住重要的几个类

• Retrofit.class：主要对外调用的类，实例化Api.interface。

• ServiceMethod.class：解析Api.interface中的注解。

• OkHttpCall.class：实际的网络请求实现类。

自定义Http请求接口

Retrofit中都会有一个自定义接口，就如使用例子中的GitHubService.interface。这里写了所有你向服务器请求的接口。在源码中不会涉及，但是源码主要是对这个接口的解析实现。分析源码的时候都会围绕着这个自定义接口展开。

Java 注解 （Annotation）

注解就是你在java代码中带有@符号的东西。最常见的是@Override，表示重写方法。在GitHubService.interface中都是用注解的方式表示http的请求方式，设置请求参数。比如@GET,@POST,@PATH,@FIELD等。如果对Java注解不是很理解可以点击这里Java基础加强总结(一)——注解(Annotation)。

Proxy.newProxyInstance()

public static Object newProxyInstance(
    ClassLoader loader,
    Class[] interfaces,
    InvocationHandler h
)

这个方法的主要作用就是实现动态代理。第一个参数表示一个装载器，第二个参数是指明通过接口指定生成哪个对象的代理类；第三个参数是表明代理要做的事。如果不是很理解这个方法可以点击Java基础加强总结(三)——代理(Proxy)。

适配器模式

把一个类的接口变成一个你想要的接口。像一些转换头一样，把110V的插头转换成220V的这样可以方便我们使用。比如在Retrofit中的CallAdapter。如果对适配器模式不是很理解的话可以点击这里适配器模式（Adapter Pattern）- 最易懂的设计模式解析。

以上说的几个点大家都有所了解的情况下然后开始源代码的解析。

Retrofit其实就是把我们自定义的接口实例化，实现接口中的所有方法。

Retrofit retrofit = new Retrofit.Builder()
    .baseUrl("https://api.github.com/")
    .build();
GitHubService service = retrofit.create(GitHubService.class);

第一步创建Retrofit对象

//Retrofit.class

public static final class Builder {
    private final Platform platform;
    private @Nullable okhttp3.Call.Factory callFactory;
    private HttpUrl baseUrl;
    private final List converterFactories = new ArrayList<>();
    private final List callAdapterFactories = new ArrayList<>();
    private @Nullable Executor callbackExecutor;
    private boolean validateEagerly;

    Builder(Platform platform) {
      this.platform = platform;
    }

    public Builder() {
      this(Platform.get());
    }

    .......

    /**
     * Create the {@link Retrofit} instance using the configured values.
     * 

     * Note: If neither {@link #client} nor {@link #callFactory} is called a default {@link
     * OkHttpClient} will be created and used.
     */
    public Retrofit build() {
      if (baseUrl == null) {
        throw new IllegalStateException("Base URL required.");
      }

      okhttp3.Call.Factory callFactory = this.callFactory;
      if (callFactory == null) {
        callFactory = new OkHttpClient();
      }

      Executor callbackExecutor = this.callbackExecutor;
      if (callbackExecutor == null) {
        callbackExecutor = platform.defaultCallbackExecutor();
      }

      // Make a defensive copy of the adapters and add the default Call adapter.
      List callAdapterFactories = new ArrayList<>(this.callAdapterFactories);
      callAdapterFactories.add(platform.defaultCallAdapterFactory(callbackExecutor));

      // Make a defensive copy of the converters.
      List converterFactories =
          new ArrayList<>(1 + this.converterFactories.size());

      // Add the built-in converter factory first. This prevents overriding its behavior but also
      // ensures correct behavior when using converters that consume all types.
      converterFactories.add(new BuiltInConverters());
      converterFactories.addAll(this.converterFactories);

      return new Retrofit(callFactory, baseUrl, unmodifiableList(converterFactories),
          unmodifiableList(callAdapterFactories), callbackExecutor, validateEagerly);
    }
  }

Retrofit类中可以配置选项

• platform：平台信息（Android，Java8）,我们使用的是Android平台
• callFactory：创建一个OkHttp的请求
• baseUrl：根地址信息
• coverterFactories:类型转换器，包括请求类型转换器和响应数据转换器
• callAdapterFactories:请求适配器，适配到OkHttp的请求
• callbackExceutor:执行请求回调器

第二步调用Retrofit.create()创建Api.interface

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, @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