当前位置:首页 > 开发 > 编程语言 > Java > 正文

[Java 8] Java 8 中的可重复注释

发表于: 2014-03-24   作者:cucaracha   来源:转载   浏览:
摘要: 在有的情况下,你可能想要在同一个元素上面使用相同的 Annotation 注释多次。这在 Java 8 版本之前是做不到的。从 Java 8 开始提供了可重复注释(repeating annotations)能够让你达到这个目的。 什么时候需要用到可重复注释呢?假设你需要让一个方法在每个月的最后一天和每周五的 23:00 执行一次,那么你可以像下面这样添加注释: @Schedule
在有的情况下,你可能想要在同一个元素上面使用相同的 Annotation 注释多次。这在 Java 8 版本之前是做不到的。从 Java 8 开始提供了可重复注释(repeating annotations)能够让你达到这个目的。

什么时候需要用到可重复注释呢?假设你需要让一个方法在每个月的最后一天和每周五的 23:00 执行一次,那么你可以像下面这样添加注释:

@Schedule(dayOfMonth="last")
@Schedule(dayOfWeek="Fri", hour="23")
public void doPeriodicCleanup() { ... }


上面这个例子在方法上添加了可重复注释,当然,你也可以像其它 Annotation 一样,将重复注释添加到任何你想添加的地方。例如,如果你想要让你的类处理未授权的访问异常,你可以像下面这样添加注释:

@Alert(role="Manager")
@Alert(role="Administrator")
public class UnauthorizedAccessException extends SecurityException { ... }

为了兼容性考虑,可重复注释是保存在容器 Annotation(container annotation)中的,在编译的时候由 Java 编译器自动生成容器 Annotation,并将可重复注释存放到容器 Annotation 中。因此为了让编译器能够做到这一点,你的代码中必须要包含两个 Annotation 声明。下面看看步骤:

第一步、声明可重复 Annotation 类型

Annotation 类型必须要添加 @Repeatable 元注释,例如:

@Repeatable(Schedules.class)
public @interface Schedule { ... }


@Repeatable 后面的小括号中是用来存放可重复注释的容器 Annotation 名称,容器 Annotation 由 Java 编译器生成,并用来存放可重复注释。在这个例子中,容器 Annotation 名称是 Schedules,因此可以这么说,@Schedule 是存放在 @Schedules 中的。
记住,如果要在 Java 的同一个元素上重复使用注释,那么在声明注释的时候 @Repeatable 元注释不可或缺,否则会有编译错误。

第二步、声明容器 Annotation 类型

容器 Annotation 必须有个数组类型的 value 元素。并且数组中各个元素的类型必须是可重复注释的类型。例如:

public @interface Schedules {
    Schedule[] value;
}


获取 Annotation

在 Java API 中提供了反射 API 来获取 Annotation。例如 AnnotatedElement.getAnnotationByType(Class),这个方法返回一个 Annotatoin。但是如果一个元素上有多个重复 Annotation 的话,用这个方法只会返回容器 Annotation 中的第一个 Annotation。在 Java 8 中提供了更多的 API 来获取容器 Annotation 中的所有可重复注释,例如 AnnotatedElement.getAnnotations(Class) 等,可参看 Java API 获取更多这方面的信息。

文章来源: http://www.aptusource.org/2014/03/java-8-repeat-annotations/

[Java 8] Java 8 中的可重复注释

  • 0

    开心

    开心

  • 0

    板砖

    板砖

  • 0

    感动

    感动

  • 0

    有用

    有用

  • 0

    疑问

    疑问

  • 0

    难过

    难过

  • 0

    无聊

    无聊

  • 0

    震惊

    震惊

版权所有 IT知识库 CopyRight © 2009-2015 IT知识库 IT610.com , All Rights Reserved. 京ICP备09083238号