在源代码中使用 Java 标注

另请参见

如果将 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-空格组合键时,将显示代码完成对话框,同时提供可用的标注类型。也可以使用代码完成功能来帮助您指定任何必要的标注成员。

另请参见
使用代码完成
关于 Web 服务中的标注
通过标注来配置 Web 服务
映射实体类
设置项目中的目标 JDK

法律声明