Hibernate中文版教程与参考文档

3星 · 超过75%的资源需积分: 12 148 浏览量更新于2024-07-24 收藏 2.36MB PDF 举报

"hibernate中文版帮助文档，PDF格式，适用于学习JAVA三大框架的程序员，包含Hibernate API相关知识，详细介绍了Hibernate的使用教程、体系结构、配置等内容。" Hibernate是Java开发中的一个流行持久化框架，它提供了对象关系映射（ORM）功能，允许开发者以面向对象的方式操作数据库。这个中文版的帮助文档详细地阐述了如何使用Hibernate进行数据持久化，对于正在研究Java Spring、Struts和Hibernate这三大框架的程序员来说是一份宝贵的参考资料。文档首先从教程开始，引导读者逐步构建第一个Hibernate应用程序。教程涵盖了环境设置、定义实体类、创建映射文件、配置Hibernate、使用Maven构建项目、启动和使用辅助类、加载和存储对象等基础步骤。此外，还详细讲解了如何处理对象之间的关联，包括单向和双向关联映射，以及如何使这些关联生效。在体系结构章节，文档概述了Hibernate的基本架构，包括最小架构和全面架构，强调了基本APIs的作用。还提到了JMX（Java Management Extensions）的整合，使得对Hibernate的管理更加便捷。同时，文档还介绍了上下文相关的会话，这是在不同场景下管理数据库会话的重要概念。配置部分详细讨论了如何配置Hibernate，包括通过编程方式进行配置、获取SessionFactory、JDBC连接的设置，以及一系列可选的配置属性，如SQL方言选择、外连接抓取策略、处理二进制流的方式、二级缓存和查询缓存的配置，这些都是优化Hibernate性能和适应不同数据库的关键。此外，文档还涵盖了查询语言，包括HQL（Hibernate Query Language）和 Criteria API，这些都是在实际开发中检索和操作数据的主要工具。这份Hibernate中文版帮助文档全面地覆盖了Hibernate的基础知识和高级特性，对于想要深入理解和使用Hibernate的Java开发者来说，是一份不可或缺的学习资料。通过学习，开发者可以更好地掌握如何在Java应用中实现高效、灵活的数据持久化。

第1章教程

public String getTitle() {

return title;

}

public void setTitle(String title) {

this.title = title;

}

你可以看到这个类对属性的存取方法（getter and setter method）使用了标准

JavaBean 命名约定，同时把类属性（field）的访问级别设成私有的（private）。这是推荐的

设计，但并不是必须的。Hibernate 也可以直接访问这些 field，而使用访问方法（accessor

method）的好处是提供了重构时的健壮性（robustness）。

对一特定的 event, id 属性持有唯一的标识符（identifier）的

值。如果我们希望使用 Hibernate 提供的所有特性，那么所有的持久化实体

（persistent entity）类（这里也包括一些次要依赖类）都需要一个这样的标识符属性。而事实

上，大多数应用程序（特别是 web 应用程序）都需要通过标识符来区别对象，所以你应该考虑使

用标识符属性而不是把它当作一种限制。然而，我们通常不会操作对象的标识（identity），因

此它的 setter 方法的访问级别应该声明 private。这样当对象被保存的时候，只有 Hibernate

可以为它分配标识符值。你可看到Hibernate可以直接访问 public，private 和 protected 的访

问方法和 field。所以选择哪种方式完全取决于你，你可以使你的选择与你的应用程序设计相吻

合。

所有的持久化类（persistent classes）都要求有无参的构造器，因为 Hibernate 必须使用 Java

反射机制来为你创建对象。构造器（constructor）的访问级别可以是 private，然而当生成运行

时代理（runtime proxy）的时候则要求使用至少是 package 级别的访问控制，这样在没有字节

码指令（bytecode instrumentation）的情况下，从持久化类里获取数据会更有效率。

把这个文件保存到 src/main/java/org/hibernate/tutorial/domain 目录下。

1.1.3.映射文件

Hibernate 需要知道怎样去加载（load）和存储（store）持久化类的对象。这正是 Hibernate 映

射文件发挥作用的地方。映射文件告诉 Hibernate 它应该访问数据库（database）里面的哪个表

（table）及应该使用表里面的哪些字段（column）。

一个映射文件的基本结构看起来像这样：

<?xml version="1.0"?>

<!DOCTYPE hibernate-mapping PUBLIC

"-//Hibernate/Hibernate Mapping DTD 3.0//EN"

"http://www.hibernate.org/dtd/hibernate-mapping-3.0.dtd">

<hibernate-mapping package="org.hibernate.tutorial.domain">

[...]

</hibernate-mapping

映射文件

注意 Hibernate 的 DTD 是非常复杂的。你的编辑器或者 IDE 里使用它来自动完成那些用来映

射的 XML 元素（element）和属性（attribute）。你也可以在文本编辑器里打开 DTD — 这是

最简单的方式来概览所有的元素和 attribute，并查看它们的缺省值以及注释。注意 Hibernate

不会从 web 加载 DTD 文件，但它会首先在应用程序的 classpath 中查找。DTD 文件已包括在

hibernate3.jar 里，同时也在 Hibernate 发布包的 src/ 目录下。

重要

为缩短代码长度，在以后的例子里我们会省略 DTD 的声明。当然，在实际的应用

程序中，DTD 声明是必需的。

在 hibernate-mapping 标签（tag）之间, 含有一个 class 元素。所有的持久化实体类（再次声

明，或许接下来会有依赖类，就是那些次要的实体）都需要一个这样的映射，来把类对象映射到

SQL 数据库里的表：

<hibernate-mapping package="org.hibernate.tutorial.domain">

</class>

</hibernate-mapping

到目前为止，我们告诉了 Hibernate 怎样把 Events 类的对象

