Hibernate 入門實戰：從實體映射到 CRUD 完整流程演示

Hibernate 入門實戰：從實體映射到 CRUD 完整流程演示

本文通過一個最精簡的「教師信息管理」案例，手把手演示 Hibernate 核心配置、映射文件編寫、SessionFactory 構建、事務管理與基本增刪改查操作，適合初學者快速跑通第一個 Hibernate 程序。

一、項目準備與依賴

• 創建 Java/JavaWeb 項目
• 導入 Hibernate 核心 JAR 包（hibernate-core、連接池 c3p0/dbcp、MySQL 驅動、slf4j 等）
• 準備 MySQL 數據庫及 test schema

二、實體類與映射文件

1. Teacher.java

public class Teacher {
    private String username; // 主鍵
    private String password;
    private int age;
    // getter/setter 省略
}

2. Teacher.hbm.xml（核心映射）

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

<hibernate-mapping package="com.hibernate.domain">
    <class name="Teacher" table="Teacher">
        <id name="username" type="java.lang.String" column="username">
            <generator class="assigned"/> <!-- 主鍵手動分配 -->
        </id>
        <property name="password" column="password" length="50"/>
        <property name="age" column="age" length="10"/>
    </class>
</hibernate-mapping>

關鍵點：generator class="assigned" 表示主鍵非自增，由應用層賦值；name 對應實體屬性，column 對應表欄位。

三、核心配置文件 hibernate.cfg.xml

<!DOCTYPE hibernate-configuration PUBLIC
    "-//Hibernate/Hibernate Configuration DTD 3.0//EN"
    "https://www.hibernate.org/dtd/hibernate-configuration-3.0.dtd">

<hibernate-configuration>
    <session-factory>
        <!-- 數據庫連接 -->
        <property name="hibernate.dialect">org.hibernate.dialect.MySQLDialect</property>
        <property name="connection.url">jdbc:mysql://localhost:3306/test</property>
        <property name="connection.driver_class">com.mysql.jdbc.Driver</property>
        <property name="connection.username">root</property>
        <property name="hibernate.connection.password">your_password</property>

        <!-- 映射文件註冊 -->
        <mapping resource="com/hibernate/domain/Teacher.hbm.xml"/>
    </session-factory>
</hibernate-configuration>

四、DAO 封裝：Template 模式管理 Session 與事務

public class TeacherDao {
    private static final SessionFactory sf = new Configuration().configure().buildSessionFactory();

    // 通用事務模板
    private void execute(HibernateCallback callback) {
        Session session = null;
        Transaction tx = null;
        try {
            session = sf.openSession();
            tx = session.beginTransaction();
            callback.doInSession(session);
            tx.commit();
        } catch (Exception e) {
            if (tx != null) tx.rollback();
            throw new RuntimeException(e);
        } finally {
            if (session != null) session.close();
        }
    }

    // 插入
    public void insert(Teacher teacher) {
        execute(session -> session.save(teacher));
    }

    // HQL 查詢
    public List<Teacher> find(String hql) {
        List<Teacher> result = new ArrayList<>();
        execute(session -> {
            Query query = session.createQuery(hql);
            result.addAll(query.list());
        });
        return result;
    }

    @FunctionalInterface
    interface HibernateCallback {
        void doInSession(Session session);
    }
}

設計亮點：使用函數式接口 + Lambda（JDK 8+）消除樣板代碼，統一事務邊界與資源釋放。

五、測試驗證

public class Test {
    public static void main(String[] args) {
        TeacherDao dao = new TeacherDao();

        // 1. 插入
        Teacher t = new Teacher();
        t.setUsername("username4");
        t.setPassword("root4");
        t.setAge(20);
        dao.insert(t);

        // 2. 查詢
        List<Teacher> list = dao.find("from Teacher");
        list.forEach(teacher -> System.out.println(teacher.getUsername()));
    }
}

六、常見坑與注意事項

七、總結與下一步

跑通此流程，你已掌握 Hibernate **配置 → 映射 → SessionFactory → Session → 事務 → CRUD** 核心鏈路。下一步建議學習：

1. 關聯映射（一對多、多對一、多對多）與級聯操作
2. HQL/JPQL 進階查詢、Criteria API、原生 SQL
3. 延遲加載、N+1 問題、抓取策略優化
4. 二級快取（Ehcache/Redis）整合
5. 遷移至 Spring Data JPA / Spring Boot Data JPA 簡化開發

Hibernate 雖屬「老牌」框架，但其 ORM 思想、Session 管理、快取機制、併發控制仍是現代持久層技術的基石，深入理解極具價值。