Retrofit简单介绍:
retrofit是什么？
- Retrofit是针对于Android/Java的、基于okHttp的、一种轻量级且安全的、并使用注解的网络请求框架。
- 它有哪些优势？
首先，Retrofit使用注解方式，简化了我们的URL拼写形式，而且注解含义一目了然，简单易懂；
其次，Retrofit使用简单，结构层次分明，每一步都能清晰的表达出之所以要使用的寓意；
再者，Retrofit支持同步和异步执行，使得请求变得简单，只要调用enqueue/execute即可完成；
最后，Retrofit更大自由度的支持我们自定义的业务逻辑，如自定义Converters。
- retrofit的原理：
Retrofit使用接口+注解的形式来定义一个网络请求，现在有很多开源框架使用了注解，如Dagger2、ButterKnife等，以及Retrofit。所不同的是他们利用注解干的事却不一样。 Dagger2、ButterKnife他们在编译期间就处理注解生成代码，提供依赖注入（依赖注入和控制反转有时间再写）。Retrofit则是在运行期间处理注解，通过动态代理的方式来提供AOP（面向切面）能力。
下面从Retrofit以下几个方面来分析：
(1)建造者模式
(2)代理模式
(3)注解
- 至于HttpClient、HttpConnection、okhttp、retrofit之间联系和区别不再展开，本文更倾向是分析retrofit的原理和源码探索。
Retrofit的源码简单分析
(1)建造者模式-------创建Retrofit实例
//使用建造者模式创建Retrofit实例
Retrofit retrofit = new Retrofit.Builder()
.baseUrl("http://www.oschina.net/action/apiv2/")
.addConverterFactory(GsonConverterFactory.create())
.build();
//创建Github接口对象
NetApi netApi = retrofit.create(NetApi.class);
Call<NewListBean> newList = netApi.getNewList(0, 1, 10);
//NetApi接口的定义
public interface NetApi {
@GET("news_list")
public Call<NewListBean> getNewList(@Query("pageIndex") int pageIndex,@Query("catalog") int catalog,@Query("pageSize") int pageSize);
}
//执行异步请求
newList.enqueue(new Callback<NewListBean>() {
@Override
public void onResponse(Call<NewListBean> call, Response<NewListBean> response) {
System.out.println(response.body().obj_list.get(0).author.name);
}
@Override
public void onFailure(Call<NewListBean> call, Throwable t) {
t.printStackTrace();
}
});
这里最重要的代码就是下面这个段，使用的是建造者模式，应该很多人都熟悉
Retrofit retrofit = new Retrofit.Builder()
.baseUrl("http://www.oschina.net/action/apiv2/")
.addConverterFactory(GsonConverterFactory.create())
.build();
源码如下
//1、new Rtrofit.Builder()走的就是这个构造，Builder为Retrofit的静态内部类
public Builder() {
this(Platform.get());
}
//2、上一段代码调用
Builder(Platform platform) {
this.platform = platform;
converterFactories.add(new BuiltInConverters());
}
//3、调用.baseUrl的时候调用，返回的是Builder，建造者模式
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;
}
//4、调用.build（）的时候调用，返回的是retrofit实例
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<CallAdapter.Factory> adapterFactories = new ArrayList<>(this.adapterFactories);
adapterFactories.add(platform.defaultCallAdapterFactory(callbackExecutor));
// Make a defensive copy of the converters.
List<Converter.Factory> converterFactories = new ArrayList<>(this.converterFactories);
return new Retrofit(callFactory, baseUrl, converterFactories, adapterFactories,
callbackExecutor, validateEagerly);
}
(2)动态代理模式-------创建接口实例（代理对象）
传入我们写的接口的class对象，返回接口的代理对象
NetApi netApi = retrofit.create(NetApi.class);
源码如下：
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, 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 = loadServiceMethod(method);
OkHttpCall okHttpCall = new OkHttpCall<>(serviceMethod, args);
return serviceMethod.callAdapter.adapt(okHttpCall);
}
});
}
大家可以看到返回的是
Proxy.newProxyInstance(...);
retrofit.create()方法返回了一个动态代理对象。Java动态代理就是每当我们调用代理类里面的方法时，invoke()都会被执行，我们就可以在invoke()插入想要执行的代码，并且我们可以从该方法的参数中获取到所需要的一切信息，比如从method中获取到方法名，从args中获取到方法名中的参数信息等，这个就是Java的动态代理。大家可以看到Proxy.newProxyInstance(...)方法的最后一个参数就是InvocationHandler，InvocationHandler有一个方法是invoke，当我们执行Call<NewListBean> newList = netApi.getNewList(0, 1, 10);这段代码的时候，返回的Proxy.newProxyInstance(...)返回的代理对象，并不是NetApi的实现类对象，当我们调用netApi.getNewList(0,1,10)方法时，动态代理机制就会调用上面InvocationHandler的invoke()方法，从而我们通过代理机制在invoke()来插入我们想要加入的代码，比如我拿我女朋友的钱包去买菜，钱包就是实际对象，我就是代理对象，我在买菜的时候需要先判断钱包的钱够不够，并且我在买菜的时候才动态去判断，这个判断只有在买菜的时候才去判断。这个判断的过程就是类似invoke方法，只有方法运行的时候才被调用。点到为止，有时间专门写一篇动态代理的。
ServiceMethod serviceMethod = loadServiceMethod(method)。。。待更新
(3)java注解-------解析（代理对象）
待更新。。。。。。。
参考文章：
Retrofit简单原理分析
http://blog.csdn.net/lyric_315/article/details/52710464
Android 网络框架之Retrofit2使用详解及从源码中解析原理
http://blog.csdn.net/guiman/article/details/51480497
