Retrofit源码分析 （五. Retrofit 深入分析）

Retrofit

public interface API {

@GET("/environmental/apios/showUserTest.do")
Call<UserBean> postURl(@Query("name") String name,@Query("psd") String psd,@Query("imgcode") String imgcode);
}

public class UserBean {

public String username;

public String userpsd;

public String usersex;

public String userima;
}

public static void main(String[] jiexieQi) throws Exception {

Retrofit.Builder builder = new Retrofit.Builder();
builder.baseUrl("http://192.168.1.131:8080/environmental/")
.addConverterFactory(GsonConverterFactory.create());
Retrofit  retrofit= builder.build();
API  api = retrofit.create(API.class);
Call<UserBean> bean= api .postURl("rulang","Hello","Good");
// UserBean beanData=bean.execute().body(); 获取示例对象 还有下一种展示。
bean.enqueue(new Callback<UserBean>(){
@Override
public void onResponse(Call<UserBean> call, Response<UserBean> response) {
UserBean baen=response.body();
System.out.print(""+bean);
}

@Override
public void onFailure(Call<UserBean> call, Throwable throwable) {
throwable.printStackTrace();
}
});

上面API只是一个接口，并无实例化对象，而是通过Retrofit.create代理创建对象。

然后API调用自己发起一个请求，在Retrofit.Builder类中，设置了一个转化工厂ConverterFactory。

可以是JSON，XML，Protobuf… 数据转换。

也就是Retrofit在create中通过代理返回其本身对象。

public <T> T create(final Class<T> service) {
// 检测service类是不是一个Interface类，API declarations must be interfaces.
Utils.validateServiceInterface(service);
if(this.validateEagerly) {
// 验证方法 并将方法和方法返回结果存在serviceMethodCache中...
this.eagerlyValidateMethods(service); // 实质来调用loadServiceMethod的，同事创建了serviceMethod 对象。
}

return Proxy.newProxyInstance(service.getClassLoader(), new Class[]{service}, new InvocationHandler() {
// Platform是通过反射来判断当前库运行的平台，非常简单。
// Class.forName("android.os.Build")  运行无异常，则是android平台。
// Class.forName("java.util.Optional");  反射不抱错，则是Java8+版本
//其他则是Java8下平台。
有同学问了，为什么会出现平台判断呢，因为在android中耗时处理要在子线程，然后将结果发到主线程。
Handler handler = new Handler(Looper.getMainLooper()); 这句话比较核心，网上有很多
Looper，MessageQueue，Handler，Message，Thread，HandlerThread 相关源码。

private final Platform platform = Platform.get();

public Object invoke(Object proxy, Method method, Object[] args) throws Throwable {
//如果方法是来自Object，直接调用。
if(method.getDeclaringClass() == Object.class) {
return method.invoke(this, args);
} else if(this.platform.isDefaultMethod(method)) {
//知识点： Method isDefault  是在java8之后才实现的，之前jDK之前的版本都是没实现的，默认false。
// Default methods are public non-abstract instance methods  declared in an interface.
//翻译：默认的方法是在一个接口中声明的公共非抽象实例方法。
return this.platform.invokeDefaultMethod(method, service, proxy, args);
} else {
// 核心类ServiceMethod 主要是处理注解和组装方面的事情。
ServiceMethod serviceMethod = Retrofit.this.loadServiceMethod(method);
// 回调处理类，传入方法和参数。
OkHttpCall okHttpCall = new OkHttpCall(serviceMethod, args);

// serviceMethod.callAdapter 是serviceMethod.Builder创建的。
return serviceMethod.callAdapter.adapt(okHttpCall);
}
}
});
}

其实代理的时候也没做什么，实质的调用还是API.postURl发起的，在代理中处理！

ServiceMethod.Builder构造的时候，通过method，method的参数传递build，然后构建获取所有的值。

this.methodAnnotations = method.getAnnotations();
//获取方法的注解,是个数组，因可能多个注解出现。例如示例：API.@GET

this.parameterTypes = method.getGenericParameterTypes();//参数类型，也是个数组
// 例如示例：参数Type ，java.lang.String 3个数组[]

this.parameterAnnotationsArray = method.getParameterAnnotations();//参数注解。
// 例如示例：Query，java.lang.String 3个2维数组[][]

ServiceMethod.Builder也是一个核心的注解解析器，对于缩写的Interface里面的方法注解中，解析到所对应的字段

进行解析和组装，解析中利用的是ParameterHandler来处理所有的注解解析。

下一章：承接次章，核心讲ParameterHandler类。