Hibernate - 映射文件
对象/关系映射通常在 XML 文档中定义。此映射文件指示 Hibernate 如何将定义的 class 或 classes 映射到数据库表。
尽管许多 Hibernate 用户选择手动编写 XML,但存在多种工具可以生成映射文档。这些工具包括适用于高级 Hibernate 用户的 XDoclet、Middlegen 和 AndroMDA。
让我们考虑之前定义的 POJO class,其对象将持久化到下一节中定义的表中。
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 如何将定义的 class 或 classes 映射到数据库表。
<?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">
此 class 包含员工详细信息。
</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 classes 到数据库表的特定映射。使用 class 元素的 name 属性指定 Java class 名称,使用 table 属性指定数据库 table 名称。
<meta> 元素是可选元素,可用于创建 class 描述。
<id> 元素将 class 中的唯一 ID 属性映射到数据库表的主键。id 元素的 name 属性引用 class 中的属性,column 属性引用数据库表中的列。type 属性持有 Hibernate 映射类型,此映射类型将从 Java 数据类型转换为 SQL 数据类型。
id 元素中的 <generator> 元素用于自动生成主键值。generator 元素的 class 属性设置为 native,让 Hibernate 根据底层数据库的能力选择 identity、sequence 或 hilo 算法来创建主键。
<property> 元素用于将 Java class 属性映射到数据库表中的列。元素的 name 属性引用 class 中的属性,column 属性引用数据库表中的列。type 属性持有 Hibernate 映射类型,此映射类型将从 Java 数据类型转换为 SQL 数据类型。
还有其他属性和元素可用于映射文档,我会在讨论其他 Hibernate 相关主题时尽量覆盖尽可能多的内容。