annotations : 注释
好处
1.文档编制
2.编译器检查
3.代码分析
JSR 175 是编程语言的元数据工具,为将元数据合并到核心java语言中提供正式理由和说明
基本知识:
注释采用"@"标记形式,后面是注释名称,然后在需要数据时,通过name=value对向注释提供数据
注释的三个基本种类:
标记注释
没有变量,注释显示简单,由名称标识,没有提供其他数据,(@fweiAnnotation)
单一值注释
与标记注释类似,但提供一段数据,(@fweiAnnotation("value"))
完整注释
有多个数据成员,使用完整的语法(@feiAnnotation(name1="value1",name2="value2"))
可以在需要传送多个值时使用名-值对,
还可以通过花括号为注释变量提供值数组
@fwei2Annotation({
@TODO(name="value",name1="value1"),
@TODO(name="value",name1="value1"),
@TODO(name="value",name1="value1"),
})
说明:fwei2Annotation注释类型是一个具有值的变量,与单一值注释类型相符,只是这里的单一值是数组
该数组包含三个TODO注释,其中每个注释都是多值的.逗号分隔每个注释内的值,以及单个数组内的值
Override注释(标记注释)(标记注释没有成员变量)
仅用于方法(不用于类,包声明或其他构造)
指明注释的方法将覆盖超类中的方法
Deprecated注释(标记注释)
对不应再使用的方法进行注释
SuppressWarnings注释
忽视某部分warnings
SuppressWarnings注释的value值可以是单值或是数组
@SuppressWarings(value={"unchecked"})
@SuppressWarnings(value={"unchecked", "fallthrough"})
定制注释
Tiger中增加了一种新的类�
