java的注解解释

 @interface用来声明一个注解，其中的每一个方法实际上是声明了一个配置参数。方法的名称就是参数的名称，返回值类型就是参数的类型（返回值类型只能是基本类型、Class、String、enum）。可以通过default来声明参数的默认值。

四个元注解分别是：@Target,@Retention,@Documented,@Inherited ，再次强调下元注解是java API提供，是专门用来定义注解的注解，其作用分别如下：

      @Target 表示该注解用于什么地方，可能的值在枚举类 ElemenetType 中，包括： 

          ElemenetType.CONSTRUCTOR----------------------------构造器声明 

          ElemenetType.FIELD --------------------------------------域声明（包括 enum 实例） 

          ElemenetType.LOCAL_VARIABLE------------------------- 局部变量声明 

          ElemenetType.METHOD ----------------------------------方法声明 

          ElemenetType.PACKAGE --------------------------------- 包声明 

          ElemenetType.PARAMETER ------------------------------参数声明 

          ElemenetType.TYPE--------------------------------------- 类，接口（包括注解类型）或enum声明 

           

     @Retention 表示在什么级别保存该注解信息。可选的参数值在枚举类型 RetentionPolicy 中，包括： 

          RetentionPolicy.SOURCE ---------------------------------注解将被编译器丢弃 

          RetentionPolicy.CLASS -----------------------------------注解在class文件中可用，但会被VM丢弃 

          RetentionPolicy.RUNTIME VM-------将在运行期也保留注释，因此可以通过反射机制读取注解的信息。 

           

      @Documented 将此注解包含在 javadoc 中 ，它代表着此注解会被javadoc工具提取成文档。在doc文档中的内容会因为此注解的信息内容不同而不同。相当与@see,@param 等。

       

      @Inherited 允许子类继承父类中的注解。

简单演示下如何使用：

package com.tmser.annotation;

 

import java.lang.annotation.ElementType;

import java.lang.annotation.Target;

 

@Target(ElementType.PACKAGE)

@Retention(RetentionPolicy.RUNTIME)

 

public @interface TestA {

 

}

下面改下我们的测试类：

package com.tmser.annotation;

 

import java.util.HashMap;

import java.util.Map;

 

 

@TestA(name="type",gid=Long.class) //类成员注解

public class UserAnnotation {

@TestA(name="param",id=1,gid=Long.class) //类成员注解

private Integer age;

@TestA (name="construct",id=2,gid=Long.class)//构造方法注解

public UserAnnotation(){

}

@TestA(name="public method",id=3,gid=Long.class) //类方法注解

public void a(){

Map m = new HashMap(0);

}

@TestA(name="protected method",id=4,gid=Long.class) //类方法注解

protected void b(){

Map m = new HashMap(0);

}

@TestA(name="private method",id=5,gid=Long.class) //类方法注解

private void c(){

Map m = new HashMap(0);

}

public void b(Integer a){ 

}

}

下面到了最重要的一步了，就是如何读取我们在类中定义的注解。只要读取出来了使用的话就简单了。

package com.tmser.annotation;

 

import java.lang.annotation.Annotation;

import java.lang.reflect.Constructor;

import java.lang.reflect.Method;

 

public class ParseAnnotation {

 

public static void parseTypeAnnotation() throws ClassNotFoundException {  

        Class clazz = Class.forName("com.tmser.annotation.UserAnnotation"); 

        

        Annotation[] annotations = clazz.getAnnotations();  

        for (Annotation annotation : annotations) {  

        TestA testA = (TestA)annotation;

            System.out.println("id= ""+testA.id()+""; name= ""+testA.name()+""; gid = "+testA.gid());  

        }  

    } 

public static void parseMethodAnnotation(){

Method[] methods = UserAnnotation.class.getDeclaredMethods();  

        for (Method method : methods) {  

             

            boolean hasAnnotation = method.isAnnotationPresent(TestA.class);  

            if (hasAnnotation) {  

                 

            TestA annotation = method.getAnnotation(TestA.class);  

                System.out.println("method = " + method.getName()  

                        + " ; id = " + annotation.id() + " ; description = "  

                        + annotation.name() + "; gid= "+annotation.gid());  

            }  

        }  

}

public static void parseConstructAnnotation(){

Constructor[] constructors = UserAnnotation.class.getConstructors();  

        for (Constructor constructor : constructors) { 

         

            boolean hasAnnotation = constructor.isAnnotationPresent(TestA.class);  

            if (hasAnnotation) {  

                 

            TestA annotation =(TestA) constructor.getAnnotation(TestA.class);  

                System.out.println("constructor = " + constructor.getName()  

                        + " ; id = " + annotation.id() + " ; description = "  

                        + annotation.name() + "; gid= "+annotation.gid());  

            }  

        }  

}

public static void main(String[] args) throws ClassNotFoundException {

parseTypeAnnotation();

parseMethodAnnotation();

parseConstructAnnotation();

}

}

先别说话，运行：

id= "0"; name= "type"; gid = class java.lang.Long

method = c ; id = 5 ; description = private method; gid= class java.lang.Long

method = a ; id = 3 ; description = public method; gid= class java.lang.Long

method = b ; id = 4 ; description = protected method; gid= class java.lang.Long

constructor = com.tmser.annotation.UserAnnotation ; id = 2 ; description = construct; gid= class java.lang.Long

看到了吧，我们定义的注解都完整的输出了，你要使用哪个，直接拿去用就好了。