java 注解(转)

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

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.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";
}
编写使用注解的类，并检查该类是否使用了注解，打印出注解的信息。

Java代码
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() + " )");
}
}
}
}

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() + " )");
}
}
}
}


打印结果：

Java代码
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! )