相對於經典風格的實體配置xxx.hbm.xml,新版本hibernate使用JPA(Java Persistence API)註解配置能使我們的開發更加敏捷便利.在本系列前面部分的文章中,我們圍繞JPA註解風格配置來逐步深入學習。

配置例項

下面先看一個實體類的配置例項：

package com.zeng.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;

@Entity//聲明當前類為hibernate對映到資料庫中的實體類
 

@Table(name = "t_article2",catalog = "catolog",schema = "schema",uniqueConstraints = {@UniqueConstraint(columnNames = {"title","content"})})
//通過 @Table 為實體Bean指定對應資料庫表，目錄和schema的名字
//@UniqueConstraints 可以定義表的唯一約束。在title,和content加上唯一約束
public class User {
    @Id//宣告此列為主鍵,作為對映物件的識別符號
    /**
     *  @GeneratedValue
 
註解來定義生成策略
     *  GenerationType.TABLES 當前主鍵的值單獨儲存到一個數據庫的表中
     *  GenerationType.SEQUENCE  利用底層資料庫提供的序列生成識別符號
     *  GenerationType.IDENTITY 採取資料庫的自增策略
     *  GenerationType.AUTO 根據不同資料庫自動選擇合適的id生成方案，這裡使用mysql,為遞增型
     */
    @GeneratedValue(strategy = GenerationType.AUTO)
    private Integer id;
    @Column(insertable = true,length = 20,nullable = false,name = "user_name",unique = true,updatable = true)
    @Version //註解用於支援樂觀鎖版本控制。
    private String name;
    @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)
    private Integer age;
    @Transient//被標註此註解的屬性不會被持久化到資料庫
    private String temp;
    /**
     * @Lob 註解表示屬性將被持久化為Blob或者Clob型別, 
     * 具體取決於屬性的型別, java.sql.Clob, Character[], char[] 和 java.lang.String這些型別的屬性都被持久化為Clob型別, 
     * 而java.sql.Blob, Byte[], byte[] 和 serializable型別則被持久化為Blob型別.
     */
    @Lob
    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常用屬性解析

如果某屬性沒有註解,該屬性將遵守下面的規則:
1. 如果屬性為單一型別,則對映為@Basic
2. 如果屬性對應的型別實現了Serializable, 則屬性被對映為@Basic並在一個列中儲存該物件的serialized版本
3. 如果該屬性的型別為java.sql.Clob 或 java.sql.Blob,則作為@Lob並對映到適當的LobType。

2. @Lob註解屬性

對於一些容量大的屬性如文章、圖片的資料，如果我們要儲存到資料庫，可以使用@Lob註解，先在User類中新增下面一個屬性例項：

@Lob
private String text;
@Lob
private Byte[] image;

這時候，我們執行測試方法，hibernate會自動幫我們在資料庫中生成相應的”大容量型別“屬性：

如果我們想自定製資料庫中生成的屬性型別，可以使用下面示例配置：

@Lob
@Basic(fetch = FetchType.LAZY)
@Column(columnDefinition = "BLOB", nullable = true)
private String pro1;

@Lob
@Basic(fetch = FetchType.LAZY)
@Column(columnDefinition = "tinytext", nullable = true)
private String pro2;

@Lob
@Basic(fetch = FetchType.LAZY)
@Column(columnDefinition = "mediumtext", nullable = true)
private String pro3;

@Lob
@Basic(fetch = FetchType.LAZY)
@Column(columnDefinition = "text", nullable = true)
private String pro4;

此時對應資料庫中生成資料型別：

資料型別對應關係

java、mysql、hibernate資料型別對應關係如下表所示：

原始碼下載