Hibernate 基礎映射配置詳解：從實體類到數據庫表

Hibernate 映射核心三要素

1. 實體類：POJO，承載業務數據
2. 映射文件：.hbm.xml，定義對象-關係映射規則
3. 配置文件：hibernate.cfg.xml，數據源、方言、映射註冊

實體類規範

package com.example.model;

import java.util.Date;

public class User {
    private Long id;           // 主鍵，包裝類型支持 null
    private String name;
    private String password;
    private Date createTime;
    private Date expireTime;
    
    // 無參構造器（Hibernate 實例化必需）
    public User() {}
    
    // 全屬性構造器（可選，業務便利）
    public User(String name, String password) {
        this.name = name;
        this.password = password;
    }
    
    // Getter/Setter（屬性訪問策略默認）
    public Long getId() { return id; }
    public void setId(Long id) { this.id = id; }
    // ... 其他屬性同理
    
    // 建議覆寫 equals/hashCode（基於業務鍵或 ID）
    @Override
    public boolean equals(Object o) { ... }
    @Override
    public int hashCode() { ... }
}

關鍵約定：無參構造器、非 final 類、屬性私有+Getter/Setter、主鍵用包裝類型。

映射文件 User.hbm.xml 詳解

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE hibernate-mapping PUBLIC 
    "-//Hibernate/Hibernate Mapping DTD 3.0//EN"
    "https://hibernate.sourceforge.net/hibernate-mapping-3.0.dtd">

<hibernate-mapping package="com.example.model"> <!-- 包前綴，簡化類名 -->
    
    <class name="User" table="t_user"> <!-- 實體類映射表 -->
        
        <!-- 主鍵映射 -->
        <id name="id" column="user_id" type="java.lang.Long">
            <generator class="native"/> <!-- 主鍵生成策略 -->
        </id>
        
        <!-- 普通屬性映射 -->
        <property name="name" column="user_name" type="string" length="50" not-null="true"/>
        <property name="password" column="pwd" type="string" length="100" not-null="true"/>
        <property name="createTime" column="create_time" type="timestamp" not-null="true"/>
        <property name="expireTime" column="expire_time" type="timestamp"/>
        
    </class>
    
</hibernate-mapping>

主鍵生成策略選型指南

<!-- sequence 完整配置示例 -->
<id name="id" column="user_id">
    <generator class="sequence">
        <param name="sequence">seq_user_id</param>
    </generator>
</id>

屬性映射屬性詳解

Hibernate 核心配置 hibernate.cfg.xml

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE hibernate-configuration PUBLIC
    "-//Hibernate/Hibernate Configuration DTD 3.0//EN"
    "https://hibernate.sourceforge.net/hibernate-configuration-3.0.dtd">

<hibernate-configuration>
    <session-factory>
        <!-- 數據源配置 -->
        <property name="hibernate.connection.driver_class">com.mysql.cj.jdbc.Driver</property>
        <property name="hibernate.connection.url">jdbc:mysql://localhost:3306/mydb?useSSL=false&serverTimezone=Asia/Shanghai</property>
        <property name="hibernate.connection.username">root</property>
        <property name="hibernate.connection.password">123456</property>
        
        <!-- 方言：SQL 生成適配 -->
        <property name="hibernate.dialect">org.hibernate.dialect.MySQL8Dialect</property>
        
        <!-- 連接池 (內置簡易池，生產建議 HikariCP) -->
        <property name="hibernate.connection.pool_size">10</property>
        
        <!-- 顯示 SQL -->
        <property name="hibernate.show_sql">true</property>
        <property name="hibernate.format_sql">true</property>
        <property name="hibernate.use_sql_comments">true</property>
        
        <!-- 自動 DDL (開發環境) -->
        <property name="hibernate.hbm2ddl.auto">update</property> <!-- validate/update/create/create-drop -->
        
        <!-- 緩存 -->
        <property name="hibernate.cache.use_second_level_cache">true</property>
        <property name="hibernate.cache.region.factory_class">org.hibernate.cache.ehcache.EhCacheRegionFactory</property>
        
        <!-- 映射文件註冊 -->
        <mapping resource="com/example/model/User.hbm.xml"/>
        <mapping resource="com/example/model/Order.hbm.xml"/>
        
    </session-factory>
</hibernate-configuration>

SessionFactory 構建與 Session 使用

// 單例構建 SessionFactory (重量級，線程安全)
Configuration cfg = new Configuration().configure(); // 加載 hibernate.cfg.xml
SessionFactory sf = cfg.buildSessionFactory();

// 輕量級 Session (非線程安全，請求級/事務級)
Session session = sf.openSession();
Transaction tx = null;
try {
    tx = session.beginTransaction();
    
    // CRUD 操作
    User user = new User("張三", "123");
    session.save(user); // 持久化
    
    User loaded = session.get(User.class, user.getId()); // 查詢
    
    loaded.setName("李四"); // 髒檢查自動更新
    
    session.delete(loaded); // 刪除
    
    tx.commit();
} catch (Exception e) {
    if (tx != null) tx.rollback();
    throw e;
} finally {
    session.close(); // 歸還連接
}

常見映射類型對照表

自動 DDL 策略對比

最佳實踐總結

1. 顯式指定 column、type、length，避免默認推斷差異
2. 主鍵優先用 native/identity/sequence，分佈式用 uuid
3. 映射文件按模塊組織，hibernate-mapping package 簡化類名
4. 生產環境 hbm2ddl.auto=validate，DDL 由遷腳本管理
5. 連接池替換為 HikariCP，配置 hibernate.connection.provider_class
6. 開啟 SQL 格式化輸出，開發調試期 show_sql=true, format_sql=true
7. 二級緩存謹慎啟用，只讀/低寫入頻率實體優先

總結

Hibernate 基礎映射由實體類規範、.hbm.xml 映射定義、hibernate.cfg.xml 核心配置三部分構成。掌握主鍵生成策略選型、屬性映射屬性、類型對照、SessionFactory/Session 使用模式、DDL 自動策略，能快速構建穩健的 ORM 基礎設施。原則：顯式優於隱式、生產嚴格校驗、連接池專業化、緩存按需啟用。