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! )