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 中。

让我们看看了解一下关于映射文件中使用的映射元素的一些细节

  • 映射文档是以 <hibernate-mapping> 作为根元素的 XML 文档,它包含所有 <class> 元素。
  • <class> 元素用于定义从 Java 类到数据库表的特定映射。 Java 类名使用 class 元素的 name 属性指定,数据库表名使用 table 属性指定。
  • <meta> 元素是可选元素,可用于创建类描述。
  • <id> 元素将类中的唯一 ID 属性映射到数据库表的主键。 id 元素的 name 属性指的是类中的属性,column 属性指的是数据库表中的列。 type 属性保存hibernate 映射类型,这种映射类型将从Java 转换为SQL 数据类型。
  • id 元素中的 <generator> 元素用于自动生成主键值。生成器元素的 class 属性设置为 native 来让 hibernate 选择身份、序列或 hilo 算法来根据底层数据库的功能创建主键。
  • <property> 元素用于将 Java 类属性映射到数据库表中的列。元素的名称属性是指类中的属性,列属性是指数据库表中的列。 type 属性保存hibernate 映射类型,这种映射类型将从Java 转换为SQL 数据类型。

还有其他可用的属性和元素,它们将在映射文档中使用,在讨论其他 Hibernate 相关主题时,将尝试涵盖尽可能多的内容。

查看笔记

扫码一下
查看教程更方便