Hibernate 实体类注解

最新推荐文章于 2023-11-03 15:56:12 发布

dou1246

最新推荐文章于 2023-11-03 15:56:12 发布

阅读量431

点赞数

原文链接：https://blog.csdn.net/quan20111992/article/details/78377407

版权

原文链接： https://blog.csdn.net/quan20111992/article/details/78377407 https://blog.csdn.net/weixin_41884446/article/details/100081147

本文代码中使用的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。

根据底层数据库的序列来生成主键，条件是数据库支持序列（Mysql不支持序列，所以不能使用）。

属性：
//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;