JPA_批注参考.pdf

TopLink JPA - 资源- 教程- 方法文档- 示例- 下载 本页面上的脚本内容仅供浏览使用，而不会以任何方式更改内容。 1 JPA 批注参考 版本 5/ 12/06 作为Java 企业版5 (Java EE 5) Enterprise Java Bean (EJB) 3.0 规范的组成部 分，Java 持续性API (JPA) 显著简化了 EJB 持续性并提供了一个对象关系映射 方法，该方法使您可以采用声明方式定义如何通过一种标准的可移植方式（在 Java EE 5 应用服务器内部以及Java 标准版(Java SE) 5 应用程序中的 EJB 容 器外部均可使用）将Java 对象映射 关系数据库表。 在JPA 之前，Java EE 应用程序将持续类表示为容器管理的实体 bean 。使用 JPA，您可以将任何普通的旧式Java 对象(POJO) 类指定为JPA 实体：一个应 使用JPA 持续性提供程序的服务将其非临时字段持久保存 关系数据库 （在 Java EE EJB 容器的内部或在简单Java SE 应用程序中的 EJB 容器的外部）的 Java 对象。 使用JPA 时，可以使用批注配置实体的JPA 行为。批注是一种使用元数据修饰 Java 源代码的简单表达方法，它编译为相应的Java 类文件，以便在运行时由 JPA 持续性提供程序解释以管理JPA 行为。 例如，要将Java 类指定为JPA 实体，请使用@Entity 批注，如下所示 @Entity public class Employee implements Serializable { ... } 您可以有选择地使用批注来修饰实体类以覆盖默认值。这称作按异常进行配置 (configuration by exception)。 本参考广泛引用了JSR-220 Enterprise JavaBean 版本3.0 Java 持续性API 规 范，以按类别汇总批注信息 （请参阅表 1-1），并解释了何时以及如何使用这 些批注来自定义JPA 行为，以满足应用程序的需要。 有关详细信息，请参阅 批注索引 完整的JPA 批注Javadoc 1-1 按类别划分的JPA 批注 类别 说明 批注 实体 默认情况下，JPA 持续性提供程序假设 @Entity Java 类是非持续类，并且仅当使用此批注 对其进行修饰的情况下才可用于JPA 服 务。 使用此批注将普通的旧式Java 对象 (POJO) 类指定为实体，以便可以将它用于 JPA 服务。 要将类用于JPA 服务，必 将该类指定为 JPA 实体 （使用此批注或 orm.xml 文 件）。 数据 默认情况下，JPA 持续性提供程序假设实 @Table 库模 体名称对应于同名的数据库表，且实体的 式属 数据成员名称对应于同名的数据库列。 @SecondaryTable 性 使用这些批注覆盖此默认行为，并微调对 @SecondaryTables 象模型与数据模型之间的关系。 @Column @JoinColumn @JoinColumns @PrimaryKeyJoinColumn @PrimaryKeyJoinColumns @JoinTable @UniqueConstraint 身份 默认情况下，JPA 持续性提供程序假设每 @Id 个实体必须至少有一个用作主键的字段或