63.黑马程序员-注解

注解（Annotation）

   什么是注解？

• Annotation(注解)是JDK5.0及以后版本引入的。它可以用于创建文档，跟踪代码中的依赖性，甚至执行基本编译时检查。

注解的语法比较简单，除了@符号的使用以外，它基本上与java的固有语法一致，java内置了三种
注解，定义在java.lang包中。
      @Override  表示当前方法是覆盖父类的方法。
      @Deprecated  表示当前元素是不赞成使用的。
      @SuppressWarnings 表示关闭一些不当的编译器警告信息。
注解相当于一种标记，在程序中加了注解就等于为程序打上了某种标记，没加，则等于没有某种标记，
以后，javac编译器，开发工具和其他程序可以用反射来了解你的类及各种元素上有无何种标记，看你有什么标记，就去干相应的事。

标记可以加在包，类，字段，方法，方法的参数以及局部变量上。

 

注解的应用结构：

注解类：

@interface A

{}

应用了“注解类”的类：

@A

Class B

{}

对“应用了‘注解类’的类”进行反射操作的类：

Class C

{

B.class.isAnnotionPresent(A.class);

A a = B.class.getAnnotion(A.class);

}

自定义注解及其应用

·定义一个最简单的注解：

public @interface MyAnnotation {}

·把它加在某个类上：

@MyAnnotation

public class AnnotationTest{}

·用反射进行测试AnnotationTest的定义上是否有@MyAnnotation

·@Retention元注解（注解的注解）：

三种取值：

RetetionPolicy.SOURCE  -->  java源文件

RetetionPolicy.CLASS（默认）  -->  class文件（默认）

RetetionPolicy.RUNTIME  -->  内存中的字节码

@SuppressWarnings、@Deprecated和@Override这三个注解的属性值分别为：

@SuppressWarnings  -->  RetetionPolicy.SOURCE

@Deprecated  -->  RetetionPolicy.RUNTIME

@Override  -->  RetetionPolicy.SOURCE

·@Target元注解：

默认值为任何元素，设置Target等于ElementType.METHOD，原来加在类上的注解就报错了，改为用数组方式设置{ElementType.METHOD,ElementType.TYPE}就可以了。

·元注解以及其枚举属性值不用记，只要会看jdk提供那几个基本注解的API帮助文档的定义或其源代码，按图索骥即可查到，或者直接看java.lang.annotation包下面的类。

为注解增加基本属性

·什么是注解的属性：

一个注解相当于一个胸牌，如果你胸前贴了胸牌，就是传智播客的学生，否则，就不是。如果还想区分出是传智播客哪个班的学生，这时候可以为胸牌在增加一个属性来进行区分。加了属性的标记效果为：@MyAnnotation(color="red")

·定义基本类型的属性和应用属性：

在注解类中增加String color();

@MyAnnotation(color="red")

·用反射方式获得注解对应的实例对象后，再通过该对象调用属性对应的方法：

MyAnnotation a = (MyAnnotation)AnnotationTest.class.getAnnotation(MyAnnotation.class);

System.out.println(a.color());

可以认为上面这个@MyAnnotation是MyAnnotaion类的一个实例对象。

·为属性指定缺省值：

String color() default "yellow";

·value属性：

String value() default "zxx";

 如果注解中有一个名称为value的属性，且你只想设置value属性（即其他属性都采用默认值或者你只有一个value属性），那么可以省略value=部分，例如：@MyAnnotation("lhm")。

为注解增加高级属性

·数组类型的属性

int [] arrayAttr() default {1,2,3};

@MyAnnotation(arrayAttr={2,3,4})

如果数组属性中只有一个元素，这时候属性值部分可以省略大括号。

·枚举类型的属性

EnumTest.TrafficLamp lamp();

@MyAnnotation(lamp=EnumTest.TrafficLamp.GREEN)

·注解类型的属性

MetaAnnotation annotationAttr() default @MetaAnnotation("xxxx");

@MyAnnotation(annotationAttr=@MetaAnnotation(“yyy”) )

可以认为上面这个@MyAnnotation是MyAnnotaion类的一个实例对象，同样的道理，可以认为上面这个@MetaAnnotation是MetaAnnotation类的一个实例对象，调用代码如下：

MetaAnnotation ma =  myAnnotation.annotationAttr();

System.out.println(ma.value());

·注解的详细语法可以通过看java语言规范了解，即看java的language specification