Retrofit源码结构
Retrofit: 通过注解,把一个Java接口转化成一个http 请求,底层网络请求基于okhttp
从Retrofit源码结构可以看出,Retrofit 源码分成两部分
一部分是包retrofit2.http里面的,在Java接口方法中使用,用来控制http行为的注解。
一部分是retrofit2里面的,负责把REST API转化成Java接口。
Retrofit和okhttp的关系
retrofit依赖okhttp库,retrofit 所有的网络请求都是由okhttp处理,可以说retrofit是对okhttp封装了,让其使用更加简单方便。
okhttp 准确来说是一个Java库,没有Android中主线程和工作线程的概念,Android有两个限制,第一不能再主线程中直接请求网络,第二不能在工作线程中直接更新UI,所以,如果我们在Android中直接使用okhttp,需要用到Handler来传递请求结果。而如果使用retrofit,则不需要我们去创建线程执行网络请求,也不需要使用Handler把请求结果从工作线程传递到主线程。retrofit直接在主线程中发起异步请求,最后收到请求结果也是在主线程中,非常方便。
主要类和方法
Retrofit:retrofit框架的入口类,主要有两个功能:
1、通过内部类Builder配置构建Retrofit实例。Builder主要配置选项:
1. client(OkHttpClient client) :设置一个配置好的OkHttpClient实例,不配置的话retrofit会默认new一个。
2. baseUrl(String baseUrl) :设置API地址。
3. addConverterFactory(Converter.Factory factory) :设置一个数据转化工厂,比如把Json和实体类之间的转化。
4. addCallAdapterFactory(CallAdapter.Factory factory):设置一个适配器工厂,方便和其他库配合使用,如RxJava。
另外,如果我们没有设置执行任务的线程池的话,Retrofit会根据不同的平台,得到默认的线程池。
if (callbackExecutor == null) {
callbackExecutor = platform.defaultCallbackExecutor();
}
Android 中默认的线程池:
static class Android extends Platform {
@Override public Executor defaultCallbackExecutor() {
return new MainThreadExecutor();
}
@Override CallAdapter.Factory defaultCallAdapterFactory(Executor callbackExecutor) {
return new ExecutorCallAdapterFactory(callbackExecutor);
}
static class