2016-05-06 16:07:09
1.先上一张Retrofit的代码结构图：
可以看到，Retrofit自身的结构很简单，代码量也不是很大。红色框部分是一些注解类，就是一些标记。
简单的看一下客户端是如何使用Retrofit的：
定义接口：
public interface WeatherDataService {
@GET("/wtr-v2/temp/realtime")
Call<MiWeatherData> getMiWeather(@Query("cityId") String cityId);
@GET("/wtr-v2/temp/realtime")
Observable<MiWeatherData> getMiWeatherObservable(@Query("cityId") String cityId);
@GET("/wtr-v2/temp/realtime")
MiWeatherData getMiWeatherCustomCallAdapter(@Query("cityId") String cityId);
}
客户端调用：
private void getWeather() {
retrofit = new Retrofit.Builder()
.baseUrl("http://weatherapi.market.xiaomi.com")
.addConverterFactory(GsonConverterFactory.create(gson))
.build();
service = retrofit.create(WeatherDataService.class);
Call<MiWeatherData> result = service.getMiWeather("101010100");
try {
Response<MiWeatherData> r = result.execute();
MiWeatherData data = r.body();
Log.e("David", "ResponseBody data = " + data);
if (data != null) {
Log.e("David", "RxLoaderCallback data = " + data.weatherinfo.SD);
Log.e("David", "RxLoaderCallback data = " + data.weatherinfo.cityid);
Log.e("David", "RxLoaderCallback data = " + data.weatherinfo.WS);
}
} catch (IOException e) {
e.printStackTrace();
}
}
2. 几个主要类的UML简图：
2.1 Retrofit和Retrofit.Factory
Retrofit和ServiceMethod使用了Builder模式(省略了Director和Abstract Product的Builder模式)来构建自己，Retrofit的作用很简单，传入需要的参数，构建一个Retrofit对象，然后通过动态代理的方式，得到我们自定义的方法接口的实例，参数中除了baseUrl之外，其他都是可选的，如果没设置会使用默认值。
ServiceMethod就是我们自己调用的方法做一层封装而已，包括解析方法使用的注解、参数等，同时提供方法，生成网络请求需要的Request和解析请求结果。
2.1 CallAdapter和CallAdapter.Factory
CallAdapt的作用是把Call转变成你想要返回的对象，起作用的是adapt方法，CallAdapter.Factory的作用是获取CallAdapter。ExecutorCallAdapterFactory的CallAdapter会将回调方法放到主线程中执行，DefaultCallAdapterFactory不是。两者的CallAdapter能够接受的返回值类型为Call<T>。很明显，RxJavaCallAdapterFactory的CallAdapter能够接受的返回值是Oservable<T>。如果想让的方法直接返回一个对象，可以自定义一个CallAdapter.Factory。代码如下：
private class MyCallAdapterFactory extends CallAdapter.Factory {
@Override
public CallAdapter<?> get(final Type returnType, Annotation[] annotations, Retrofit retrofit) {
return new CallAdapter<Object>() {
@Override
public Type responseType() {
return returnType;
}
@Override
public <R> Object adapt(Call<R> call) {
try {
return call.execute().body();
} catch (IOException e) {
e.printStackTrace();
return null;
}
}
};
}
}
Service方法和CallAdapter的对应关系如下：
2.3 Converter和Converter.Factory
Converter的作用是将网络请求结果ResponseBody转换为我们希望的返回值类型。Converter.Factory的作用是获取Converter，这里很明显采用了静态工厂模式。如果你不设置ConverterFactory，那么调用WeatherDataInterface的三个方法都会崩溃，提示：Could not locate ResponseBody converter for class MiWeatherData。这是因为使用了默认的BuiltInConverters，而我们的方法不满足获取到responseBodyConverter的要求，所以崩溃，代码截图如下：
所以，如果不想设置Converter，那么我们的方法返回值必须为ResponseBody或者Void，如果是ResponseBody，且有@Streaming注解，会使用StreamingResponseBodyConverter，否则使用BufferingResponseBodyConveter。这两者基本都是原封不动的返回ResponseBody。而VoidResponseBodyConverter返回null~感觉这点比较坑，干点什么不好，非要返回null
Retrofit提供了多个Converter供选择，比如将Json转换为Object的GsonConverterFactory，如下图：
这也是Retrofit的一大特点---足够的开放、灵活。
2.4 OkHttpCall
OkHttpCall继承自interface Call，主要的作用是调起执行网络请求以及返回当前请求状态状态，但是真正的网络请求其实在okhttp3.Call接口，接口定义如下：
这个接口的实现类是okhttp3.RealCall，可以发现，Retrofit的Call接口和okhttp3的Call接口定义几乎是完全一样的，目的当然是实现OCP，这样做的好处显而易见：
1.利于扩展，retrofit2.Call接口可以有其他的实现类，不一定非要用OkHttp，只不过OkHttpCall用的恰好是OkHttp而已。
2.解耦，为了实现第一个目的，retrofit2.Call接口的存在就是理所当然的。
2.5 ParameterHandler
这是一个辅助类，用于解析我们自己定义的Method，由于我们是通过注解的方式来表达各种信息，比如请求类型(POST、GET)、Query参数、Body等，因此需要解析出来。不在主线，因此不作分析，但是里面的实现蛮复杂的，是个细致活儿。
2.6 RxJavaCallAdapterFactory分析
CallAdapterFactory的作用及工作机理前面已经介绍过了，RxJavaCallAdapterFactory的作用也是一样的，只不过RxJavaCallAdapterFactory中内部又定义了三种CallAdapter：ResponseCallAdapter、ResultCallAdapter和SimpleCallAdapter，根据返回值类型决定到底使用哪个，代码如下：
本质上处理流程是一致的，都是按照RxJava的套路执行请求并处理返回值的。
关于Retrofit中主要类的分解到此结束，之所以这么繁琐的画UML图，目的是为了更加深入的了解作者设计类的思路，比如作者是如何考虑一个类的功能、边界在哪里等。