Hibernate 实体类注解

本文代码中使用的hibernate版本为4.3.11.Final，spring版本为4.3.9.RELEASE

在hibernate4以后，@Entity为jpa中提供的javax.persistence.Entity

@Entity

作用在类上，表示该类是Hibernate 实体类，在创建数据表时会默认使用类名作为新建表的表名。

@Entity
public class Employee{}

@Table

作用在类上，定义表的信息。
name属性被用来设置当前表的表名，当我们不想使用类名作为表名而是希望自定义时，我们可以使用这个name属性。
uniqueConstraints属性被用来为当前表提供唯一性约束，可以定义单个列也可以定义多个列，当定义多个列时表示这些列共同组成的值在表中不可重复。

@Entity
@Table(name="tbl_employee",uniqueConstraints=@UniqueConstraint(columnName={"id", "empName"}))
public class Employee {}

上面的代码表示该实体类在数据库中对应的表名为tbl_employee，该表中id、empName这两个字端组合具有唯一性约束。

当SessionFactory第一次被创建且hibernate.hbm2ddl.auto属性的值被设置为create时，hibernate将执行下面的代码去创建数据表和唯一性约束

Hibernate: drop table if exists tbl_employee
Hibernate: create table tbl_employee (id bigint not null, empCode varchar(255), primary key (id))
Hibernate: alter table tbl_employee add constraint UK_3r763mmnyundobvaiqjv6lnj1  unique (id, empCode)

@Table是一个可选的注解，它被使用在当需要自定义表名时。

@Column

作用在变量上，定义表中的字段信息。
name属性被用来设置变量在表中对应的字段名，若该属性省略，则默认将变量名作为表中对应字段的字段名。
length定义该字段的长度。
nullable定义该字段是否可以为空，值为布尔类型(true/false)，默认为true，当值为false时，该字段的值不能为NULL。
unique定义该字段是否有唯一索引，值为布尔类型(true/false)，默认为false，当值为true时，hibernate为该字段创建唯一索引。
columnDefinition值为字符串类型，它接收一个SQL片段，该片段在数据表被创建时使用
scale and precision指定数字的位数和小数位数
insertable表示该列是否参与insert操作，值为布尔类型
updateable表示该列是否参与update操作，值为布尔类型

@Entity
@Table(name="tbl_employee",uniqueConstraints=@UniqueConstraint(columnName={"id", "empName"}))
public class Employee {

    @Column(name="empName",length=20,nullable=false)
    private String empName;

    @Column(columnDefinition = "timestamp NOT NULL DEFAULT CURRENT_TIMESTAMP")
    private Date startDate;

    //fields and getter/setter
}

@Id

作用在变量上，定义表中的主键。

@Id
private long id;

当这段代码被执行时，hibernate将在数据表中创建一个名为id的字段，并为这个字段添加一个主键索引。所以在使用了@Id注解的变量上不需要添加@Column注解，除非你需要自定义这个字段名。

@IdClass

作用在类上，定义复合主键

@Entity
@IdClass(Employee.class)
public class Employee implements serializable {
    @Id
    private String firstName;
    @Id
    private String phone;
}

实体类必须实现serializable接口

Creating an autogenerator column(创建自动增长的列)

Default generation strategy

@Id
@GeneratedValue
private long id;

@GeneratedValue 等效于 @GeneratedValue(strategy=GenerationType.AUTO)

Sequence generation

@Id
@SequenceGenerator(name="seq", sequenceName="DB_SEQ")
@GeneratedValue(strategy=GenerationType.SEQUENCE, generator="seq")
private long id;

需要在支持sequence的数据库中创建一个名为DB_SEQ的sequence

Table generation

@Id
@Column(name = "id")
@GeneratedValue(strategy = GenerationType.TABLE, generator = "gen_tbl")
@TableGenerator(name = "gen_tbl", table = "gen_table", pkColumnName = "pk", valueColumnName = "id", pkColumnValue = "employee0",
initialValue = 0, allocationSize = 1)
private long id;

主键列的值存储在另一个表(gen_table)中，hibernate利用这个表从一个特定的类中获取主键列的下一个值。

@GeneratedValue

Strategy指定主键生成策略，从GenerationType枚举类中获取，可取值为AUTO、IDENTITY、SEQUENCE、TABLE
Generator指定对应策略的生成器，值为字符串类型，它是@SequenceGenerator、@TableGenerator中name属性的值

@TableGenerator

name属性接收字符串类型的值，为一个类中的table generator定义唯一的名称，它被用于在@GeneratedValue注解中为generator属性提供值
table属性接收字符串类型的值，它是由hibernate创建的包含主键列下一个值的新表名称
pkColumnName属性指定新表中保存主键列名称的字段
valueColumnName属性指定新表中保存主键值的字段
pkColumnValue属性主键列对应的名称，其值保存在pkColumnName字段中
initialValue设置主键值的初始值
allocationSize设置主键值每次的增量

@Id
@Column(name="id")
@GeneratedValue(strategy= GenerationType.TABLE,generator="gen_tbl")
@TableGenerator(name="gen_tbl",table="gen_table",pkColumnName= "key_name", pkColumnValue = "identity", valueColumnName="key_value")
private int id;