注解,也称为元数据,为我们再代码中添加信息提供了一种形式化的方法,使我们可以在稍后某个时刻非常方便地使用这些数据。
注解使得我们能够以将由编译器来测试和验证的格式,存储有关程序的额外信息。
java内置的三种注解:
@Override,表示当前的方法定义将覆盖超类中的方法。如果你不小心拼写错误,或者方法签名对不上被覆盖的方法,编译器就会发出错误提示。
@Deprecated,如果程序员使用了注解为它的元素,那么编译器会发出警告信息。
@SuppressWarnings,关闭不当的编译器警告信息
每当创建描述符性质的类或接口时,一旦其中包含了重复性的工作,那就可以考虑使用注解来简化与自动化该过程。
20.1 基本语法
与java接口一样,注解也将会编译成class文件
@Target(ElementType.METHOD)
@Retention(RetentionPolicy.RUNTIME)
public @interface Test {}
定义注解时,会需要一些元注解,如@Target和@Retention,@Target用来定义注解应用在什么地方,例如是一个方法或者一个域。@Retention用来定义该注解在哪一个级别可用,在源代码中,类文件中还是运行时。
注解的元素看起来就像接口的方法,唯一的区别是你可以为其制定默认值。没有元素的注解称为标记注解。
@Target(ElementType.METHOD)
@Retention(RetentionPolicy.RUNTIME)
public @interface UseCase {
public int id();
public String description() default "no description";
}
20.2 编写注解处理器
在使用注解的过程中,很重要的一个部分就是创建与使用注解处理器。
public class UseCaseTracker {
public static void trackUseCases(List<Integer> useCases, Class<?> cl) {
for (Method m : cl.getDeclaredMethods()) {
UseCase uc = m.getAnnotation(UseCase.class);
if (uc != null) {
System.out.println("Found Use Case:" + uc.id() + " " + uc.description());
useCases.remove(new Integer(uc.id()));
}
}
for (int i : useCases) {
System.out.println("Warning: Missing use case-" + i);
}
}
public static void main(String[] args) {
List<Integer> useCases = new ArrayList<Integer>();
Collections.addAll(useCases, 47, 48, 49, 50);
trackUseCases(useCases, PasswordUtils.class);
}
}
利用反射获取使用注解对象的方法,然后调用id()和description()方法返回注解中定义的元素值。
注解元素可用的类型:
所以基本类型、String、Class、enum、Annotation、以上类型的数组。
元素不能有不确定的值,要么具有默认值,要么在使用注解时提供元素的值。对于非基本类型的元素,无论是在源代码中声明时,或是在注解接口中定义默认值是,都不能以null作为其值。为了绕开这个约束,只能定义一些特殊的值,例如空字符串或负数,以此表示某个元素不存在
假设希望提供一些基本的对象/关系映射功能,能够自动生成数据库表,用以存储javabean对象,使用注解的话,可以将所有信息都保存在javabean源文件中。
注解不支持继承。