JPA注解参考手册

JPA注解参考手册

@EnableJpaAuditing

在Spring JPA中，支持在字段或方法上进行注解 @CreateDate、@CreatedBy、@LastModifiedDate、@LastModifiedBy。具体含义：
@CreateDate：表示该字段是创建时间字段，在这个实体被insert的时候，会自动填充创建的时间，不用手动填充该字段。
@CreatedBy：表示该字段是创建人字段，在这个实体被insert的时候，会自动填充创建人字段，不用手动填充。
@LastModifiedDate、@LastModifiedBy同理。

@Entity

说明这个class是实体类，并且使用默认的orm规则，即class名对应数据库表中表名，class字段名即表中的字段名。 

@Table

Table用来定义entity主表的name，catalog，schema等属性。
元数据属性说明： 
• name: 表名 
• catalog: 对应关系数据库中的catalog 
• schema：对应关系数据库中的schema 
• UniqueConstraints:定义一个UniqueConstraint数组，指定需要建唯一约束的列

@DynamicInsert

设置为true,设置为true,表示insert对象的时候,生成动态的insert语句,如果这个字段的值是null就不会加入到insert语句当中.默认false。

@DynamicUpdate

设置为true,设置为true,表示update对象的时候,生成动态的update语句,如果这个字段的值是null就不会被加入到update语句中,默认false。

@Column

Column元数据定义了映射到数据库的列的所有属性：列名，是否唯一，是否允许为空，是否允许更新等。	元数据属性说明： 
• name:列名。 
• unique: 是否唯一 
• nullable: 是否允许为空 
• insertable: 是否允许插入 
• updatable: 是否允许更新 
• columnDefinition: 定义建表时创建此列的DDL 
• secondaryTable: 从表名。如果此列不建在主表上（默认建在主表），该属性定义该列所在从表的名字。

@OneToOne

@OneToOne描述一个 一对一的关联
元数据属性说明： 
• fetch：表示抓取策略，默认为FetchType.LAZY 
• cascade：表示级联操作策略

@JoinColumn

如果在entity class的field上定义了关系（one2one或one2many等），我们通过JoinColumn来定义关系的属性。JoinColumn的大部分属性和Column类似。
元数据属性说明： 
• name:列名。 
• referencedColumnName:该列指向列的列名（建表时该列作为外键列指向关系另一端的指定列） 
• unique: 是否唯一 
• nullable: 是否允许为空 
• insertable: 是否允许插入 
• updatable: 是否允许更新 
• columnDefinition: 定义建表时创建此列的DDL 
• secondaryTable: 从表名。如果此列不建在主表上（默认建在主表），该属性定义该列所在从表的名字。
下面的代码说明Custom和Order是一对一关系。在Order对应的映射表建一个名为CUST_ID的列，该列作为外键指向Custom对应表中名为ID的列。
public class Custom {
    @OneToOne
    @JoinColumn(
    name="CUST_ID",
    referencedColumnName="ID", 
    unique=true, nullable=true, 
    updatable=true)
    public order getOrder() {
        return order;
}

@Transient

	@Transient表示该属性并不是一个到数据库表的字段的映射，指定的这些属性不会
被持久化，ORM框架将忽略该属性。 
	如果一个属性并非数据库表的字段映射。就务必将其标示为@Transient。