别人问你，看过Retrofit的源码没有。你说你看过。
那别人就问你，你能说下你的理解吗。
然后你就开始下面的表演。
说说你的理解
简单来说，retrofit 是一个Restful的HTTP网络请求框架。
基于HTTP，遵循Restful API 设计风格。
通过注解网络请求参数，支持同步异步网络请求参数。
支持多种数据的解析，支持Rx Java。高度解耦。
举个例子
因为我项目里使用的跟Rx 结合的。就按照返回Observable来说。
- 首先进行Retrofit的配置
Retrofit retrofit=new Retrofit.Builder()
.baseUrl("")
.addConverterFactory(GsonConverterFactory.create()) //数据解析
.addCallAdapterFactory(RxJava2CallAdapterFactory.create()) // 数据请求
.build();
这里采用了Builder模式进行build。每次会返回自己。看下Builder的构造方法。
Builder(Platform platform) {
this.platform = platform;
// 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()); //配置一个默认的converterFactory。
//实际上就是GsonConverterFactory、
}
public Builder() {
this(Platform.get());
}
我们可以看到，无参构造方法调用了上面的有参构造方法。我们继续看下 Platform.get()方法。
class Platform {
private static final Platform PLATFORM = findPlatform();
static Platform get() {
return PLATFORM;
}
private static Platform findPlatform() {
try {
Class.forName("android.os.Build");
if (Build.VERSION.SDK_INT != 0) {
return new Android();
}
} catch (ClassNotFoundException ignored) {
}
try {
Class.forName("java.util.Optional");
return new Java8();
} catch (ClassNotFoundException ignored) {
}
// 从上面看出：Retrofit2.0支持3个平台：Android平台、Java平台、IOS平台
// 最后返回一个Platform对象（指定了Android平台）给Builder的有参构造方法public Builder(Platform
// platform)
// 说明Builder指定了运行平台为Android
return new Platform();
}
@Nullable Executor defaultCallbackExecutor() {
return null;
}
CallAdapter.Factory defaultCallAdapterFactory(@Nullable Executor callbackExecutor) {
if (callbackExecutor != null) {
return new ExecutorCallAdapterFactory(callbackExecutor);
}
return DefaultCallAdapterFactory.INSTANCE;
}
boolean isDefaultMethod(Method method) {
return false;
}
// 省略部分代码
static class Android extends Platform {
@Override public Executor defaultCallbackExecutor() {
return new MainThreadExecutor();
// 返回一个默认的回调方法执行器
// 该执行器作用：切换线程（子->>主线程），并在主线程（UI线程）中执行回调方法
}
@Override CallAdapter.Factory defaultCallAdapterFactory(@Nullable Executor callbackExecutor) {
if (callbackExecutor == null) throw new AssertionError();
return new ExecutorCallAdapterFactory(callbackExecutor);
}
static class MainThreadExecutor implements Executor {
private final Handler handler = new Handler(Looper.getMainLooper());
// 获取与Android 主线程绑定的Handler
@Override public void execute(Runnable r) {
handler.post(r);
// 该Handler是上面获取的与Android 主线程绑定的Handler
// 在UI线程进行对网络请求返回数据处理等操作。
}
}
}
}
先进行判断是什么平台。然后在里面设计了可以返回主线程的操作。然后还给CallAdapter设置默认的一个CallAdapter.
我们看下.baseURL的操作。
public Builder baseUrl(String baseUrl) {
checkNotNull(baseUrl, "baseUrl == null");
HttpUrl httpUrl = HttpUrl.parse(baseUrl); // // 把String类型的url参数转化为适合OKhttp的HttpUrl类型
if (httpUrl == null) {
throw new IllegalArgumentException("Illegal URL: " + baseUrl);
}
return baseUrl(httpUrl);
}
public Builder baseUrl(HttpUrl baseUrl) {
checkNotNull(baseUrl, "baseUrl == null");
List<String> pathSegments = baseUrl.pathSegments();
if (!"".equals(pathSegments.get(pathSegments.size() - 1))) {
throw new IllegalArgumentException("baseUrl must end in /: " + baseUrl);
}
this.baseUrl = baseUrl;
return this;
}
总之，HttpUrl这个类里也有自己的Builder。经过各种操作，变成自己想要的。
.builder方法里进行了一些基本的初始化然后把值传给Retrofit的构造方法。这里就配置结束。当然了我们可以对我们的Gson啥的进行配置。OkHttp还可以添加过滤器啥的这里先不说。
- 使用的时候肯定先写一个实体类 Bean。
- 然后根据这个Bean去写我们的请求数据的API。
@GET("www.baidu.com")
Call<TestBean> getBean(@Query("s") String url); //随便写的
如果是Rx的话。就返回一个Observable。如下
@POST("user/pay/balancerecord")
Observable<AccountDetailBean> getAccountData(@Query("userId") String userId,
@Query("loginToken") String loginToken,
@Query("sign") String sign
);
- 返回什么类型仅仅是我们配置的时候添加了什么callAdapter的问题写完API我们就可以调用了。主要看下面的create方法。
Call<TestBean> call=retrofit.create(TestApi.class).getBean("s");
点击create进入源码
public <T> T create(final Class<T> 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<Object, Object> serviceMethod =
(ServiceMethod<Object, Object>) loadServiceMethod(method);
OkHttpCall<Object> okHttpCall = new OkHttpCall<>(serviceMethod, args);
return serviceMethod.callAdapter.adapt(okHttpCall);
}
});
}
这里用到了外观模式。通过InvocationHandler来进行返回一个adapter。这里面有一个类ServiceMethod。我们看下这个类的loadServiceMethod(method);方法。在这个方法直接。有个方法对我们的API这个类进行了处理，我们看下
private void eagerlyValidateMethods(Class<?> service) {
Platform platform = Platform.get();
for (Method method : service.getDeclaredMethods()) {
if (!platform.isDefaultMethod(method)) {
loadServiceMethod(method);
}
}
}
可以看到，通过反射，已经把我们的API的类中的方法存在了method中，并且调用了 loadServiceMethod(method);、这里面有一个methodCache对我们的方法进行了缓存。所以在下面再调用这个方法的时候，实际上是有缓存的。
ServiceMethod<?, ?> loadServiceMethod(Method method) {
ServiceMethod<?, ?> result = serviceMethodCache.get(method);
if (result != null) return result;
synchronized (serviceMethodCache) {
result = serviceMethodCache.get(method);
if (result == null) {
result = new ServiceMethod.Builder<>(this, method).build();
serviceMethodCache.put(method, result);
}
}
return result;
}
可以看到，调用了ServiceMethod.Builder方法。
这个方法里面的具体方法我就不贴了。大家可以自己看。里面对我们的方法的注解，参数进行遍历取出。包括GET，POST这些。还有Header的、进行取值赋值。并对其加入了切换线程的操作。
然后很重要的一句话在create里面
OkHttpCall<Object> okHttpCall = new OkHttpCall<>(serviceMethod, args);
return serviceMethod.callAdapter.adapt(okHttpCall);
OkHttpCall又对ServiceMethod进行了处理，并通过我们传入的callAdapter进行了adapt操作，进行具体的返回，比如配置了Rx的话就会返回Observable。具体怎么处理这里不详细说。
总结
Retrofit采用了外观模式统一调用创建网络请求接口实例和网络请求参数配置的方法，具体细节是：
- 动态创建网络请求接口的实例（代理模式 - 动态代理）
- 创建 serviceMethod 对象（建造者模式 & 单例模式（缓存机制））
- 对 serviceMethod 对象进行网络请求参数配置：通过解析网络请求接口方法的参数、返回值和注解类型，从Retrofit对象中获取对应的网络请求的url地址、网络请求执行器、网络请求适配器 & 数据转换器。（策略模式）
对 serviceMethod 对象加入线程切换的操作，便于接收数据后通过Handler从子线程切换到主线程从而对返回数据结果进行处理（装饰模式） - 最终创建并返回一个OkHttpCall类型的网络请求对象
感谢
- 通过微信公众号 码个蛋 看到的一篇文章，然后照着上面的思路看的源码。那个人写的非常好，写了很多文章了。看完之后也觉得没有完全理解，毕竟还有很多细节嘛。然后自己水平也有限。就想着总结下自己的思路，方便日后查看。正好看到简书可以写文章，就学习了下怎么写。照着大神的文章总结了下自己的思路，其实谈不上自己的思路，仅仅是自己看的时候清晰一点罢了。
- 大神的地址。
作者：Carson_Ho
链接：http://www.jianshu.com/p/0c055ad46b6c
來源：简书
著作权归作者所有。商业转载请联系作者获得授权，非商业转载请注明出处。
