正確理解 Hibernate 的設定與映射,是熟練使用這套 ORM 框架的關鍵。物件與關聯資料庫之間的對應關係,是透過一份 XML 文件來描述的。
每個 XML 映射文件都需要宣告對應的 DOCTYPE,Hibernate 會先在類別路徑中搜尋相對應的 DTD 檔案。hibernate-mapping 元素則可帶有多個屬性:
schema:指定映射表所在的 schema 名稱。default-cascade:指定預設的級聯風格,可取 none、save、update。auto-import:允許在查詢語言中使用非全限定的類別名稱。package:指定一個套件前綴。class:定義一個持久化類別。id:定義屬性到資料表主鍵的映射,並透過 generator 產生唯一識別碼。discriminator:識別器,用於定義繼承關係的映射方式。property:為類別宣告一個持久化的 JavaBean 風格屬性。many-to-one 與 one-to-many:分別處理多對一與一對多的關聯映射。Hibernate 的元件分為 component 與 dynamic-component 兩種。component 元素能為子物件建立與父類別對應表欄位之間的映射,其屬性包含 name(屬性名)、class(類別名)、insert 與 update(是否出現在 SQL 的 INSERT/UPDATE 陳述句中),以及 access(存取屬性的策略)。
在物件/關聯映射中,Hibernate 以映射類型作為 Java 類型與 SQL 類型之間的橋梁,分為內建與自訂兩種。內建映射類型涵蓋了所有 Java 原生類型與常用類別,例如 integer 對應 Java 的 Integer/int 與 SQL 的 INTEGER,string 對應 java.lang.String 與 VARCHAR。若內建類型無法滿足需求,也可實作 UserType 或 CompositeUserType 介面來建立自訂映射類型。