Java基础-学习使用Annotation注解对象

注解(也被称为元数据)为我们在代码中添加信息提供了一种形式化的方法,使我们可以在稍后某

个时刻非常方便地使用这些数据

1-1:基本语法 Java SE5内置三种标准注解 @Override:表示当前的方法定义将覆盖超类中的方法.如果你不小心拼写错误,或者方法签名对不上被覆

盖的方法,编译器就会发出错误提示

@Deprecated:如果程序员使用了注解为它的元素,那么编译器就会发出警告信息

@SupperessWarnings:关闭不当的编译器警告信息.

Java SE5内置四种元注解

@Target:表示该注解可以用于什么地方.可能的ElementType参数包括: 1)CONSTRUCTOR:构造器的声明 2)FIELD:域声明(包括enum实例) 3)LOCAL_VARIABLE:局部变量声明 4)METHOD:方法声明 5)PACKAGE:包声明 6)PARAMETER:参数声明 7)TYPE:类、接口(包括注解类型)或enum声明

@Retention:表示需要在什么级别保存该注解信息.可选的RetentionPolicy参数包括:

1)SOURCE:注解将被编译器丢弃 2)CLASS:注解在class文件中可用,但会被VM丢弃 3)RUNTIME:VM将在运行期也保留注解,因此可以通过反射机制读取注解的信息

@Documented:将此注解包含在Javadoc中

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

大多数时候,程序员主要是定义自己的注解，并编写自己的处理器来处理它们.

1. ----------------------------- UseCase.java -------------------------      
2. package com;      
3.      
4. import java.lang.annotation.ElementType;      
5. import java.lang.annotation.Retention;      
6. import java.lang.annotation.RetentionPolicy;      
7. import java.lang.annotation.Target;      
8.      
9. @Target(ElementType.METHOD)//用来定义你的注解将应用在什么地方,本处应用为方法      
10. //用来定义该注解在哪一个级别可用,在源代码中(source)类文件中(class)或者运行时(runtime)      
11. @Retention(RetentionPolicy.RUNTIME)      
12. public @interface UseCase {      
13.  public int id();      
14.  public String description()default "no description";      
15. }      
16.      
17. ----------------------------- PasswordUtils .java -------------------------      
18. package com;      
19.      
20. public class PasswordUtils {      
21.  @UseCase(id=47,description="Passwords must contain at least one numeric")      
22.  public boolean validatePassword(){      
23.   return true;      
24.  }      
25.        
26.  @UseCase(id=48)      
27.  public String encryptPassword(String password){      
28.   return  password;      
29.  }      
30.        
31.  @UseCase(id=49,description="Jong_Cai")      
32.  public void showName(){      
33.   System.out.println("Jong_Cai");      
34.  }      
35. }     

1-2:编写注解处理器

如果没有用来读取注解的工具,那注解也不会比注释更有用.使用注解的过程中.很重要的一个部

分就是创建与使用注解处理器.Java SE5扩展了反射机制的API,以帮助程序员构造这类工具.同时,它还提

供了一个外部工具apt帮助程序员解析带有注解的Java源代码.

下面是一个非常简单的注解处理器,我们将用它来读取PasswordUtils类,并使用反射机制查

找@UseCase标记.我们为其提供了一组id值得,然后它会列出在PasswordUtils中找到的用例,以及缺失的

用例.

1. ------------------------ UseCaseTracker.java ---------------------------      
2. package com;      
3.      
4. import java.lang.reflect.Method;      
5. import java.util.ArrayList;      
6. import java.util.Collections;      
7. import java.util.List;      
8.      
9. public class UseCaseTracker {      
10.  public static void trackUseCases(List<Integer> list, Class<?> cl) {      
11.   for (Method m : cl.getDeclaredMethods()) {      
12.    UseCase us = m.getAnnotation(UseCase.class);      
13.    if (us != null) {      
14.     System.out.println("Found Use Case:" + us.id() + " "     
15.       + us.description());      
16.     list.remove(new Integer(us.id()));      
17.    }      
18.   }      
19.   for (int i : list) {      
20.    System.out.println("Warning:Missing use case-" + i);      
21.   }      
22.  }      
23.      
24.  public static void main(String[] args) {      
25.   List<Integer> list = new ArrayList<Integer>();      
26.   Collections.addAll(list, 47,48,49,50,51);      
27.   trackUseCases(list, PasswordUtils.class);      
28.  }      
29. }     

这个程序用到了两个反射的方法:getDeclaredMethods()和getAnnotation(),它们都属

于AnnotatedElement接口(class,Method与Field等类都实现了该接口).getAnnotation()方法返回指定类

型的注解对象,在这里就是UseCase,如果被注解的方法上没有该类型的注解,则返回null值.然后我们通过

调用id()和description()方法从返回的UseCase对象中提取元素的值.其中encryptPassword()方法在注

解的时候没有指定description的值,因此处理器在处理它对应的注解时,通过description()方法取得的

是默认值no description.

     本文转自xyz_lmn51CTO博客，原文链接：http://blog.51cto.com/xyzlmn/819274，如需转载请自行联系原作者