重复注解

翻译 2016年08月29日 15:52:48

重复注解

java8的重复注解允许你将同样的注解用在声明或类型上。

例如,你写了一个类似于UNIX中的cron服务的服务。该服务运行在特定schedule里,里面有一个在给定时间就运行的方法。现在你想通过设置一个定时器来运行方法,方法doPeriodicCleanup,在每个月的最后一天和每周五的下午11:00运行。通过创建注解@Schedule,并作用于方法doPeriodicCleanup两次。第一个注解指定每个月的最后一天而第二个注解指定每周五的下午11:00.如下所示:

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

上个例子将注解作用于方法。你可以将一个独立的注解重复地应用于任何地方。例如,你有一个处理未授权访问异常的类。你通过指定了Manager的@Alert和一个指定了admins的类来注解该类。

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

由于兼容性问题,重复注解保存在一个由java编译器自动生成的注解容器中。为了让编译器生成注解容器,你需要在代码中添加两个声明。

步骤1:声明重复注解的类型

必须用@Repeatable来标明注解类型。下面演示了一个自定义重复注解@Schedule

import java.lang.annotation.Repeatable;

@Repeatable(Schedules.class)
public @interface Schedule {
  String dayOfMonth() default "first";
  String dayOfWeek() default "Mon";
  int hour() default 12;
}
括号里面的元注解@Repeatable的值,就是java编译器自动生成的用来存储重复注解的注解容器所要存储的类型。这个例子中,所要保存的注解的类型是Schedules,所以重复注解 @Schedule 声明要保存在注解@Schedules中。

在声明中使用同一个注解,如果第一次使用注解没有声明注解的值会导致编译时错误。

步骤2:声明容器注解的类型

容器注解的类型必须包含一个数组。数组的类型必须是重复注解的类型。声明容器注解的类型是Schedules的方法如下:

public @interface Schedules {
    Schedule[] value();
}

检索注解

在反射的API中有一些可以用来检索注解的方法。方法返回一个单独的注解,例如 AnnotatedElement.getAnnotationByType(Class<T>)在找到一个指定的类型的注解时就将该注解返回。如果有多个返回相同类型的注解,你可以先获取它们的注解容器。用这种方式,未执行的代码会继续执行。java8中获取多个注解的方法例如 AnnotatedElement.getAnnotations(Class<T>)。详情请看类AnnotatedElement


设计注解所需要的考虑

当设计一个注解类型时,你必须考虑那种类型的注解的基数。现在注解可以被使用0次、1次,如果声明了@Repeatable甚至可以被用多次。还可以通过 元注解@Target来限定注解所能使用的范围。例如你可以创建一个只能作用于方法和变量上的重复注解。设计注解类型很重要,你要让编程人员根据注解尽可能方便快速地找到使用的地方。









原文地址:https://docs.oracle.com/javase/tutorial/java/annotations/repeating.html

Java8新增的重复注解@Repeatble和类型注解

第一讲  重复注解 重复注解:即允许在同一申明类型(类,属性,或方法)前多次使用同一个类型注解   在java8 以前,同一个程序元素前最多只能有一个相同类型的注解;如果需要在同一个元素前使用多个相同...
  • u014207606
  • u014207606
  • 2016年08月24日 17:46
  • 1476

java 注解和 重复注解

1、什么是java注解 Annotation(注解)是JDK5.0及以后版本引入的一个特性。注解是java的一个新的类型(与接口很相似),它与类、接口、枚举是在同一个层次,它们都称作为java的...
  • u012964143
  • u012964143
  • 2015年03月02日 15:28
  • 1967

Java8新特性——可重复注解

今天是高考的日子,是大四师兄师姐答辩毕业的日子。
  • gdouchufu
  • gdouchufu
  • 2014年06月07日 20:57
  • 1352

JDK8-重复注解与类型注解(十一)

框架底层都是反射和Annotation,JDK8支持重复注解和类型注解,基于此可以开发第三方后端校验框架和重复注解的应用场景...
  • qq_34378776
  • qq_34378776
  • 2017年06月21日 15:24
  • 294

Spring MVC拦截器+注解方式实现防止表单重复提交

基本的原理: url请求时,用拦截器拦截,生成一个唯一的标识符(token),在新建页面中Session保存token随机码,当保存时验证,通过后删除,当再次点击保存时由于服务器端的Session中已...
  • zhang289202241
  • zhang289202241
  • 2017年04月26日 15:12
  • 1510

spring3.0基于注解的定时器以及执行两次的解决办法

参考: http://www.kaifajie.cn/spring/7250.html http://hi.baidu.com/hi_hi/item/db31126fb5916891c4d2494...
  • washli2001
  • washli2001
  • 2013年06月27日 10:57
  • 1104

Java 8 新特性:扩展注解(类型注解和重复注解)

一.注解(JDK1.5) 二.注解更新(JDK1.8) 类型注解和重复注解…………
  • Sun_2134
  • Sun_2134
  • 2016年05月04日 18:11
  • 6196

Java8 新特性之四---------重复注解与注解应用拓宽

自从Java 5中引入注解以来,这个特性开始变得非常流行,并在各个框架和项目中被广泛使用。不过,注解有一个很大的限制是:在同一个地方不能多次使用同一个注解。Java 8打破了这个限制,引入了重复注解的...
  • tieselingzhi
  • tieselingzhi
  • 2016年10月14日 13:34
  • 238

spring自定义注解,防止页面重复提交

注解: @Target(ElementType.METHOD) @Retention(RetentionPolicy.RUNTIME) @Documented public @interface Du...
  • yangliuhbhd
  • yangliuhbhd
  • 2016年08月31日 11:52
  • 748

SpringMVC token 防止表单重复提交,加上注释,帮助理解

package com.framework.plugin.token; import java.lang.annotation.Retention; import java.lang.annota...
  • a5601564
  • a5601564
  • 2016年09月10日 14:34
  • 2451
内容举报
返回顶部
收藏助手
不良信息举报
您举报文章:重复注解
举报原因:
原因补充:

(最多只允许输入30个字)