持久化到数据库的 EVENTS 表里，以及怎样从 EVENTS 表加载到

Events 类的对象。每个实例对应着数据库表中的一行。现在我们将继续讨论有关唯一标识符属性

到数据库表的映射。另外，由于我们不关心怎样处理这个标识符，我们就配置由 Hibernate 的标

识符生成策略来产生代理主键字段：

<hibernate-mapping package="org.hibernate.tutorial.domain">

</id>

</class>

</hibernate-mapping

id 元素是对 identifier 属性的声明。name="id" 映射属性声明了 JavaBean 属性的名称并告诉

Hibernate 使用 getId() 和 setId() 方法来访问这个属性。column 属性告诉 Hibernate EVENTS

表的哪个字段持有主键值。

第1章教程

嵌套的 generator 元素指定标识符的生成策略（也就是标识符值是怎么产生的）。在这个例子

里，我们选择 native，它提供了取决于数据库方言的可移植性。Hibernate 数据库生成的、全局

性唯一的以及应用程序分配的标识符。标识符值的生成也是 Hibernate 的扩展功能之一，你可以

插入自己的策略。

提示

native is no longer consider the best strategy in terms of portability.

for further discussion, see 第28.4节 “标识符的生成”

最后我们在映射文件里面包含需要持久化属性的声明。默认情况下，类里面的属性都被视为非持

久化的：

<hibernate-mapping package="org.hibernate.tutorial.domain">

</id>

</class>

</hibernate-mapping

和 id 元素一样，property 元素的 name 属性告诉 Hibernate 使用哪个 getter 和 setter 方法。

在此例中，Hibernate 会寻找 getDate()、setDate()、getTitle() 和 setTitle() 方法。

注意

为什么 date 属性的映射含有 column attribute，而 title 却没有？当没有设定

column attribute 的时候，Hibernate 缺省地使用 JavaBean 的属性名作为字段

名。对于 title，这样工作得很好。然而，date 在多数的数据库里，是一个保留关

键字，所以我们最好把它映射成一个不同的名字。

另一有趣的事情是 title 属性缺少一个 type attribute。我们在映射文件里声明并使用的类型，

却不是我们期望的那样，是 Java 数据类型，同时也不是 SQL 数据库的数据类型。这些类型就是

所谓的 Hibernate 映射类型（mapping types），它们能把 Java 数据类型转换到 SQL 数据类

型，反之亦然。再次重申，如果在映射文件中没有设置 type 属性的话，Hibernate 会自己试着去

确定正确的转换类型和它的映射类型。在某些情况下这个自动检测机制（在 Java 类上使用反射

机制）不会产生你所期待或需要的缺省值。date 属性就是个很好的例子，Hibernate 无法知道这

个属性（java.util.Date 类型的）应该被映射成：SQL date，或 timestamp，还是 time 字段。在

此例中，把这个属性映射成 timestamp 转换器，这样我们预留了日期和时间的全部信息。

Hibernate 配置

提示

当处理映射文件时，Hibernate 用反射（reflection）来决定这个映射类型。这需

要时间和资源，所以如果你注重启动性能，你应该考虑显性地定义所用的类型。

把这个映射文件保存为 src/main/resources/org/hibernate/tutorial/domain/Event.hbm.xml。

1.1.4.Hibernate 配置

此时，你应该有了持久化类和它的映射文件。现在是配置 Hibernate 的时候了。首先让我们设立

HSQLDB 使其运行在“服务器模式”。

注意

数据在程序运行期间需要保持有效。

在开发的根目录下创建一个 data 目录－这是 HSQL DB 存储数据文件的地方。此时在 data 目

录中运行 java -classpath ../lib/hsqldb.jar org.hsqldb.Server 就可启动数据库。你可以在 log

中看到它的启动，及绑定到 TCP/IP 套接字，这正是我们的应用程序稍后会连接的地方。如果你

希望在本例中运行一个全新的数据库，就在窗口中按下 CTRL + C 来关闭 HSQL 数据库，并删除

data/ 目录下的所有文件，再重新启动 HSQL 数据库。

Hibernate 将为你的应用程序连接到数据库，所以它需要知道如何获取连接。在这个教程里，我

们使用一个独立连接池（和 javax.sql.DataSource 相反）。Hibernate 支持两个第三方的开源

JDBC 连接池：c3p0 [https://sourceforge.net/projects/c3p0] 和 proxool [http://

proxool.sourceforge.net/]。然而，在本教程里我们将使用 Hibernate 内置的连接池。

小心

嵌入的 Hibernate 连接池不用于产品环境。它缺乏连接池里的几个功能。

为了保存 Hibernate 的配置，我们可以使用一个简单的 hibernate.properties 文件，或者一个

稍微复杂的 hibernate.cfg.xml，甚至可以完全使用程序来配置 Hibernate。多数用户更喜欢使用

XML 配置文件：

<?xml version='1.0' encoding='utf-8'?>

<!DOCTYPE hibernate-configuration PUBLIC

"-//Hibernate/Hibernate Configuration DTD 3.0//EN"

"http://www.hibernate.org/dtd/hibernate-configuration-3.0.dtd">

<hibernate-configuration>

<session-factory>

剩余397页未读，继续阅读

凡人棋子

粉丝: 0
资源: 2

Hibernate中文版教程与参考文档

hibernate中文帮助文档

Hibernate3.1中文帮助文档

Hibernate 中文 html 帮助文档

Hibernate中文版参考文档

hibernate 中文帮助文档

Hibernate中文帮助文档网页版

hibernate3.6中文帮助文档

Hibernate3.2.0中文帮助文档

hibernate3.3.2中文帮助文档

hibernate3.5.4中文帮助文档

最新资源