Retrofit源码分析

本文是看完Stay的《Retrofit分析-漂亮的解耦套路》的文本版和视频版之后，写下的一个简单的文本版解析。
文本版：http://www.jianshu.com/p/45cb536be2f4
视频版：http://stay4it.com/course/22

1. WHAT

Retrofit是什么，有哪些api，怎么使用。
官方文档http://square.github.io/retrofit/

• 声明一个Service接口，根据官方文档写请求，这里例子用一个我最常用的表单请求。

@FormUrlEncoded
@POST("user/edit")
Call<User> updateUser(@Field("first_name") String first, @Field("last_name") String last);

• 然后在Activity或Fragment中创建Retrofit

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

• 最后调用Call请求数据，并处理数据

Call<User> call = service.updateUser("first_name","last_name");
call.enqueue(new Callback<User>() {
    @Override
    public void onResponse(Call<User> call, retrofit2.Response<Call<User>> response) {}
    @Override
    public void onFailure(Call<Response<ProductHome>> call, Throwable t) {}
});

2. HOW

怎么实现的，也就是源码分析了

• build()：创建所需要的变量

Retrofit build(){
    okhttp3.Call.Factory
    Executor callbackExecutor
    List<CallAdapter.Factory>

    return new Retrofit();
}

• create()：解析注解

create(){
    ServiceMethod serviceMethod = loadServiceMethod(method);    //解析注解
    OkHttpCall okHttpCall = new OkHttpCall<>(serviceMethod, args);
    return serviceMethod.callAdapter.adapt(okHttpCall);
}

loadServiceMethod()方法中有一个 serviceMethodCache，将解析过的存到缓存中，下次使用时直接调用。
使用serviceMethod.callAdapter.adapt()创建自定义的Service，这里的callAdapter有四种，分别是Guava、RxJava、Java8和Android。

• Android的CallAdapter：
  adapter中会使用OkHttp请求服务器，然后会根据之前传入的解析方式（GsonConverterFactory）将请求下来的结果解析成自定义的类（User）。将结果回调到了自定义的CallBack<>中。

附上Stay的流程图：

3.WHY

为什么这样实现，有没有更好的解决方法
这里简单介绍了点设计模式，想进一步了解的看Stay的最后一个视频吧