注解(Annotation)在java中应用非常广泛。它既能帮助我们在编码中减少错误,(比如最常见的Override注解),还可以帮助我们减少各种xml文件的配置,比如定义AOP切面用@AspectJ模式代替Schema模式,特别是最近接触了一点Spring MVC,每次编写Controller的时候用@RequestMapping(),@RequestParam,@ResponseBody等等。

我们所用的java中自带的注解都是定义好了的,直接拿来用,它就能发挥作用。当然了,自己也可以定义注解。

 

注解定义:

public @interface 注解名 {
    
    //
} 

可以给注解中可以定义“属性”,暂且理解为属性吧,定义如下:

public @interface MyAnnotation {
    
    String hello(); // 定义了一个属性名hello

    String world() default "world";// 定义了一个属性名world,默认值为“world”,注意类型匹配

    int number();// 定义了一个属性名为number

    String[] value(); // 定义了一个属性为value的数组

}

后面必须有括号,修饰符只能为public或abstract,不过一般都是默认不写的。

当我们定义一个注解时,它暗自的继承了Annotation这个借口。如果手动定义了一个Interface 并继承了java.lang.annotation.Annotation,并不意味着定义了一个注解。注解只能通过@Interface方式定义。Annotation是一个接口而不是一个注解。

使用方式:

1.当我们对一个注解定义了多个属性后,在使用该注解时,除了定义了默认值的属性,其他属性都要赋值。当然,也可以显式的对含有默认值的属性赋值。

例如:

public class MyAnnotationTest{
    
    private String name;
    @MyAnnotation(hello = "", number = 0, value = { "aa" },world="world1")
    public static void main(String[] args) {
        MyAnnotationTest test = new MyAnnotationTest();
        test.method();
    }
    @MyAnnotation(hello = "hello", number = 0, value = {"a"},world="aa")
    public void method(){
        System.out.println("method");
    }
}

2.当一个注解只含有一个属性且属性名为value时,我们可以简化使用方式。

比如定义一个注解:
public @interface SingleAnnotation {
    String[] value();
}

在使用在注解时可以简化:

    @SingleAnnotation("value")
    public void singleAnnotationMethod(){
        
    }    

 注解基本的定义和使用差不多就这些了。接下来看看定义的注解为什么会生效。

@Retention注解

 为了更好的使用注解,java内置的这个注解也是需要了解的。

java.lang.annotation.Retention可以告诉编译器怎样去对待和处理我们自定义的注解。默认情况下会将Annotation的信息留在class文件中,但不会被JVM读取。

在使用Retention注解时,需要提供java.lang.annotation.RetentionPolicy的枚举值。编译器会根据设置不同的值来决定如何处理定义的注解。

RetentionPolicy定义如下:

public enum RetentionPolicy {
   
    SOURCE, //编译程序丢弃该注解,表示他不会存在于class文件中

    CLASS, //编译程序将Annotation存在class文件中(缺省)

    RUNTIME //编译程序将Annotation存在class文件中,可由JVM读取
}

 比如@SuppressWarnings注解,它所对应的@Retention(RetentionPolicy.SOURCE)是这样设置的,因为它的作用是告知编译程序来压制警告,没必要将这个信息存在于class文件中。

RetentionPolicy.RUNTIME:搭配反射机制,可以让注解被JVM读出。

一个注解信息如何被JVM读出

  1.将该注解加上 @Retention(value = RetentionPolicy.RUNTIME)。

  1.获得一个类的class对象

  2.获得这个类中被该注解修饰的方法或属性。 AccessibleObject的isAnnotationPresent(Class<? extends Annotation> annotationClass)方法可以判断一个注解是否出现,由于Field和Method类继承了AccessibleObject,所以可以判断出一个类的方法或属性是否有该注解。又因为Method实现了AnnotatedElement ,所以method可以得到它对应的注解的Annotation对象,进而可以获取注解的相关信息。

 

下面给出例子:

首先给MyAnnotation注解 加上 @Retention(value = RetentionPolicy.RUNTIME)。

 

public class MyAnnotationTest{
    
    
    public static void main(String[] args)throws Exception{
        MyAnnotationTest test = new MyAnnotationTest();
        
        Class<?> clazz = test.getClass();
        Method[] methods = clazz.getMethods();
        
        for(Method m : methods){
            //该方法是否出现MyAnnotation注解,出现为true,否则为false
            if(m.isAnnotationPresent(MyAnnotation.class)){
                
                MyAnnotation annotation = m.getAnnotation(MyAnnotation.class);
                String hello = annotation.hello();
                int number = annotation.number();
                String[] values = annotation.value();
                String world = annotation.world();
                
                m.invoke(test,new Object[]{});
                
                System.out.println("annotation.hello():" + hello);
                System.out.println("annotation.number():" + number);
                System.out.println("annotation.value():" + values[0]);
                System.out.println("annotation.world():" + world);
                
            }
        }
    }
    
    @MyAnnotation(hello = "hello", number = 100, value = {"a"},world="aa")
    public void method(){
        System.out.println("method");
    }
    public void method2(){
        System.out.println("method2");
    }
    
}

console 结果:

结果一目了然,可以让该方法执行,可以拿到该注解的所有赋值情况。

如果 MyAnnotation的Retention注解为 @Retention(value = RetentionPolicy.CLASS) 或@Retention(value = RetentionPolicy.SOURCE),那么method方法也不会执行,更不会获取到MyAnnotation的先关信息了。

@Target注解

@Documented
@Retention(RetentionPolicy.RUNTIME)
@Target(ElementType.ANNOTATION_TYPE)
public @interface Target {
    ElementType[] value();
}

它也是用来注解我们定义的注解。value为ElementType类型的枚举值。

ElementType定义:

public enum ElementType {
    /** Class, interface (including annotation type), or enum declaration */
    TYPE,

    /** Field declaration (includes enum constants) */
    FIELD,

    /** Method declaration */
    METHOD,

    /** Parameter declaration */
    PARAMETER,

    /** Constructor declaration */
    CONSTRUCTOR,

    /** Local variable declaration */
    LOCAL_VARIABLE,

    /** Annotation type declaration */
    ANNOTATION_TYPE,

    /** Package declaration */
    PACKAGE
}

好吧,不用解释了,看注释都知道每一个值是什么意思了。

如果一个注解被@Target直接,那么该注解所修饰的类型将受到限制,如果修饰的类型不匹配编译将会报错。

表示MyAnnotation注解只能修饰方法,可根据ElementType 的值以此类推。

@Documented

它表示被修饰的注解将会生成到javadoc帮助文档中。

@Inherited:允许子类继承父类的注解。缺省情况下子类并不会继承父类中的Annotation.

就算java的原生注解,一般也是被这几种注解中的一种或多种修饰,进而达到其功能。

总结:个其实java注解的原理还是反射。在运行时,因为有了注解,利用反射机制在运行时才会找到注解对应的方法,找到注解对应的值。值拿到了,方法也找到了,想干什么就干什么了,该干什么这一般应该是底层或框架做的事情。但我想应该就是这么回事吧!

 

posted on 2015-08-29 21:40  dcj199411  阅读(225)  评论(0编辑  收藏  举报