Hibernate SchemaExport：從映射檔自動建立資料庫結構

Hibernate 自動生成 DDL (SchemaExport)

利用 hibernate.cfg.xml 與 *.hbm.xml 映射檔，程式化建立資料庫表結構，免寫 SQL DDL。

1. 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/hibtest?useSSL=false</property>
    <property name="hibernate.connection.username">root</property>
    <property name="hibernate.connection.password">123456</property>
    <property name="hibernate.dialect">org.hibernate.dialect.MySQL8Dialect</property>
    <property name="hibernate.show_sql">true</property>
    <property name="hibernate.hbm2ddl.auto">create</property> <!-- 自動建表 --> 
    <mapping resource="com/hibtest/User.hbm.xml"/>
  </session-factory>
</hibernate-configuration>

注意：驅動類、方言、連線字串需依資料庫版本調整 (MySQL 8 用 com.mysql.cj.jdbc.Driver、MySQL8Dialect、useSSL=false、serverTimezone=UTC)。

2. 映射檔 User.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>
  <class name="com.hibtest.User" table="user">
    <id name="id" column="id">
      <generator class="identity"/>
    </id>
    <property name="username" column="username" length="32" not-null="true"/>
    <property name="password" column="password" length="64"/>
    <property name="email" column="email" length="100"/>
    <property name="createdAt" column="created_at" type="timestamp"/>
  </class>
</hibernate-mapping>

3. 程式化執行 SchemaExport

import org.hibernate.cfg.Configuration;
import org.hibernate.tool.hbm2ddl.SchemaExport;
import java.io.File;

public class InitDatabase {
    public static void main(String[] args) {
        Configuration cfg = new Configuration().configure(new File("hibernate.cfg.xml"));
        System.out.println("建立資料表中...");
        SchemaExport export = new SchemaExport(cfg);
        export.create(true, true); // 輸出 SQL 到標準輸出、執行建表
        System.out.println("資料表建立完成。");
    }
}

進階：hbm2ddl.auto 選項

最佳實務

• 開發環境用 create 或 update；生產環境禁用自動 DDL，改用 Flyway/Liquibase 管理遷移腳本。
• 映射檔建議改用 JPA 註解 (@Entity, @Table, @Column) 簡化維護。
• 命名策略：PhysicalNamingStrategyStandardImpl 控制表/欄位命名規則 (駝峰轉底線等)。

1. 上一篇文章： Java Calendar 日期運算：計算上完 N 堂課的結束日期
2. 下一篇文章： Hibernate 註解整合 Ehcache 實現二級緩存完整指南

J2EE

深度解析 JPA 2.0 Criteria API (三)：動態弱類型、資料庫函數擴展、可編輯查詢與 QBE

本系列最終篇聚焦 Criteria API 的動態可編程特性

JSF 2 實作可重用 Ajax 自動完成組件 (二)：Facelet 整合與測試

組件展示 圖 3 輸入 Al 後自動完成建議：Albani

表現層框架三雄對決：Struts vs Tapestry vs JSF 深度比較

表現層框架核心功能抽象 所有框架必須實現三大功能： 視

Java EE 5 重塑企業開發：從 J2EE 更名看規格簡化與持久化統一的戰略轉向

前言：名稱變更背後的產業心聲 2006 年，Sun 將 J2