@Deprecated
Deprecated也是一种标记注解(Marker Annotation)类型。当一个类型或者类型成员使用@Deprecated修饰的话,编译器将不鼓励使用这个被标注的程序元素。所以使用这种修饰具有一定的“延续性”,如果我们在代码中通过继承或者覆盖的方式使用了这个过时的类型或者成员,虽然继承或者覆盖后的类型或者成员并不是被声明为@Deprecated,但编译器仍然要报警。
注意:@Deprecated这个Annotation类型和Javadoc中的@deprecated这个Tag是有区别的:前者是java编译器识别的,而后者是被Javadoc工具所识别用来生成文档(包含程序成员为什么已经过时、它应当如何被禁止或者替代的描述)。
@SuppressWarnings
@SuppressWarnings 被用于有选择的关闭编译器对类、方法、成员变量、变量初始化的警告。
有时编译时会提出一些警告,对于这些警告有的隐藏着Bug,有的是无法避免的,对于某些不想看到的警告信息,可以通过这个注解来屏蔽。
SuppressWarnings不是一个标记注解(Marker Annotaion)。它有一个类型为String[]的成员,这个成员的值为被禁止的警告名。对于javac编译器来讲,被-Xlint选项有效的警告名也同样对@SuppressWarnings有效,同时编译器忽略掉无法识别的警告名。
Annotation语法允许在Annotation名后跟括号,括号中是使用逗号分割的name=value对用于为Annotation的成员赋值。
代码:
@SuppressWarnings(value={"unchecked","fallthrough"})
public void lintTrap() {
/* sloppy method body omitted */
}1
在这个例子中SuppressWarnings Annotation类型只定义了一个单一的成员,所以只有一个简单的value={…}作为name=value对。又由于成员值是一个数组,故使用大括号来声明数组值。
注意:我们可以在下面的情况中缩写annotation:当annotation只有单一成员,并成员命名为“value=”。这时可以省去”value=”。比如将上面的SuppressWarnings annotation进行缩写:
@SuppressWarnings({"unchecked","fallthrough"})
如果SuppressWarnings所有声明的被禁止警告个数为一个时,可以省去大括号:
@suppressWarnings("unchecked")
SuppressWarnings注解的常见参数值的简单说明:
deprecation:使用了不赞成使用的类或方法时的警告
unchecked:执行了未检查的转换时的警告,例如当使用集合时没有用泛型 (Generics) 来指定集合保存的类型;
fallthrough:当 Switch 程序块直接通往下一种情况而没有 Break 时的警告
path:在类路径、源文件路径等中有不存在的路径时的警告
serial:当在可序列化的类上缺少 serialVersionUID 定义时的警告;
finally:任何 finally 子句不能正常完成时的警告;
all:关于以上所有情况的警告
Java定义的元注解
元注解的作用就是负责注释其他注解。Java5.0定义了4个标准的meta-annotation类型,它们被用来提供对其他annotation类型作说明。
Java5.0定义的元注解:
@Target
@Retention
@Documented
@Inherited
这些类型和它们所支持的类在java.lang.annotation包中可以找到。
下面我们看一下每个元注解的作用和相应的参数的使用说明。
@Target
@Target说明了Annotation所修饰的对象范围:Annotation可被用于packages、types(类、接口、枚举、Annotation类型)、类型成员(方法,构造方法、成员变量、枚举值)、方法参数和本地变量(如循环变量、catch参数)。在Annotation类的声明中使用了target可更加明晰其修饰的目标。
作用:用于描述注解的使用范围(即:被描述的注解可以用在什么地方)
取值(ElementType)有:
CONSTRUCTOR:用于描述构造器
FIELD:用于描述域
LOCAL_VARIABLE:用于描述局部变量
METHOD:用于描述方法
PACKAGE:用于描述包
PARAMETER:用于描述参数
TYPE:用于描述类、接口(包括注解类型)或enum声明
@Retention
@Retention定义了该Annotation被保留的时间长短:某些Annotation仅出现在源代码中,而被编译器丢弃;而另一些却被编译在class文件中;编译在class文件中的Annotation可能会被虚拟机忽略,而另一些在class被装载时将被读取(请注意并不影响class的执行,因为Annotation与class在使用上是被分离的)。使用这个meta-annotation可以对Annotation的”生命周期”限制。
作用:表示需要在什么级别保存该注释信息,用于描述注解的生命周期(即:被描述的注解在什么范围内有效)
取值(RetentionPolicy)有: