Hibernate教程

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类到数据库表.使用class元素的 name 属性指定Java类名，并使用table属性指定数据库 table 名称.
< meta> 元素是可选元素，可用于创建类描述.
< id> 元素将类中的唯一ID属性映射到数据库表的主键. id元素的 name 属性引用类中的属性，列属性引用数据库表中的列. type 属性保存hibernate映射类型，此映射类型将从Java转换为SQL数据类型.
id元素中的< generator> 元素用于自动生成主键值.生成器元素的 class 属性设置为 native ，让hibernate选择标识，序列或 hilo 根据底层数据库的功能创建主键的算法.
< property> 元素用于映射数据库表中列的Java类属性.元素的 name 属性引用类中的属性，列属性引用数据库表中的列. type 属性保存hibernate映射类型，此映射类型将从Java转换为SQL数据类型.