Annotation入门

一、java SE5内置了三种定义在java.lang包中的注解(标准注解)和四种元注解。
1.标准注解：
@Override:用在方法之上，用来告诉别人这一个方法是改写父类的。

@Deprecated:建议别人不要使用旧的API的时候用的,编译的时候会用产生警告信息,可以设定在程序里的所有的元素上。

@SuppressWarnings:暂时把一些警告信息消息关闭。
eg:

package com.javaeye.annontation;

import java.util.Date;
import java.util.Map;
import java.util.TreeMap;

public class SuppressWarningsTest {
	@SuppressWarnings({"unchecked","deprecation"})
	public static void main(String[] args) {
		Map map =new TreeMap(); //map没有使用泛型，如果没有加@SuppressWarnings编译器在行号钱会有黄色叹号的警告
		map.put("hello", new Date());
		System.out.println(map.get("hello"));
	}
}

2.元注解：
(1) @Target
表示该注解可以用于什么地方，可能的ElementType参数包括：
CONSTRUCTOR:构造器的声明；
FIELD:域声明(包括enum实例);
LOCAL_VARIABLE:局部变量的声明;
METHOD:方法声明;PACKAGE:包声明;
PARAMETER:参数声明;
TYPE:类、接口(包括注解类型或enum声明)
(2) @Retention
表示需要在什么级别保存该注解信息。可选的RetentionPolicy参数包括：
SOURCE:注解将被编译器丢弃(例如：@SuppressWarnings中RetentionPolicy=source，因为仅在编译的时候告诉编译器的警告)；
CLASS:注解在class文件中可用，但会被VM丢弃(缺省);
RUNTIME:VM将在运行期间也保存注解，因此可以通过反射机制读取注解的信息。
(3) @Documented
此注解讲包含在javaDoc中。
(4) @inherited
允许子类继承父类中的注解。


二、注解的定义：

注解的定义很像接口的定义，与其他任何java接口一样，注解也会自动编译成class文件。
1.没有元素的注解成为标记注解（marker annotation）
AnnontationTest.java:

package com.annontation;
public @interface AnnontationTest {

}

2.在注解中，一般都会包含某些元素以表示某些值。当分析处理注解时，程序或工具可以利用这些值，注解的元素看起来像接口的方法，唯一的区别是你可以为其指定默认值。
修改之后的AnnontationTest.java:

package com.javaeye.annontation;
enum EnumTest{hello,world,annontation;}
public @interface AnnontationTest {
     EnumTest value() default EnumTest.hello;//defaut值    
      EnumTest value1();
}

AnnontationCase类中的方法被注解为用例：
AnnontationCase.java

package com.javaeye.annontation;

public class AnnontationCase {
	@AnnontationTest(value1 = EnumTest.world);//如果元素是value(),则可以省略value() = xx
	public void method()
	{
	    System.out.println("usecase of annotation...");
	}
	public static void main(String[] args) {
		// TODO Auto-generated method stub
		AnnontationCase annonCase = new AnnontationCase();
		annonCase.method();
	}

}

注解的元素在使用时表现为名-值对的形式，并且需要置于AnnontationTest生命之后的括号内，在method()的注解中，并没有给出value()元素的值，因此在AnnontationCase的注解处理器分析这个类时可以使用该元素的默认值。如果使用默认的value()元素，使用时可以不指出value()名，直接用缺省的值xxx来表示value()=xxx。

三、Annotation的本质
使用@interface自行定义Annotation型态时，实际上是自动继承了java.lang.Annotation接口。由编译程序自动完成其他的细节，隐式的实现了Annotation接口，不能手工继承Annotation接口。
以下的Annotation定义是错误的：

public interface Test extends Annontation
{
   //接口里定义的方法都是需要实现接口的类去实现的，所谓实现，  就是实现具体的功能。所以接口是等类来实现的，接口自然无法自我实现。同理可知，接口也不能实现接口，只能继承。 
}

在定义Annotation型态时，不能继承其他的Annotation型态或实现其他的接口。