本文代码中使用的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
private long id;
当这段代码被执行时,hibernate将在数据表中创建一个名为id
的字段,并为这个字段添加一个主键索引。所以在使用了@Id
注解的变量上不需要添加@Column
注解,除非你需要自定义这个字段名。
作用在类上,定义复合主键
@Entity
@IdClass(Employee.class)
public class Employee implements serializable {
@Id
private String firstName;
@Id
private String phone;
}
实体类必须实现serializable接口
@Id
@GeneratedValue
private long id;
@GeneratedValue 等效于 @GeneratedValue(strategy=GenerationType.AUTO)
@Id
@SequenceGenerator(name="seq", sequenceName="DB_SEQ")
@GeneratedValue(strategy=GenerationType.SEQUENCE, generator="seq")
private long id;
需要在支持sequence的数据库中创建一个名为DB_SEQ
的sequence
@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利用这个表从一个特定的类中获取主键列的下一个值。
Strategy
指定主键生成策略,从GenerationType
枚举类中获取,可取值为AUTO
、IDENTITY
、SEQUENCE
、TABLE
Generator
指定对应策略的生成器,值为字符串类型,它是@SequenceGenerator
、@TableGenerator
中name
属性的值
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;