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”)