java中Annotation注解的定义与使用

注解也称作元数据，它为我们在源码中添加信息提供了一种形式化的方法，供我们在需要的时候读取有用的信息。

java中内置了三种注解：

注解	使用方法
@Overide	表示当前的方法的定义将覆盖超类中的方法的定义
@Deprecated	编译器将会发警告，表示这个方法或者成员变量将会在之后的版本中放弃
@SuppressWarnnings	关闭不当的编译器警告信息

那么我们应该怎么定义自己的注解类型呢？自定义注解的语法同自定义接口的语法格式类似：

@Target(ElementTYpe.FIELD)
@Retention(RetentionPolicy.RUNTIME)
public @interface Test{
  public String values();
  public int numberId();
  public String descrption() default "no description";
}

同定义接口的格式相比，定义注解有下面几个不同的点：

1. 定义注解需要使用@interface。
2. 注解中的元素都是以类似方法的形式定义的。
3. 这些元素可以设置默认值，以default后跟的值表示默认值。
4. 注解是不可以继承的，但是可以对同一个元素使用多个注解。

注解中的元素的类型是有限的，固定为下面几种：

• 所有的基本类型（int、foat、boolean等）
• String
• Class
• enum
• Annotation
• 以上类型的数组

除了以上的基本语法外，定义注解还需要四种元注解来修饰，所谓的元注解也就是用来修饰我们自定义的注解。在java种定义了4种元注解，如下：

类型	说明
@Target	表示该注解可以用在什么地方，可能的ElementType的参数包括: - CONSTRUCTOR:构造器的声明 - FIELD:域声明(包括enum实例) - LOCAL_VARIABLE:局部变量的声明 - METHOD:方法声明 - PACKAGE:包声明 - TYPE:类、接口(包括注解类型)或者enum声明 - PARAMETER:参数声明
@Retention	表示需要在什么级别上保留注解信息。可选的RetentionPolicy参数包括： - SOURCE:注解将被编译器丢弃 - CLASS:注解在class文件上可用，但是会被JVM丢弃 - RUNTIME:VM将在运行期间保留注解
@Documented	将此注解保留在javadoc中
@Inherited	允许子类继承父类中的注解

注解的处理才是重点，如果注解没有处理，那么本质上注释没有差别，注解的处理的核心就是反射机制，通过反射获取注解中的信息

下面通过一个简单例子说面注解的处理，定义一个注解如下：

@Target(ElementType.FIELD)
@Retention(RetentionPolicy.RUNTIME)
public @interface Person {
    public String name();
    public String[] children();
}

有一个简单的javabean如下：

public class Parent {
    private int id;
    private String name;
    private int age;

    public int getId() {
        return id;
    }

    public void setId(int id) {
        this.id = id;
    }

    public String getName() {
        return name;
    }

    public void setName(String name) {
        this.name = name;
    }

    public int getAge() {
        return age;
    }

    public void setAge(int age) {
        this.age = age;
    }
}

那么对于标注了@Person的成员变量，我们就可以通过注解获取信息了

public class PersonClient {

    @Person(name = "zhangsan", children = {"lilei", "hanmeimei", "xiaoyu"})
    public Parent p = new Parent();

    public static void main(String[] args) throws Exception{
        PersonClient client = new PersonClient();
        Class clz = client.getClass();
        Field field = clz.getDeclaredField("p");
        Person ap = field.getAnnotation(Person.class);
        if(ap != null){
            System.out.println("my name is:"+ap.name()+", I have children named " + Arrays.toString(ap.children()));
        }
    }
}

打印结果如下：

my name is:zhangsan, I have children named [lilei, hanmeimei, xiaoyu]

在补充两点：
1. 注解的非基本类型的值都不能是null，不管是设置的默认值，还是在使用中设置的值
2. 如果注解中某个元素的值是注解，那么他的默认的语法格式如下：
Constraints constraints() @Constraints;
在使用中如果更改元素的值的话应该如下设置:
constraints =@Constraints(value=”zhangsan”)