jdk1.5-新特性之注解

        其实说起注解语法，对于任何一个Java开发人员来说都已经耳熟能详了，我们每天都在使用着 @author, @param,等等编写注释，然后用javadoc生成文档。Java的这种方便的文档生成方法受到了开发者的普遍赞誉。而从JDK1.5开始，注释语法 提供了更为强大的功能。
       注解是程序向编译器传达某种编译信息的方式。比如对一些过时的方法，编译器在编译的时候会提醒程序员：此方法不推荐使用。但是程序员觉得看到这个提示很不爽，于是说：“哥玩了几十年的程序，这个都不知道吗？你不用给我提示了，我懂滴。”于是程序员在程序中嵌入一句
@SuppressWarnings("deprecated");这行代码表示关闭方法过时提示。于是编译器就乖乖的不提示了。这就是注解！
注解的语法，除了@符号的使用以外，它基本上与java的固有语法一致，java内置了三种
注解，定义在java.lang包中。
      @Override  表示当前方法是覆盖父类的方法。使用这个注解，是告诉编译器，这里必须是覆盖父类的方法。如果你发现不是覆盖父类方法的，请打断它的腿！
      @Deprecated  表示当前元素是不赞成使用的。若在程序中使用了这个注解，编译会提示这个方法过时，但可以运行。
      @SuppressWarnings 叫压缩警告，表示关掉编译器的某些警告。告诉编译器，你少罗嗦，照编译就可以了！
下面自定义一个注解，并使用它：
编写注解类：MyAnnotation.java

package blh.review.reflect;
import java.lang.annotation.Retention;
import java.lang.annotation.RetentionPolicy;
   /* @Retention 表示在什么级别保存该注解信息。可选的 RetentionPolicy 参数包括： 
    *         RetentionPolicy.SOURCE 注解将被编译器丢弃 
    *         RetentionPolicy.CLASS 注解在class文件中可用，但会被VM丢弃 
    *         RetentionPolicy.RUNTIME VM将在运行期也保留注释，因此可以通过反射机制读取注解的信息。
    * */ 
@Retention(RetentionPolicy.RUNTIME)
public @interface MyAnnotation {
	public String anotDsc() default "Myannotation";
}

编写使用注解的类，并检查该类是否使用了注解，打印出注解的信息。

package blh.review.reflect;
import java.lang.reflect.Method;

@MyAnnotation
public class AnnotationTest {
	@MyAnnotation(anotDsc="This is an Annotation test 0!")
	public void test0(){}
	@MyAnnotation(anotDsc="This is an Annotation test 1!")
	public void test1(){}
	@MyAnnotation(anotDsc="This is an Annotation test 2!")
	public void test2(){}
	public static void main(String[] args) {
		//Use reflect return method
		Method [] annMethods= AnnotationTest.class.getMethods();
		for(Method annMethod:annMethods){
			if (annMethod.isAnnotationPresent(MyAnnotation.class)) {
				MyAnnotation annotation = annMethod.getAnnotation(MyAnnotation.class);
				System.out.println("MyAnnotation( method = " + annMethod.getName()  
						+  " , anotDsc = "  
						+ annotation.anotDsc() + " )");
			}
		}
	}
}

打印结果：

MyAnnotation( method = test0 , anotDsc = This is an Annotation test 0! )
MyAnnotation( method = test1 , anotDsc = This is an Annotation test 1! )
MyAnnotation( method = test2 , anotDsc = This is an Annotation test 2! )