使用过ssh框架的人一定也使用过注解,尤其是在spring框架中,注解可谓是spring容器和AOP编程的重要环节。注解就是用于修饰类、全局变量、方法、参数或局部变量的接口,java中规定,注解的使用不允许影响其修饰类的存在,也就是说如果将一个类的注解全部删除,这个类也能够编译通过。java中,注解的应用主要有四个方面:类注解,全局变量注解,方法注解,参数注解。其他的还有诸如包注解和局部变量注解这里暂不作讨论。首先我们定义一个类注解如下:
package annotation; import java.lang.annotation.ElementType; import java.lang.annotation.Retention; import java.lang.annotation.RetentionPolicy; import java.lang.annotation.Target; @Retention(RetentionPolicy.RUNTIME) @Target(ElementType.TYPE) public @interface TypeAnnotation { String say() default "this is a type annotation"; }
在java中有四个元注解,分别是@RetentIon、@Target、@Inherited和@Document,@Retention指定的是注解的生命周期,其value参数的值有三个:RUNTIME、SOURCE、CLASS。RUNTIME表示当前修饰的注解是在虚拟机运行时实时加载的,也就是虚拟机中要用到该注解一次就加载一次;CLASS表示该注解在类的源文件和编译后的class文件中都存在,而在类加载器加载到虚拟机中时就会消失,SOURCE表示该注解只在源文件中存在,当编译成class文件后就不存在了。@Target指定的是当前注解可修饰的类型,可value参数可取如下几个值:Type、FIELD、METHOD、PARAMETER、PACKAGE、CONSTRUCTOR、LOCAL_VARIABLE、ANNOTATION_TYPE等。其中最主要的应用有TYPE、FIELD、METHOD、PARAMETER,其分别表示类注解,全局变量注解,方法注解,参数注解,其余几个则表示包注解,构造器注解,局部变量注解,用于注解的注解等。
注解的声明同接口的声明类似,不过要在interface关键字前加@修饰以标明其为一个注解,在使用注解是括号中的变量名称也即注解声明时方法名称,声明方法时可以默认指定该方法的默认值,即在使用注解时若不指定该“变量”则该“变量”使用该方法的默认值,这里需要说明的是,若方法名称为value,那么在使用注解时,注解中该“变量名”可以不写,如上述Retention注解中的值(这种写法要求使用该注解时只指定这一个方“变量”的值)。
如下示例我们分别演示了四个常用注解的声明方式:
package annotation; import java.lang.annotation.ElementType; import java.lang.annotation.Retention; import java.lang.annotation.RetentionPolicy; import java.lang.annotation.Target; @Retention(RetentionPolicy.RUNTIME) @Target(ElementType.FIELD) public @interface FieldAnnotation { String say() default "this is a field annotation"; }
package annotation; import java.lang.annotation.ElementType; import java.lang.annotation.Retention; import java.lang.annotation.RetentionPolicy; import java.lang.annotation.Target; @Retention(RetentionPolicy.RUNTIME) @Target(ElementType.METHOD) public @interface MethodAnnotation { String say() default "this is a method annotation"; }
package annotation; import java.lang.annotation.ElementType; import java.lang.annotation.Retention; import java.lang.annotation.RetentionPolicy; import java.lang.annotation.Target; @Retention(RetentionPolicy.RUNTIME) @Target(ElementType.PARAMETER) public @interface ParamAnnotation { String say() default "this is a parameter annotation"; }
由于注解的使用已经非常广泛,下面我们通过一个类来简单演示注解的使用:
package source; import annotation.FieldAnnotation; import annotation.MethodAnnotation; import annotation.ParamAnnotation; import annotation.TypeAnnotation; @TypeAnnotation(say = "this is modified type annotation") public class Apple { @FieldAnnotation(say = "this is modified field annotation") private String color; @MethodAnnotation(say = "this is modified method annotation") public void setColor(@ParamAnnotation String color) { this.color = color; } public String getColor() { return color; } }
由于java规定,注解的使用不能对其使用类的存在产生影响,因而注解对于使用类只能起到一定的辅助作用,一个非常好的应用实例为javaweb中的权限控制,我们可以预定义一些权限码,然后在需要权限校验的地方使用自定义的注解;不过,因为java支持反射,因而通过反射注解就可以与使用类非常好的配合在一起,从而实现某些功能,一个非常好的例子是spring中的实体类对象属性的注入。下面我们通过一个简单的例子来说明如何通过反射获取注解值,并且利用反射使其与使用类产生关系:
package test; import annotation.FieldAnnotation; import annotation.MethodAnnotation; import annotation.ParamAnnotation; import annotation.TypeAnnotation; import source.Apple; import java.lang.annotation.Annotation; import java.lang.reflect.Field; import java.lang.reflect.Method; import java.lang.reflect.Parameter; import java.lang.reflect.Type; import org.junit.Test; public class App { @Test public void testApp() throws Exception { Apple apple = Apple.class.newInstance(); // 获取被注释的类 if (Apple.class.isAnnotationPresent(TypeAnnotation.class)) { System.out.println(Apple.class.getAnnotation(TypeAnnotation.class).say()); } // 获取被注释的变量 Field[] fields = Apple.class.getDeclaredFields(); for (Field f : fields) { if (f.isAnnotationPresent(FieldAnnotation.class)) { System.out.println(f.getAnnotation(FieldAnnotation.class).say()); } } // 获取被注释的方法 Method[] methods = Apple.class.getDeclaredMethods(); for (Method m : methods) { if (m.isAnnotationPresent(MethodAnnotation.class)) { System.out.println(m.getAnnotation(MethodAnnotation.class).say()); } // 获取当前方法被注释的参数 Parameter[] parameters = m.getParameters(); for (Parameter p : parameters) { if (p.isAnnotationPresent(ParamAnnotation.class)) { System.out.println(p.getAnnotation(ParamAnnotation.class).say()); } } // 通过反射调用方法 if (m.getName().startsWith("set")) { m.invoke(apple, "Red"); } } System.out.println("通过反射调用对象的方法后对象变量的值:" + apple.getColor()); } }
运行结果如下:
this is modified type annotation this is modified field annotation this is modified method annotation this is a parameter annotation 通过反射调用对象的方法后对象变量的值:Red
上述示例简单的阐述了反射和注解之间紧密的联系。在实际应用中, 注解的使用非常广泛,通过注解可以大大简化我们的开发,并且实现某些特定的效果,本文对注解的创建,使用以及深层调用方式进行了简单的介绍,希望大家能够喜欢!