Hibernate 简明教程

Hibernate - Mapping Files

对象/关系映射通常在 XML 文档中定义。此映射文件指示 Hibernate — 如何将定义的类或类映射到数据库表?

尽管许多 Hibernate 用户选择手动编写 XML,但存在许多工具可用于生成映射文档。对于高级 Hibernate 用户,这些工具包括 XDoclet, MiddlegenAndroMDA

让我们考虑我们之前定义的 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 中。

让我们详细了解映射文件 -

  1. 映射文档是 XML 文档,拥有 &lt;hibernate-mapping&gt; 作为根元素,其中包含所有 &lt;class&gt; 元素。

  2. &lt;class&gt; 元素是用来定义从 Java 类到数据库表间的特定映射。使用 class 元素的 name 属性指定 Java 类名,使用 table 属性指定数据库 table 名。

  3. &lt;meta&gt; 元素是可选元素,可用来创建类描述。

  4. &lt;id&gt; 元素将类中的唯一 ID 属性映射到数据库表的为主键。id 元素的 name 属性引用类中的属性,而 column 属性引用数据库表中的列。 type 属性保存 Hibernate 映射类型,这些映射类型将从 Java 转换为 SQL 数据类型。

  5. id 元素中的 &lt;generator&gt; 元素用来自动生成主键值。generator 元素的 class 属性被设置为 native ,以便让 Hibernate 选择 identity, sequencehilo 算法来根据底层数据库的功能创建主键。

  6. &lt;property&gt; 元素用来将 Java 类属性映射到数据库表中的一列。element 的 name 属性引用类中的属性,而 column 属性引用数据库表中的列。 type 属性保存 Hibernate 映射类型,这些映射类型将从 Java 转换为 SQL 数据类型。

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

Generator

生成器类用于为对象生成一个 ID,该 ID 将成为数据库表的的主键。所有生成器类都实现 org.hibernate.id.IdentifierGenerator 接口。可以通过实现上述接口并重写 generator(SharedSessionContractImplementor sess, Object obj) 方法来创建自己的生成器类。

查看以下 employee.hbm.xml 文件片段:

<hibernate-mapping>
   <class name="com.mypackage.Employee" table="emp">
      <id name="id">
         <generator class="assigned"></generator>
      </id>
...
</hibernate-mapping>

Types of Generator Classes

Hibernate 提供了许多预定义的 generator 类。Hibernate 中一些重要的预定义生成器类为: