相对于经典风格的实体配置xxx.hbm.xml,新版本hibernate使用JPA(Java Persistence API)注解配置能使我们的开发更加敏捷便利.在本系列前面部分的文章中,我们围绕JPA注解风格配置来逐步深入学习。
配置实例
下面先看一个实体类的配置实例:
package com.chenhao.hibernate.model;
import java.util.Date;
import javax.persistence.Basic;
import javax.persistence.Column;
import javax.persistence.Entity;
import javax.persistence.FetchType;
import javax.persistence.GeneratedValue;
import javax.persistence.GenerationType;
import javax.persistence.Id;
import javax.persistence.Lob;
import javax.persistence.Table;
import javax.persistence.Temporal;
import javax.persistence.TemporalType;
import javax.persistence.Transient;
/**
*
* @author chen_hao
*
*/
@Entity//声明当前类为hibernate映射到数据库中的实体类
@Table(name = "t_user")//声明在数据库中自动生成的表名为t_user
public class User {
@Id//声明此列为主键
/**
* @GeneratedValue注解来定义生成策略
* GenerationType.TABLES 当前主键的值单独保存到一个数据库的表中
* GenerationType.SEQUENCE 利用底层数据库提供的序列生成标识符
* GenerationType.IDENTITY 采取数据库的自增策略
* GenerationType.AUTO 根据不同数据库自动选择合适的id生成方案,这里使用mysql,为递增型
*/
@GeneratedValue(strategy = GenerationType.AUTO)//根据不同数据库自动选择合适的id生成方案,这里使用mysql,为递增型
private Integer id;
@Column(insertable = true,length = 20,nullable = false,name = "name",unique = true,updatable = true)
private String name;
@Basic(fetch = FetchType.EAGER,optional = true)
private Integer age;
@Column(scale = 1,precision = 1)
private Double salary;
/**
* @Basic 基本属性类型映射,注解于非Static 非transient的属性,
* 这时候我们可以为其声明抓取策略等属性
* fetch: 获取策略,当以session.get()方法获取数据库对象时:
* fetchType.LAZY为懒加载,会在第一次使用该属性(如调用getAge()方法)时才获取。
* FetchType.EAGER为即时加载。
* optional:表示当前属性是否可选,默认为true,如果为false,则在持久化到数据库时,如果此属性为null,则会失败
*/
@Basic(fetch = FetchType.EAGER,optional = true)
@Transient//被标注此注解的属性不会被持久化到数据库
private String temp;
/**
* @Lob 注解表示属性将被持久化为Blob或者Clob类型,
* 具体取决于属性的类型, java.sql.Clob, Character[], char[] 和 java.lang.String这些类型的属性都被持久化为Clob类型,
* 而java.sql.Blob, Byte[], byte[] 和 serializable类型则被持久化为Blob类型.
*/
@Lob
@Basic(fetch = FetchType.LAZY)
@Column(columnDefinition = "BLOB", nullable = true)
private String desc;
/**
* @Temporal 标注在日期等属性上,声明映射为数据库的特定诶其属性类型,默认为java.sql.Timestamp(TemporalType.TIMESTAMP)
* 此外还有java.sql.date(TemporalType.DATE)、java.sql.Time(TemporalType.TIME)
*/
@Temporal(TemporalType.TIME)
private Date birthDate;
public Integer getId() {
return id;
}
public void setId(Integer id) {
this.id = id;
}
public String getName() {
return name;
}
public void setName(String name) {
this.name = name;
}
}
在实例中,我们使用了一些常用的注解属性,并配上注释进行了细致说明
拓展分析
除了上面注释的说明,我们还需要补充的说明是
1. @Column常用属性解析
属性名 | 说明 | 默认值 |
---|---|---|
unique | 可选,是否在该列上设置唯一约束 | false |
nullable | 可选,是否设置该列的值可以为空 | false |
insertable | 可选,该列是否作为生成的insert语句中的一个列 | true |
updatable | 可选,该列是否作为生成的update语句中的一个列 | true |
columnDefinition | 可选: 为这个特定列覆盖SQL DDL片段 (这可能导致无法在不同数据库间移植)比如我们想把Integer readNum 设为默认0,可使用此属性: INT DEFAULT 0 | 无 |
table | 可选,定义对应的表 | 默认为当前类对应表 |
length | 可选,列长度 | 255 |
precision | 可选,列十进制精度(decimal precision) | 0 |
scale | 可选,如果列十进制数值范围(decimal scale)可用,在此设置 | 0 |
如果某属性没有注解,该属性将遵守下面的规则:
- 如果属性为单一类型,则映射为@Basic
- 如果属性对应的类型实现了Serializable, 则属性被映射为@Basic并在一个列中保存该对象的serialized版本
- 如果该属性的类型为Java.sql.Clob 或 java.sql.Blob,则作为@Lob并映射到适当的LobType。
2. @Lob注解属性
对于一些容量大的属性如文章、图片的数据,如果我们要保存到数据库,可以使用@Lob注解,先在User类中添加下面一个属性实例:
@Lob
private String text;
@Lob
private Byte[] image;
这时候,我们运行测试方法,hibernate会自动帮我们在数据库中生成相应的”大容量类型“属性:
Field | Type | Null | Defaul |
---|---|---|---|
pro1 | blob | YES | NULL |
pro2 | tinytext | YES | NULL |
pro3 | mediumtext | YES | NULL |
pro4 | text | YES | NULL |
数据类型对应关系
java、MySQL、hibernate数据类型对应关系如下表所示: