jpa注解参考.docVIP

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 持续性提供程序假设 Java 类是非持续类，并且仅当使用此批注对其进行修饰的情况下才可用于 JPA 服务。 使用此批注将普通的旧式 Java 对象 POJO 类指定为实体，以便可以将它用于 JPA 服务。 要将类用于 JPA 服务，必须将该类指定为 JPA 实体（使用此批注或 orm.xml 文件）。 @Entity 数据库模式属性 默认情况下，JPA 持续性提供程序假设实体名称对应于同名的数据库表，且实体的数据成员名称对应于同名的数据库列。 使用这些批注覆盖此默认行为，并微调对象模型与数据模型之间的关系。 @Table @SecondaryTable @SecondaryTables @Column @JoinColumn @JoinColumns @PrimaryKeyJoinColumn @PrimaryKeyJoinColumns @JoinTable @UniqueConstraint 身份 默认情况下，JPA 持续性提供程序假设每个实体必须至少有一个用作主键的字段或属性。 使用这些批注指定以下项之一： 一个 @Id 多个 @Id 和一个 @IdClass 一个 @EmbeddedId 还可以使用这些批注微调数据库维护实体身份的方式。 @Id @IdClass @EmbeddedId @GeneratedValue @SequenceGenerator @TableGenerator 直接映射 默认情况下，JPA 持续性提供程序为大多数 Java 基元类型、基元类型的包装程序以及 enums 自动配置一个 Basic 映射。 使用这些批注微调数据库实现这些映射的方式。 @Basic @Enumerated @Temporal @Lob @Transient 关系映射 JPA 持续性提供程序要求您显式映射关系。 使用这些批注指定实体关系的类型和特征，以微调数据库实现这些关系的方式。 @OneToOne @ManyToOne @OneToMany @ManyToMany @MapKey @OrderBy 组合 默认情况下，JPA 持续性提供程序假设每个实体均映射到它自己的表。 使用这些批注覆盖其他实体拥有的此种实体行为。 @Embeddable @Embedded @AttributeOverride @AttributeOverrides @AssociationOverride @AssociationOverrides 继承 默认情况下，JPA 持续性提供程序假设所有持久字段均由一个实体类定义