jpa 2.0 注解参考.docVIP

great-framework用户参考 北京北航冠新世纪软件有限公司 great-framework 软件开发项目组 文档编号： 编写人：游明飞 编写日期：2011年3月26日 审核人： 审核日期： 审批人： 审批日期： 修订历史记录 日期 版本 说明 作者 目录修订历史记录 1 目录 1 第1章 util模块 1 1.1 @Entity 1 1.2 @Table 1 1.3 @GeneratedValue 2 1.4 @Id 3 1.5 @ManyToMany 3 1.6 @ManyToOne 5 1.7 @OneToMany 7 1.8 @OneToOne 8 1.9 @Temporal 10 1.10 @Transient 11 1.11 @Column 11 1.12 @JoinColumn 13 1.13 @JoinColumns 14 1.14 @JoinTable 15 JPA @Entity 要将 Java 类指定为 JPA 实体，请使用 @Entity 批注，如下所示： @Entity public class Employee implements Serializable { ... }@Table 默认情况下，JPA 持续性提供程序假设实体的所有持久字段均存储到一个名称为实体名称的数据库表中。 在以下条件下，使用 @Table 批注指定与实体关联的主表： 实体名称难于处理、是一个保留字、与预先存在的数据模型不兼容或作为数据库中的表名无效 需要控制表所属的目录或模式 如果希望 JPA 将某些字段持久保存到主表，而将其他字段持久保存到一个或多个辅助表。 @Table 属性 属性 必需 说明 catalog 默认值：JPA 持续性提供程序使用任何适用于数据库的默认目录。 如果默认目录不适合于应用程序，请将 catalog 设置为要使用的 String 目录名。 name 默认值：JPA 持续性提供程序假设实体的数据库表与实体类同名。默认 name 为 Employee。 如果实体类名难以处理、是一个保留字或与预先存在的数据模型不兼容，请将 name 设置为相应的数据表名称。中，JPA 将实体类 Employee 持久保存到名为 EMP 的数据库表中。 schema 默认值：JPA 持续性提供程序使用任何适用于数据库的默认模式。 如果默认模式不适合于应用程序，请将 schema 设置为要使用的 String 模式名。 uniqueConstraints 默认值：JPA 持续性提供程序假设实体的数据库表中的任何列均没有唯一约束。 如果唯一约束应用于该表中的一列或多列，请将 uniqueContraints 设置为一个或多个 UniqueConstraint 实例的数组。有关详细信息。  显示了如何使用此批注指定主表名。 @Entity @Table(name=EMP) public class Employee implements Serializable { ... } @GeneratedValue 默认情况下，JPA 持续性提供程序管理为实体主键提供的唯一标识符。 如果要微调此机制以实现以下目的，请使用 @GeneratedValue 批注： 如果您感觉另一个生成器类型更适合于数据库或应用，则覆盖持续性提供程序为数据库选择的身份值生成的类型 如果此名称难于处理、是一个保留字、与事先存在的数据模型不兼容或作为数据库中的主键生成器名称无效，则覆盖持续性提供程序选择的主键生成器名称 @GeneratedValue 属性 属性 必需 说明 generator 默认值：JPA 持续性提供程序为它选择的主键生成器分配一个名称。 如果该名称难于处理、是一个保留字、与事先存在的数据模型不兼容或作为数据库中的主键生成器名称无效，则将 generator 设置为要使用的 String 生成器名称。 strategy 默认值：GenerationType.AUTO。 默认情况下，JPA 持续性提供程序选择最适合于基础数据库的主键生成器类型。 如果您感觉另一个生成器类型更适合于数据库或应用程序，请将 strategy 设置为所需的 GeneratorType： IDENTITY — 指定持续性提供程序使用数据库身份列 AUTO — 指定持续性提供程序应选择一个最适合于基础数据库的主键生成器。 SEQUENCE — 指定持续性提供程序使用数据库序列TABLE — 指定持续性提供程序为使用基础数据库表的实体分配主键以确保唯一性  显示了如何使用此批注指示持续性提供程序使用名为 CUST_SEQ、类型为 G