注解

2017-10-10 本文已影响0人奋斗的磊哥

注解的定义

注解(Annotation)就是一种标签，可以插入到源代码中，我们的编译器可以对他们进行逻辑判断，或者我们可以自己写一个工具方法来读取我们源代码中的注解信息，从而实现某种操作。需要申明一点，注解不会改变编译器的编译方式，也不会改变虚拟机指令执行的顺序，它更可以理解为是一种特殊的注释，本身不会起到任何作用，需要工具方法或者编译器本身读取注解的内容继而控制进行某种操作。

注解的作用

1、格式检查：告诉编译器信息，比如被@Override标记的方法如果不是父类的某个方法，IDE会报错；
2、减少配置：运行时动态处理，得到注解信息，实现代替配置文件的功能；
3、减少重复工作：比如第三方框架xUtils，通过注解@ViewInject减少对findViewById的调用，类似的还有（JUnit、ActiveAndroid等）；

标准注解

在我们jdk的java.lang包中定义了三个注解，他们是：@Override，@Deprecated，@SuppressWarnnings。

元数据和注解

元数据（meta-data）就是指用来描述数据的数据，它往往是以标签的形式出现，主要用于描述代码块之间的联系。我们的注解就是一种元数据，根据它所起到的作用，我们可以大致将它分为以下三类：

编写文档：通过代码中标识的元数据生成文档
代码分析：通过代码中的元数据获取其中信息内容
编译检查：通过标记注解可以完成对代码块的检查，例如：@Override，用于检查格式

元注解

元注解就是用来注解注解的注解。定义可能有点绕，其实元注解是一种注解，他可以加在一般的注解上用于限制该注解的使用范围，生命周期等。一般在自定义注解时候使用的多。在jdk的中java.lang.annotation包中定义了四个元注解：

@Target：指定被修饰的注解的作用范围
@Retention：指定了被修饰的注解的生命周期
@Documented：指定了被修饰的注解是可以被例如Javadoc等工具文档化
@Inherited：指定了被修饰的注解修饰程序元素的时候是可以被子类继承

@Target注解和@Rerention注解：

//1、用在哪
@Target({ElementType.FIELD,ElementType.METHOD})
//2、什么时候可以用
@Retention(RetentionPolicy.RUNTIME)
public @interface Fangzheng {
    /*String value();*///只有value的时候传递参数可以不写
    String value();//这个抽象函数就可以用来创建参数
    String aa();
}

@Target还有一些其他的参数：

CONSTRUCTOR:用于描述构造器
FIELD:用于描述域
LOCAL_VARIABLE:用于描述局部变量
METHOD:用于描述方法
PACKAGE:用于描述包
PARAMETER:用于描述参数
TYPE:用于描述类、接口(包括注解类型) 或enum声明

@Retention还有一些其他参数：

SOURCE:在源文件中有效（即源文件保留）
CLASS:在class文件中有效（即class保留）
RUNTIME:在运行时有效（即运行时保留）

自定义注解

以上我们看到的标准注解，元注解都是jdk中定义好了的，如果我们想要自定义一个自己的注解就需要通过@interface来定义一个全新的注解。

//1、用在哪
@Target({ElementType.FIELD,ElementType.METHOD})
//2、什么时候可以用
@Retention(RetentionPolicy.RUNTIME)
public @interface Fangzheng {
    /*String value();*///只有value的时候传递参数可以不写
    String value();//这个抽象函数就可以用来创建参数
    String aa();
}

public class User {
    @Fangzheng(value="yanglei",aa="wenting")
    public String username;

    public User(String username) {
        super();
        this.username = username;
    }

    public User() {
        super();
        // TODO Auto-generated constructor stub
    }

    public String getUsername() {
        return username;
    }

    public void setUsername(String username) {
        this.username = username;
    }

    @Override
    public String toString() {
        return "User [username=" + username + "]";
    }
    
}

public class Test {
    public static void main(String[] args) throws NoSuchFieldException, SecurityException {
        User user= new User();
        Class cla=user.getClass();
        Field field=cla.getDeclaredField("username");
        field.setAccessible(true);
        Fangzheng anno=field.getAnnotation(Fangzheng.class);
        System.out.println(anno.value()+"  "+anno.aa());
    }
}

注解