本文代码中使用的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接口
创建自动增长的列
@GeneratedValue
Strategy
指定主键生成策略,从GenerationType
枚举类中获取,可取值为AUTO
、IDENTITY
、SEQUENCE
、TABLE
Generator
指定对应策略的生成器,值为字符串类型,它是@SequenceGenerator
、@TableGenerator
中name
属性的值
AUTO
@Id
@GeneratedValue
private long id;
@GeneratedValue 等效于 @GeneratedValue(strategy=GenerationType.AUTO)
AUTO: 主键由程序控制,不是自增。
把主键生成策略交给持久化引擎(persistence engine),持久化引擎会根据数据库在以上三种主键生成策略中选择其中一种。常用,JPA默认的生成策略就是GenerationType.AUTO,可显示指定为
@GeneratedValue(strategy = GenerationType.AUTO),或直接省略不写@GeneratedValue
IDENTITY
主键由数据库自动生成(主要是自动增长型,常用于Mysql数据库),auto应该优先采用这个Sequence
@Id
@SequenceGenerator(name="seq", sequenceName="DB_SEQ")
@GeneratedValue(strategy=GenerationType.SEQUENCE, generator="seq")
private long id;
需要在支持sequence的数据库中创建一个名为DB_SEQ
的sequence。
属性:
//name:name属性: 表示该表主键生成策略的名称,它被引用在@GeneratedValue中设置的“generator”值中。
//sequenceName:标识生成策略用到的数据库序列名称。
//initialValue:主键初始值。(默认0)
//allocationSize:主键每次累加值。(默认50)
Table
@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利用这个表从一个特定的类中获取主键列的下一个值。
使用一个特定的数据库表格来保存主键,持久化引擎通过关系数据库的一张特定的表格来生成主键,这种策略的好处就是不依赖于外部环境和数据库的具体实现,在不同数据库间可以很容易的进行移植,但由于其不能充分利用数据库的特性,所以不会优先使用。
该策略一般与另外一个注解@TableGenerator一起使用【指定了生成主键的表(可以在class类上指定也可以在 Id 上指定)】,然后JPA将会根据注解内容自动生成一张表作为序列表(或使用现有的序列表)。如果不指定序列表,则会生成一张默认的序列表,表中的列名也是自动生成,数据库上会生成一张名为sequence的表。
序列表一般只包含两个字段:第一个字段是该生成策略的名称,第二个字段是该关系表的最大序号,它会随着数据的插入逐渐累加。
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;