注解的格式
最简单的注解:
@Entity
@
告诉编译器这是一个注解,以下的注解名是Override
@Override
注解可以包含若干元素,元素有名字和值:
@Author(
name = "Benjamin Franklin",
date = "3/27/2003"
)
class MyClass() { ... }
@SuppressWarnings(value = "unchecked")
void myMethod() { ... }
当只有一个元素且名字是value
时,名字可以省略:
@SuppressWarnings("unchecked")
void myMethod() { ... }
如果注解一个元素都没有,圆括号可以省略。
一个声明上可以使用多个注解:
@Author(name = "Jane Doe")
@EBook
class MyClass { ... }
如果这多个注解的注解名相同,又叫做重复注解,java SE 8 release支持重复注解。:
@Author(name = "Jane Doe")
@Author(name = "John Smith")
class MyClass { ... }
Java有预先定义好的注解,也支持自定义注解,以上Override
和SuppressWarnings
是预定义注解,Author
和Ebook
是自定义注解。
注解的使用
注解可以用在声明上,比如类的声明,方法的声明,字段的声明,以及其他程序声明,当用作声明时,每个注解约定占一行。
Java SE 8 release中,注解可以用于类型的使用,如:
- 类的实例创建:
new @Interned MyObject();
- 强制类型转换
myString = (@NonNull String) str;
implements
子句
class UnmodifiableList<T> implements
@Readonly List<@Readonly T> { ... }
- 抛异常
void monitorTemperature() throws
@Critical TemperatureException { ... }
这种形式的注解称为类型注解
jdk1.8下载链接:
链接:https://pan.baidu.com/s/1n_dEHMcHgwB4AkSn76Ef_w
提取码:ayp7