标准注解

标准注解(P385-386)

注解接口

应用场合

目的

SuppressWarnings

除了包和注解之外的所有情况

阻止某个给定类型的警告信息

SafeVarargs

方法和构造器

断言varargs参数可安全使用

Override

方法

检查该方法是否覆盖了某一个超类方法

FunctionalInterface

接口

将接口标记为只有一个抽象方法的函数式接口

PostConstruct、PreDestory

方法

被标记的方法应该在构造之后或移除之前立即被调用

Resource

类、接口、方法、域

在类或接口上:标记为在其他地方要用到的资源。在方法或域上:为“注入”标记

Resources

类、接口

一个资源数组

Generated

全部

Target

注解

指明可以应用这个注解的那些项

Retention

注解

指明这个注解可以保留多久

Documented

注解

指明这个注解应该包含在注解项的文档中

Inherited

注解

指明当这个注解应用于一个类的时候,能够自动被它的子类继承

Repeatable

注解

指明这个注解可以在同一个项目上应用多次

用于编译的注解(P386)

  • @Deprecated

    • 可以被添加到任何不再鼓励使用的项上。所以,当你使用一个已过时的项时,编译器将会发出警告。这个注解与Javadoc标签@deprecated具有同等功效。

  • @SuppressWarnings

    • 告知编译器阻止特定类型的警告信息

  • @Override

    • 只能注解在方法上,编译器会检查具有这种注解的方法是否真正覆盖了一个来自于超类的方法。

  • @Generated

    • 供代码生成工具使用,任何生成的源代码都可以被注解,从而与程序员提供的代码区分开。

用于管理资源的注解(P386)

  • @PostConstruct和@PreDestroy

    • 用于控制对象生命周期的环境中

  • @Resource

    • 用于资源注入

元注解

@Target(P387)

@Target元注解可以应用于一个注解,以限制该注解可以应用到哪些项上。一条没有@Target限制的注解可以应用于任何项上。

@Target({ElementType.TYPE,ElementType.METHOD})
public @interface BugReport

@Target注解的元素类型

元素类型

注解适用场合

ANNOTATION_TYPE

注解类型声明

PACKAGE

TYPE

类(包括enum)及接口(包括注解类型)

METHOD

方法

CONSTRUCTOR

构造器

FIELD

成员域(包括enum常量)

PARAMETER

方法或构造器参数

LOCAL_VARIABLE

局部变量

TYPE_PARAMETER

类型参数

TYPE_USE

类型用法

@Retention(P387)

@Retention元注解用于指定一条注解应该保留多长时间。其值只能从下表中选择,默认值是RetentionPolicy.CLASS.

保留规则

描述

SOURCE

不包括在类文件中的注解

CLASS

包括在类文件中的注解,但是虚拟机不需要将它们载入

RUNTIME

包括在类文件中的注解,并由虚拟机载入。通过反射API可获得它们

@Ducumented(P387)

@Documented元注解为像Javadoc这样的归档工具提供了一些提示。应该像处理其他修饰符(例如protected和static)一样来处理归档注解,以实现其归档。

@Inherited(P388)

@Inherited

@Inherited元注解只能应用于对类的注解。如果一个类具有继承注解,那么它的所有子类都自动具有同样的注解

Last updated