retrofit源码解析

what is retrofit

A type-safe HTTP client for Android and Java
适用于java8 和android平台。使用okio进行网络请求。

how to use retrofit

//first define an interface discribe the url and param
public interface GitHubService {
  @GET("users/{user}/repos")
  Call> listRepos(@Path("user") String user);
}

public class RetrofitSample {
    public void testRetrofit() {
         //定义要访问的url路径
         Retrofit retrofit = new Retrofit.Builder()
            .baseUrl("https://api.github.com/")
            .addConverterFactory(GsonConverterFactory.create())//使用不同的json解析器， retrofit只对body进行处理。
            .build();

         GitHubService service = retrofit.create(GitHubService.class);
         
         Call> repos = service.listRepos("octocat");
         // 请求数据，并且处理response 
        repos.enqueue(new Callback>() { 
            @Override 
            public void onResponse(Response> author) {
                 Log.d()
            } 
            @Override 
            public void onFailure(Throwable t) {
         } });
         //the code above will request url: https://api.github.com/users/octocat/repos
        // 返回的值封装成为List形式的数值。
    }
}

更多用法参考：你真的会用retrofit 这里面有更详细的使用介绍。

how does it work

首先，针对retrofit初始化的代码：

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

new Retrofit.Build(） 会调用Build(Platform.get())方法，根据是否有"android.os.Build" 来判断是否是android平台， 如果是android平台， 则创建一个主线程执行器, 这里我们可以知道，retrofit需要将任务(例如请求数据完毕，将数据返回到主线程)抛到主线程执行，直接调用MainThreadExcutor.excute(new Runnable(){})就可以了
事实上如果希望使用rxjava或者其他的类型，这里可以通过addAdapterFacotry()添加rxjava的adapter
同时还会添加一个默认的adapter， 对于android，默认的adapter就是ExecutorCallAdapterFactory，

static class MainThreadExecutor implements Executor {
      private final Handler handler = new Handler(Looper.getMainLooper());

      @Override public void execute(Runnable r) {
        handler.post(r);
      }
    }

除了这些信息，其他的信息通过Builder模式设置即可， 在调用Builder.build()的时候会判断使用哪种客户端（默认Okhttpclient）, 哪种线程执行器(android 默认就是上面的MainThreadExecutor执行器)， body转换器(没有设置内容转换器 则使用内建转换器)， 然后生成了一个Retrofit代码。

对于GitHubService service = retrofit.create(GitHubService.class);
进入到create()内部查看，可以看到其主要实现是通过jdk的动态代理对最开始的GithubApiService做拦截处理。

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