java @interface 注解详解及实例

java @interface 注解详解及实例

1 简介

在Java中，定义注解其实和定义接口差多不，只需要在interface前添加一个@符号就可以，即 @interface Zhujie{ }，这就表明我们定义了一个名为 @Zhujie 的注解。注解中的每一个方法定义了这个注解类型的一个元素，特别注意：注解中方法的声明中一定不能包含参数，也不能抛出异 常；方法的返回值被限制为简单类型、String、Class、emnus、注释，和这些类型的数组，但方法可以有一个缺省值。

注解相当于一种标记，在程序中加上了注解就等于为程序加上了某种标记，JAVAC编译器、开发工具和其他程序可以用反射机制来了解咱们的类以及各种元素上有无标记，如果找到标记，就做相应的事。例如，@Deprecated可以标记在一些不建议被使用的类、方法和字段上，如果有人使用了，就给出警告。

2 元注解

注解 @Retention 可以用来修饰注解，是注解的注解，称为元注解。Retention注解有一个属性value，是RetentionPolicy类型的，而Enum RetentionPolicy是一个枚举类型，这就决定了Retention注解应该如何去操作，也可以理解为Rentention 搭配 RententionPolicy来使用。RetentionPolicy有3个值，分别为：CLASS 、RUNTIME 和 SOURCE。

1. 用@Retention(RetentionPolicy.CLASS)修饰的注解，表示注解的信息被保留在class文件(字节码文件)中当程序编译时，但不会被虚拟机读取在运行的时候；
2. 用@Retention(RetentionPolicy.SOURCE)修饰的注解,表示注解的信息会被编译器抛弃，不会留在class文件中，注解的信息只会留在源文件中；
3. 用@Retention(RetentionPolicy.RUNTIME)修饰的注解，表示注解的信息被保留在class文件(字节码文件)中，当程序编译时，会被虚拟机保留在运行时。
   

3 使用示例

首先，创建一个简单的注解：

public @interface Coder { 　　 int personId(); 　　 String company() default "[unassigned]";}