注解

1基本注解

了解注解及java提供的几个基本注解:
先通过@SuppressWarnings的应用让大家认识和了解一下注解：
通过System.runFinalizersOnExit(true);的编译警告引出@SuppressWarnings("deprecation") 


@Deprecated
直接在刚才的类中增加一个方法，并加上@Deprecated标注，在另外一个类中调用这个方法。


@Override
public boolean equals(Reflect other)方法与HashSet结合讲解




总结：
注解相当于一种标记，在程序中加了注解就等于为程序打上了某种标记，没加，则等于没有某种标记，以后，javac编译器，开发工具和其他程序可以用反射来了解你的类及各种元素上有无何种标记，看你有什么标记，就去干相应的事。标记可以加在包，类，字段，方法，方法的参数以及局部变量上。
看java.lang包，可看到JDK中提供的最基本的annotation。 




注释：
首先编写一个AnnotationTest类，由其中一个deprecated问题System.runFinalizersOnExit(true);, 引出SuppressWarnings注解来解决刚才的警告。


接着用如何实现这种功能引出@Deprecated的讲解，例如：
@Deprecated
public static void sayHello()
{
System.out.println("传智播客，你好！");
}


结合前面反射框架的例子，当集合为Hashset时，
System.out.println(set.size());//期望结果为2，但实际为3
        这时候在User类的equals方法上加上@Override，发现了问题。

2注解的应用结构

注解就相当于一个你的源程序中要调用的一个类，要在源程序中应用某个注解，得先准备好了这个注解类。就像你要调用某个类，得先有开发好这个类。




注解类-->应用了“注解类”的类-->对“应用了注解类的类”进行反射操作的类

3自定义注解及其应用

定义一个最简单的注解：public @interface MyAnnotation {}


把它加在某个类上：@MyAnnotation public class AnnotationTest{}


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


根据发射测试的问题，引出@Retention元注解的讲解，其三种取值：RetetionPolicy.SOURCE、RetetionPolicy.CLASS、RetetionPolicy.RUNTIME;分别对应：java源文件-->class文件-->内存中的字节码。
思考：@Override、@SuppressWarnings和@Deprecated这三个注解的属性值分别是什么？


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


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

4为注解增加基本属性

什么是注解的属性
一个注解相当于一个胸牌，如果你胸前贴了胸牌，就是传智播客的学生，否则，就不是。如果还想区分出是传智播客哪个班的学生，这时候可以为胸牌在增加一个属性来进行区分。加了属性的标记效果为：@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")。

5为注解增加高级属性

数组类型的属性
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。




备注:
枚举和注解都是特殊的类，不能用new 创建它们的实例对象，创建枚举的实例对象就是在其中增加元素。
在程序中如何创建出一个注解的实例对象啊？直接用@放上一个标记即可
MetaAnnotation注解的定义：
public @interface MetaAnnotation {
   String value();
}


看java语言规范：
打开j3toc.html页面后，搜索annotation，进入9.6节，在其中的第5个Discussion部分就有属性类型的讲解说明，可以知道枚举的属性类型包括：基本数据类型，String，Class，枚举，其他注解，以及这些类型的数组。