Hibernate - 對映檔案



物件關係對映通常在 XML 文件中定義。此對映檔案指示 Hibernate 如何將定義的類或多個類對映到資料庫表?

儘管許多 Hibernate 使用者選擇手動編寫 XML,但存在許多工具可以生成對映文件。對於高階 Hibernate 使用者,這些工具包括**XDoclet、Middlegen** 和 **AndroMDA**。

讓我們考慮我們之前定義的 POJO 類,其物件將持久化到下一節中定義的表中。

public class Employee {
   private int id;
   private String firstName; 
   private String lastName;   
   private int salary;  

   public Employee() {}
   
   public Employee(String fname, String lname, int salary) {
      this.firstName = fname;
      this.lastName = lname;
      this.salary = salary;
   }
   
   public int getId() {
      return id;
   }
   
   public void setId( int id ) {
      this.id = id;
   }
   
   public String getFirstName() {
      return firstName;
   }
   
   public void setFirstName( String first_name ) {
      this.firstName = first_name;
   }
   
   public String getLastName() {
      return lastName;
   }
   
   public void setLastName( String last_name ) {
      this.lastName = last_name;
   }
   
   public int getSalary() {
      return salary;
   }
   
   public void setSalary( int salary ) {
      this.salary = salary;
   }
}

對於您希望提供永續性的每個物件,將有一個相應的表。考慮需要將上述物件儲存和檢索到以下 RDBMS 表中:

create table EMPLOYEE (
   id INT NOT NULL auto_increment,
   first_name VARCHAR(20) default NULL,
   last_name  VARCHAR(20) default NULL,
   salary     INT  default NULL,
   PRIMARY KEY (id)
);

基於以上兩個實體,我們可以定義以下對映檔案,該檔案指示 Hibernate 如何將定義的類或多個類對映到資料庫表。

<?xml version = "1.0" encoding = "utf-8"?>
<!DOCTYPE hibernate-mapping PUBLIC 
"-//Hibernate/Hibernate Mapping DTD//EN"
"http://www.hibernate.org/dtd/hibernate-mapping-3.0.dtd"> 

<hibernate-mapping>
   <class name = "Employee" table = "EMPLOYEE">
      
      <meta attribute = "class-description">
         This class contains the employee detail. 
      </meta>
      
      <id name = "id" type = "int" column = "id">
         <generator class="native"/>
      </id>
      
      <property name = "firstName" column = "first_name" type = "string"/>
      <property name = "lastName" column = "last_name" type = "string"/>
      <property name = "salary" column = "salary" type = "int"/>
      
   </class>
</hibernate-mapping>

您應該將對映文件儲存在格式為 <classname>.hbm.xml 的檔案中。我們將我們的對映文件儲存在 Employee.hbm.xml 檔案中。

讓我們詳細瞭解一下對映檔案中使用的對映元素:

  • 對映文件是一個 XML 文件,其根元素為**<hibernate-mapping>**,其中包含所有**<class>** 元素。

  • **<class>** 元素用於定義從 Java 類到資料庫表的特定對映。Java 類名使用 class 元素的 name 屬性指定,資料庫表名使用 table 屬性指定。

  • **<meta>** 元素是可選元素,可用於建立類描述。

  • **<id>** 元素將類中唯一的 ID 屬性對映到資料庫表的主鍵。id 元素的 name 屬性引用類中的屬性,column 屬性引用資料庫表中的列。type 屬性包含 Hibernate 對映型別,此對映型別將 Java 型別轉換為 SQL 資料型別。

  • id 元素中的**<generator>** 元素用於自動生成主鍵值。generator 元素的 class 屬性設定為**native**,以允許 Hibernate 根據底層資料庫的功能選擇 identity、sequence 或 hilo 演算法來建立主鍵。

  • **<property>** 元素用於將 Java 類屬性對映到資料庫表中的列。元素的 name 屬性引用類中的屬性,column 屬性引用資料庫表中的列。type 屬性包含 Hibernate 對映型別,此對映型別將 Java 型別轉換為 SQL 資料型別。

還有其他屬性和元素可用於對映文件,在討論其他與 Hibernate 相關的主題時,我將盡量涵蓋儘可能多的內容。

廣告