如果将 Java 平台设置为 JDK 1.5 或更高的版本,那么在利用源代码编辑器编写源代码时,可以使用 Java 标注。Java 标注在源代码中可用来标记(“注解”)类似包、方法以及字段等内容。经过标注的代码可以包含其他元数据,例如资源依赖关系、属性和部署。
由于每个标注的前辍都是一个 @ 符号,因此很容易识别。下面是一个含有 Override 标注类型的方法示例:
@Override public String getDiscountCode() { return this.discountCode; }
当使用 IDE 生成模板或源代码时,由 IDE 生成的源代码可能包含标注。例如,如果使用 IDE 生成一个实体类,则 IDE 会生成下列代码:
@Entity public class NewEntity implements Serializable { @Id @GeneratedValue(strategy = GenerationType.AUTO) private Long id; }
代码中的 @Entity 标注用来标记此类是一个实体类。@Id 和 @GeneratedValue 标注用来标记 id 字段。在实体类中,通常使用标注(而不是部署描述符)将字段映射到数据库列中。
当使用代码完成或模板生成标注时,IDE 会自动添加必要的 import 语句以支持标注。
IDE 的代码完成功能有助于您在源代码中使用标注。代码完成功能可以在源代码中建议并生成标注。当键入 @ 然后单击 Ctrl-空格组合键时,将显示代码完成对话框,同时提供可用的标注类型。也可以使用代码完成功能来帮助您指定任何必要的标注成员。