欢迎来到代码驿站!

JAVA代码

当前位置:首页 > 软件编程 > JAVA代码

JDK 5 提供的注解:Target、Inherited和Documented的区别

时间:2021-06-14 09:47:16|栏目:JAVA代码|点击:

JDK 5提供的注解,除了Retention以外,还有另外三个,即Target 、Inherited 和 Documented。

Target 目标即Target注解用在哪里, 定义了注解使用的时机,即注解所适用的程序元素的种类。如果注解类型声明中不存在 Target 元注解,则声明的类型可以用在任一程序元素上。如果存在这样的元注解,则编译器强制实施指定的使用限制。

Target 定义如下:

@Documented
@Retention(RetentionPolicy.RUNTIME)
@Target(ElementType.ANNOTATION_TYPE)
public @interface Target {
  ElementType[] value();
}

可以看到,Target 只有一个value属性,类型为枚举类型ElementType。ElementType 声明如下:

public enum ElementType {
  /** 注解可以用在类、接口(包括注解类型)或枚举声明 */
  TYPE,
  /** 字段声明(包括枚举常量) */
  FIELD,
  /** 方法声明 */
  METHOD,
  /** 参数声明 */
  PARAMETER,
  /** 构造方法声明 */
  CONSTRUCTOR,
  /** 局部变量声明 */
  LOCAL_VARIABLE,
  /** 注解类型声明 */
  ANNOTATION_TYPE,
  /** 包声明 */
  PACKAGE
}

Documented注解表明制作javadoc时,是否将注解信息加入文档。如果注解在声明时使用了@Documented,则在制作javadoc时注解信息会加入javadoc。注解声明如下:

@Documented
@Retention(value=RUNTIME)
@Target(value=ANNOTATION_TYPE)//说明该注解只能在声明注解时使用,即元注解
public @interface Documented {}

Inherited 注解同样是元注解,声明如下:

@Documented
@Retention(value=RUNTIME)
@Target(value=ANNOTATION_TYPE)
public @interface Inherited {}

Inherited 注解表明注解是否会被子类继承,缺省情况是不继承的。当注解在声明时,使用了@Inherited注解,则该注解会被使用了该注解的类的子类所继承。

上一篇:intellij idea使用git stash暂存一次提交的操作

栏    目:JAVA代码

下一篇:Window搭建部署RocketMQ步骤详解

本文标题:JDK 5 提供的注解:Target、Inherited和Documented的区别

本文地址:http://www.codeinn.net/misctech/141850.html

推荐教程

广告投放 | 联系我们 | 版权申明

重要申明:本站所有的文章、图片、评论等,均由网友发表或上传并维护或收集自网络,属个人行为,与本站立场无关。

如果侵犯了您的权利,请与我们联系,我们将在24小时内进行处理、任何非本站因素导致的法律后果,本站均不负任何责任。

联系QQ:914707363 | 邮箱:codeinn#126.com(#换成@)

Copyright © 2020 代码驿站 版权所有