注释

导航 Javadoc & Annotations 主题： Javadoc 注释简介 创建自定义注释 元注释 帮助编译器

简介

在 Java 中，注释 是一种语言结构（在 J2SE 1.5 中引入），它提供了一种将元数据直接包含在源代码中的机制。

注释可以为 Java 类、属性和方法提供元数据。从语法上看，注释可以看作是一种特殊的修饰符，可以在其他修饰符（如 public、static 或 final）可以使用的任何地方使用。

在 Java 中添加此功能的主要驱动力之一是广泛使用 XML 描述符来为 Java 类添加附加信息，即元数据。EJB、JSF、Spring、Hibernate 等框架大量使用外部 XML 描述符。这些外部描述符的问题是，这些文件超出了 Java 编译器的范围，因此无法使用编译器类型检查。在巨大的 XML 描述符文件中，一个小的拼写错误很难定位和修复。另一方面，Java 注释使用 Java 编译器类型检查功能，因此注释名称中的拼写错误将被 Java 编译器捕获。

总之，注释可以是...

• 用作编译器的信息来源；
• 可用于编译时或部署时处理；
• 在运行时进行检查。

外部链接

• [1] Java™ 注释教程