Java自定义注解（annotation）基本使用

时间：2022-12-22 20:14:14

一、基本概念

在开发Java程序，尤其是Java EE应用的时候，总是免不了与各种配置文件打交道。以Java EE中典型的S(pring)S(truts)H(ibernate)架构来说，Spring、Struts和Hibernate这三个框架都有自己的XML格式的配置文件。这些配置文件需要与Java源代码保存同步，否则的话就可能出现错误。而且这些错误有可能到了运行时刻才被发现。把同一份信息保存在两个地方，总是个坏的主意。理想的情况是在一个地方维护这些信息就好了。其它部分所需的信息则通过自动的方式来生成。JDK 5中引入了源代码中的注解（annotation）这一机制。注解使得Java源代码中不但可以包含功能性的实现代码，还可以添加元数据。注解的功能类似于代码中的注释，所不同的是注解不是提供代码功能的说明，而是实现程序功能的重要组成部分。Java注解已经在很多框架中得到了广泛的使用，用来简化程序中的配置。

 

二、常用的Java内置注解

Java中常用的内置注解是以下三种：

  • @Override：表示当前方法将重写父类的相同签名的方法；
  • @Deprecated：表示该类或者方法是不建议被使用的，当用户使用时编译器会给出警告；
  • @SuppressWarnings：表示暂时关闭指定的编译器警告。

三、自定义注解

自定义注解的定义与接口定义相似，当注解定义后也会被编译为class文件。

定义自己的注解需要用到Java提供的元注解去修饰自定义注解：

@Target：表示该自定义注解所适用的程序元素的种类（方法，局部变量，类等），省略则表示该注解能应用于所有程序元素，其值为java.lang.annotation.ElementType枚举类型：

  • TYPE：类、接口或枚举类型的定义；
  • FIELD：成员变量（包括enum实例）的声明；
  • METHOD：方法声明；
  • PARAMETER：方法参数声明；
  • CONSTRUCTOR：构造函数声明；
  • LOCAL_VARIABLE：局部变量声明；
  • ANNOTATION_TYPE：注解的定义；
  • PACKAGE：包声明。

@Retention：表示要在什么级别保存自定义注解信息，即该自定义注解需要保存多久。其值为java.lang.annotation.RetentionPolicy枚举类型：

  • SOURCE：自定义的注解信息只会保存在源代码，当编译时会被编译器忽略；
  • CLASS：自定义的注解信息会被编译器保存进class文件，但会在运行时被VM忽略（默认行为）；
  • RUNTIME：在CLASS的基础上，VM同时会在运行时保存注解信息，因此可以通过反射读取。

@Documented：表示自定义注解需要包含在javadoc中；

 

@Inherited：表示允许子类继承父类的自定义注解。

 

示例一：

Java代码  Java自定义注解（annotation）基本使用
  1. package annotation;  
  2.   
  3. import java.lang.annotation.ElementType;  
  4. import java.lang.annotation.Retention;  
  5. import java.lang.annotation.RetentionPolicy;  
  6. import java.lang.annotation.Target;  
  7.   
  8.   
  9. /** 
  10.  * 自定义注解@MyAnnotation，能用于方法定义，并能在运行时获取。 
  11.  * 注解中有一个属性value。 
  12.  */  
  13. @Target(ElementType.METHOD)  
  14. @Retention(RetentionPolicy.RUNTIME)  
  15. public @interface MyAnnotation {  
  16.     public String value();  
  17. }  

 

Java代码  Java自定义注解（annotation）基本使用
  1. package annotation;  
  2.   
  3. import java.lang.reflect.Method;  
  4.   
  5. /** 
  6.  * 使用自定义的注解 
  7.  */  
  8. public class AnnotationTest {  
  9.     //当注解中只有唯一的名叫value的属性时，可以只写属性值传参  
  10.     @MyAnnotation("test")  
  11.     public static void main(String[] args) {  
  12.         //使用反射获取main方法的Method对象  
  13.         Method mainMethod = AnnotationTest.class.getMethods()[0];  
  14.         //在Method对象上获取@MyAnnotation注解  
  15.         MyAnnotation myAnnotation = mainMethod.getAnnotation(MyAnnotation.class);  
  16.         //获取注解的value属性  
  17.         System.out.println("@MyAnnotation: " + myAnnotation.value());  
  18.     }  
  19. }  

 

 输出：

Java代码  Java自定义注解（annotation）基本使用
  1. @MyAnnotation: test  

 

 

示例二：

Java代码  Java自定义注解（annotation）基本使用
  1. package annotation;  
  2.   
  3. import java.lang.annotation.ElementType;  
  4. import java.lang.annotation.Retention;  
  5. import java.lang.annotation.RetentionPolicy;  
  6. import java.lang.annotation.Target;  
  7.   
  8. /** 
  9.  * 自定义注解@MyAnnotation，能用于方法定义，并能在运行时获取。 
  10.  * 注解中有两个属性id和message，message使用default提供默认值。 
  11.  */  
  12. @Target(ElementType.METHOD)  
  13. @Retention(RetentionPolicy.RUNTIME)  
  14. public @interface MyAnnotation {  
  15.     public int id();  
  16.   
  17.     public String message() default "None";  
  18. }  

 

Java代码  Java自定义注解（annotation）基本使用
  1. package annotation;  
  2.   
  3. import java.lang.reflect.Method;  
  4.   
  5. public class AnnotationTest {  
  6.     //当value不是注解中的唯一属性时，需要以  
  7.     //属性名=属性值的形式赋值  
  8.     @MyAnnotation(id = 1)  
  9.     public static void main(String[] args) {  
  10.         Method mainMethod = AnnotationTest.class.getMethods()[0];  
  11.         MyAnnotation testAnnotation = mainMethod.getAnnotation(MyAnnotation.class);  
  12.   
  13.         System.out.println("id: " + testAnnotation.id());  
  14.         //message会输出默认值None  
  15.         System.out.println("message: " + testAnnotation.message());  
  16.     }  
  17. }  

 

 输出：

Java代码  Java自定义注解（annotation）基本使用
  1. id: 1  
  2. message: None  
标签：

相关文章