Retrofit学习(二)

概述

上一篇已经记载了关于Retrofit使用的相关知识，这一片主要记录下Retrofit实现的相关原理。简要来说，主要是运用了注解，动态代理等技术，这一篇先讲下注解。

---

注解

什么是注解

首先来了解下注解是什么。
注解是自Java1.5版本引入的；同时引入的还有反射，注解的实现必须依赖反射，但是反射并不依赖注解。
注解是一种应用于类、方法、参数、变量、构造器及包声明中的特殊修饰字符。他是一种由JSR-175标准选择用来描述元数据的一种工具。
举个栗子：

@Override
public String toString() {
    return "This is to String";
}

@Override告诉编译器这个方法是重写的父类的方法，如果父类中不存在这个方法，那么编译器就会报错，提示父类中没有这个方法。但是如果toString写成了toStrring，那么没有使用@Override也是没有问题的。但是运行的结果就跟toString没有什么关系了。

为什么要引入注解

注解的常见作用有一下几种：

• 生成文档。 这是最常见的，也是java最早提供的注解。比如：@see @param @return等等
• 跟踪代码依赖性，实现替代配置文件功能。这个就类似Retrofit中的注解的功能。
• 在编译的时候进行格式检查。比如：@Override放在方法前，如果你这个方法并不是覆盖超类的方法就能检查出来。

---

原理

注解从本质上来说其实是一种接口。注解本身是不会影响程序代码的执行，无论注解怎么变化，代码都是一样的执行。Java语言解释器在工作的时候会忽略这些注解，因此在JVM中这些注解是“不起作用的”。但是Java可以通过反射的机制来访问注解信息。相关的类根据注解中的信息再决定如何改变程序的元素或者改变他们的行为。
注解与接口又存在一些区别：

• 注解类型使用的关键字是@interface而不是interface。（这个关键字声明隐含了一个信息：他是继承java.lang.annotation.Annotation接口，而不是声明了一个interface 。）
• 注解类型、方法定义是独特的、受限制的。（注解里没有直接定义成员名，方法名就是表示注解在使用时用到的成员名，而方法的返回值表示成员名的类型）

注解与接口相似的地方：他们都可以定义常量，静态成员类型。注解类型也可以像接口一样被实现或者继承。

---

自定义Annotation

在介绍如何自定义注解之前，先来了解下元注解，这些元注解在自定义注解过程中用得到
元注解
java.lang.annotation提供了四种元注解，专门用来注解其他的注解。

• @Documented：一个简单的Annotations标记注解，表示是否将注解信息添加在java文档中。
• @Retention：表示在什么级别保存该注解信息。
• @Target：表示注解用在什么地方。
• @Inherited：表示允许子类继承父类中的注解。

Retention定义了注解的生命周期，有以下几个枚举选项：

• RetentionPolicy.SOURCE:在编译阶段丢弃。这些注解在编译结束之后就不再有任何意义，所以他们不会写入字节码。 @Override，@SuppressWarnings都属于这类注解。
• RetentionPolicy.CLASS：在类加载阶段丢弃。在字节码文件的处理中有用。注解默认使用这种方式。
• RetentionPolicy.RUNTIME:始终不会丢弃，运行时期也是保留该注解，因此可以使用反射机制来读取该注解的信息。这也是我们自定义注解常用的方式。

Target 表示注解用在什么地方。如果没明确指出，默认是可以放在任何地方的。以下是一些可用的参数。需要说明的是：属性的注解是兼容的，如果你想给7个属性都能添加注解，仅仅排除一个属性，那么你需要在定义target包含的所有属性。

• ElementType.TYPE: 用于描述类。接口或enum声明
• ElementType.FIELD:用于描述实例变量
• ElementType.METHOD:用于描述方法
• ElementType.PARAMETER:用于描述参数
• ElementType.CONSTRUCTOR:用于描述构造函数
• ElementType.LOCAL_VARIABLE:用于描述局部变量
• ElementType.ANNOTATION_TYPE 用于注解另一个注解
• ElementType.PACKAGE 用于记录java文件的package信息

Inherited 定义该注释和子类的关系。

自定义注解
首先定义两个自定义的注解：

@Target(ElementType.TYPE)
@Retention(RetentionPolicy.RUNTIME)
public @interface ClassAnnotation {
   String value() default "这是一个类的注解";
}

@Target(ElementType.METHOD)
@Retention(RetentionPolicy.RUNTIME)
public @interface MethodAnnotation {
    String value() default "这是一个方法的注解";
    String name();
}

定义一个运用注解的普通类：

@ClassAnnotation
public class AnnotationUser {
    
    @MethodAnnotation(name="test method")
    public void testMethod(){
        System.out.println("测试方法");
    };
}

解释注解：

Class iAnnotationUser = Class.forName("com.test.retrofit.annotation.AnnotationUser");
            Method[] methods = iAnnotationUser.getMethods();
            boolean isAP = iAnnotationUser.isAnnotationPresent(ClassAnnotation.class);
            if(isAP){
                ClassAnnotation classAnnotation = (ClassAnnotation)(iAnnotationUser.getAnnotation(ClassAnnotation.class));
                System.out.println("类注解信息："+classAnnotation.value());
            }
            
            for(Method m:methods){
                if(m.isAnnotationPresent(MethodAnnotation.class)){
                    MethodAnnotation ma = m.getAnnotation(MethodAnnotation.class);
                    System.out.println("方法注解："+ma.value()+" 给注解成员赋值："+ma.name());
                    m.invoke(new AnnotationUser(), null);
                }
            }

运行结果：

类注解信息：这是一个类的注解
方法注解：这是一个方法的注解 给注解成员赋值：test method
测试方法

以上就是注解的相关基本知识和运用。
另外关于注解的实现，知乎上有个问答解释得较好： http://www.zhihu.com/question/24401191