Hibernate 入門學習筆記整理：從配置到映射的完整起步指南

Hibernate 入門學習筆記整理：從配置到映射的完整起步指南

Hibernate 作為 Java 持久層領域的經典 ORM 框架，雖然近年 MyBatis 更受青睞，但 Hibernate 的全自動映射、HQL 查詢語言、二級緩存、延遲加載等特性在特定場景（中小型專案、快速原型、領域模型驅動開發）仍具不可替代優勢。本文整理 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.jdbc.Driver</property>
        <property name="hibernate.connection.url">jdbc:mysql://localhost:3306/hibernate_db</property>
        <property name="hibernate.connection.username">root</property>
        <property name="hibernate.connection.password">root</property>
        
        <!-- 方言：生成針對特定數據庫的 SQL -->
        <property name="hibernate.dialect">org.hibernate.dialect.MySQLDialect</property>
        
        <!-- 顯示/格式化 SQL -->
        <property name="hibernate.show_sql">true</property>
        <property name="hibernate.format_sql">true</property>
        
        <!-- 自動建表：create/create-drop/update/validate -->
        <property name="hibernate.hbm2ddl.auto">update</property>
        
        <!-- 映射文件註冊 -->
        <mapping resource="com/example/domain/User.hbm.xml"/>
    </session-factory>
</hibernate-configuration>

實體類與映射文件（.hbm.xml）

User.java - POJO 實體類：

public class User {
    private Integer id;
    private String username;
    private String password;
    private String email;
    // Getter/Setter、toString 省略
}

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.domain">
    <class name="User" table="t_user">
        <id name="id" column="id">
            <generator class="native"/> <!-- 自增/序列自適應 -->
        </id>
        <property name="username" column="username" length="50"/>
        <property name="password" column="password" length="100"/>
        <property name="email" column="email" length="100"/>
    </class>
</hibernate-mapping>

註解映射：零 XML 配置

@Entity
@Table(name = "t_user")
public class User {
    @Id
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    @Column(name = "id")
    private Integer id;
    
    @Column(name = "username", length = 50, nullable = false, unique = true)
    private String username;
    
    @Column(name = "password", length = 100)
    private String password;
    
    @Column(name = "email", length = 100)
    private String email;
    // Getter/Setter
}

核心 API 與 Session 生命周期

對象三大狀態與轉換

瞬時態  --save()/persist()-->  持久態  --session.close()/evict()-->  游離態
   ^                                                         |
   |---------------------- update()/merge() ------------------|
   |                                                         |
   |---------------------- delete() -------------------------|
   |                                                         |
   +---------------------- load()/get() ---------------------+

• 瞬時態：new 出來、無 ID、未關聯 Session
• 持久態：有 ID、關聯 Session、納入一級緩存、脏檢查自動同步 DB
• 游離態：有 ID、Session 關閉/清除、可重新關聯

HQL 查詢語言精華

• 面向對象查詢：from User u where u.username = :name
• 投影查詢：select u.username, u.email from User u 返回 Object[]
• 分頁：query.setFirstResult(0).setMaxResults(10)
• 命名參數：query.setParameter("name", "admin") 防注入
• 左外連接抓取：from User u left join fetch u.orders 解決 N+1 問題

關聯映射速查

性能優化三板斧

1. 二級緩存：啟用 hibernate.cache.use_second_level_cache=true，配置 Ehcache/Redis，標註 @Cache(usage = CacheConcurrencyStrategy.READ_WRITE)
2. 延遲加載：默認開啟，@OneToMany(fetch = FetchType.LAZY)，注意 Session 關閉後訪問導致 LazyInitializationException
3. 批量操作：hibernate.jdbc.batch_size=20，session.flush()/clear() 定期清理一級緩存

Spring 整合要點

• 交由 Spring 管理 SessionFactory：LocalSessionFactoryBean
• 聲明式事務：@Transactional + HibernateTransactionManager
• 獲取 Session：sessionFactory.getCurrentSession() 綁定當前線程事務
• DAO 支持類：繼承 HibernateDaoSupport 或注入 SessionFactory

Hibernate 學習曲線雖陡峭，但其「領域模型驅動」的設計哲學、豐富的映射策略、強大的查詢語言，構建了 Java 持久層技術的高地。建議初學者從 XML 映射入手理解本質，再過渡到註解與 Spring 整合，最後深入緩存、鎖、攔截器等進階特性。

系列完整學習鏈接：
web進修之—Hibernate起步（1）
web進修之—Hibernate起步（2）

1. 上一篇文章： 基礎練習：數列排序演算法實作與解析
2. 下一篇文章： 基礎算法練習：十六進制轉十進制的 Java 實現與 BigInteger 擴展應用

Java 綜合教學

企業級操作日誌設計：從硬編碼到 AOP 解耦的演進之路

業務背景與痛點 在某企業級專案中，需記錄操作人員、時間、模組

設計模式深度解析：簡單工廠 vs 工廠方法 vs 抽象工廠 進化史與實戰選型

設計模式深度解析：簡單工廠 vs 工廠方法 vs 抽象工廠

Eclipse 插件開發實戰（四）：代碼生成器核心邏輯與插件集成全流程

前言：從 UI 交互到業務代碼生成 前三篇確立了插件項目創建

基於 REST 服務實現輕量級 RPC 框架：架構設計與完整實戰代碼

基於 REST 服務實現輕量級 RPC 框架：架構設計與完整