Annotation元数据（一）
一、Annotation究竟是什么？
是java5.0中的新特征
数据的数据（元数据）
Annotation和访问修饰符一样，应用于包、类型、构造方法、方法、成员变量、参数、本地变量的声明中。
信息以“name=value”方式保存
annotation类型是一种接口，通过java反射方式进行访问。
二、Annotation涉及的概念？
annotation：
是java5.0中新增的语法，它的行为十分类似public、final这样的修饰符
annotation类型 ：
annotation类型定义了annotation的名字、类型、成员默认值。
一个annotation类型是一个特殊的java接口，
annotation成员（是一个特殊的方法）：
annotation的成员在annotation类型中以无参数的方法的形式被声明。
可以有默认值（使用default关键字）
marker annotation类型：
没有任何成员。
三、Java5.0中的标准Annotation
Override：
java.lang.Override是一个marker annotation类型，它被用作标注方法。
作用：说明了被标注的方法重载了父类的方法
使用场合：这个annotaton常常在我们试图覆盖父类方法而确又写错了方法名时发挥威力。
Deprecated：
是一个marker annotation
作用： 用于标记已过期或不赞成使用的元素（如方法）
SuppressWarnings：
@SuppressWarnings被用于有选择的关闭编译器对类、方法、成员变量、变量初始化的警告。
serial
@SuppressWarnings("deprecation")
@SuppressWarnings(" unchecked ")
@Target 修饰的目标，是类、方法、字段
@Retention 保留时间，编译、运行
四、自定义Annotation语法
Public @interface 名称{
Public 类型 成员1() [default 默认值];
Public 类型 成员2() [default 默认值];
Public 类型 成员3() [default 默认值];
}
返回类型
可以是基本数据类型,数组和字符串
不可以是日期类型
自定义Annotation语法
/**
* 表示Column是实现了java.lang.annotation.Annotation接口的一个类
* 注释类与接口的区别
* 1） interface @interface
* 2) 注释的方法可带默认值
* 3） 指定Retention 在程序运行时仍然存在
* 4) 指定Target 主要修饰方法
*/
@Retention(RetentionPolicy.RUNTIME)
@Target(ElementType.METHOD)
public @interface Column
{
public String name(); //返回数据库表的字段名
public int len() default 20; //返回字段长度
public boolean unique(); //是否可空
}
例子1：自定义一个最简单的Annotation——IfInvoke
package com.aptech.servlet;
import java.lang.annotation.Retention;
import java.lang.annotation.RetentionPolicy;
@Retention(RetentionPolicy.RUNTIME)
public @interface IfInvoke {
public boolean invoke();
}
注意：
@Retention(RetentionPolicy.RUNTIME)：表示在运行时元数据还能被访问
@interface：相当于实现了Annotation接口
Invoke：不需要实现的方法，并且返回类型有比较大的限制
例子2：自定义一个最简单的Annotation——Employee(1)
Employee类的基本结构
package com.aptech.servlet;
import （导入略）
public class Employee {
@IfInvoke(invoke = true)
public void extraSalary(){
System.out.println("雇员是业务员，业务提成是：3000元");
}
}注意：
@IfInvoke(invoke = true)：相当于invoke方法的返回值为true
调用代码：
Employee emp = new Employee();
try {
Method m = emp.getClass().getMethod("extraSalary", new Class[]{});
Annotation[] as = m.getAnnotations();
for(Annotation a : as){
if(a instanceof IfInvoke){
IfInvoke ii = (IfInvoke)a;
boolean b = ii.invoke();
if(b){
m.invoke(emp, new Object[]{});
}else{
System.out.println("不是业务员，不被调用");
}
}
}
} catch (Exception e1) {
e1.printStackTrace();
}
五、Annotation类型的annotation
Annotation类型可以被它们自己所标注。
Java5.0定义了4个标准的meta-annotation类型，它们被用来提供对其它annotation类型作说明。
这些类型和它们所支持的类在java.lang.annotation包中可以找到，主要有以下几个：
Target
Retention
Documented
六、Target类型
Target
描述了annotation所修饰的程序成员的类型 。
Target类型有唯一的value作为成员。这个成员的类型是ElementType[]类型的，ElementType类型是可以被标注的程序成员的枚举类型。
ElementType类型定义如下：
public enum ElementType {
TYPE, // Class, interface, or enum (but not annotation)
FIELD, // Field (including enumerated values)
METHOD, // Method (does not include constructors)
PARAMETER, // Method parameter
CONSTRUCTOR,// Constructor
LOCAL_VARIABLE,// Local variable or catch clause
ANNOTATION_TYPE,// Annotation Types (meta-annotations)
PACKAGE // Java package
}
七、Retention 类型
Retention描述了annotation是否被编译器丢弃或者保留在class文件中。
通常有几种不同的选项：
将注释保留在编译后的类文件中，并在第一次加载类时读取它。
将注释保留在编译后的类文件中，但是在运行时忽略它。
按照规定使用注释，但是并不将它保留到编译后的类文件中。
这三种选项用 java.lang.annotation.RetentionPolicy 枚举表示 。
public enum RetentionPolicy {
SOURCE,// Annotation is discarded by the compiler
CLASS,// Annotation is stored in the class file, but ignored by the VM
RUNTIME// Annotation is stored in the class file and read by the VM
}
默认情况下，annotation被保存在class文件中，但在运行时并不能被反射访问。 （ RetentionPolicy. CLASS ）
八、Documented类型
Documented 是一个标记注释 。
Documented 表示注释应该出现在类的Javadoc 中。
例如
在IfInvoke注释类型中，按如下定义：
@Retention(RetentionPolicy.RUNTIME)
public @interface IfInvoke {
public boolean invoke();
}
Employee类的extraSalary()方法生成的注释如下：
public void extraSalary() ［和普通没什么两样］
如果改成如下的定义方式：
@Documented
@Retention(RetentionPolicy.RUNTIME) //表示在运行时元数据还能被访问
public @interface IfInvoke {
public boolean invoke();
}
Employee类的extraSalary()方法生成的注释如下：
@IfInvoke(invoke=true)
public void extraSalary()
也就是说，javadoc工具会将Annotation抽取出并添加到HTML文件中
一个稍微复杂的示例
有一个注释类型如下：
public @interface ComplexAnnotation {
public enum Sex{男, 女};
public String[] love();//爱好
public Sex sex() default Sex.女;//性别
public String name();//姓名
public int age();//年龄
}
问题：
请将该注释类型补充完整。
将该注释类型注释某一个类，赋值后将值读取出来并打印在Console，参考结果如下：
李赞红
25
男
游泳 爬山
import java.lang.annotation.Annotation;
@AnnotationDmo(Loves ={"爬山","游泳"} ,
sex= AnnotationDmo.Sex.男,
age = 25,name="李赞红")
public class App {
/**
* @param args
*/
public static void main(String[] args) {
// TODO Auto-generated method stub
Class cl=App.class;
AnnotationDmo[] ann=(AnnotationDmo[])cl.getAnnotations();
for(AnnotationDmo a:ann){
if(a instanceof AnnotationDmo){
AnnotationDmo an =(AnnotationDmo)a;
System.out.println(an.name());
System.out.println(an.age());
System.out.println(an.sex());
System.out.println(an.sex());String Loves= "";
for(String s : an.Loves()){
Loves += s + " ";
}
System.out.println(Loves);
}
}
}
}
思考：
注释类型中的成员可以有返回值，通过default关键字定义。
成员返回值类型不可以为java.util.Date或包装类等类型，可以是String或基本数据类型。
成员返回值类型可以是枚举类型。注意枚举类型的定义方法和访问方法。
访问方法：ComplexAnnotation.Sex.男