Hibernate 3.6.7中文教程：入门与配置详解

5星 · 超过95%的资源需积分: 10 2 浏览量更新于2024-07-23 1 收藏 2.36MB PDF 举报

Hibernate 3.6.7中文帮助文档是一份详细的指南，专为那些想要理解和使用Hibernate 3.6.7版本的Java开发者设计。该文档由Gavin King、Christian Bauer等知名开发人员共同编撰，提供了丰富的教程和实用技术内容。在第一部分“第一个Hibernate应用程序”，作者引导读者从创建第一个Hibernate项目开始，包括设置开发环境、编写第一个Java class、定义实体类映射（XML文件）、配置Hibernate环境，以及利用Maven构建工具。接着，通过实例演示了如何加载和存储对象，展示了Hibernate的基本操作流程。第二部分深入探讨了关联映射，包括单向和双向关联的处理，以及值类型集合的使用。这部分内容对于理解ORM（Object-Relational Mapping）的核心概念至关重要，帮助开发者理解如何在Java对象之间建立数据库表之间的关系。第三部分介绍了EventManager web应用程序，通过编写Servlet、处理HTTP请求、渲染页面以及部署和测试，展示了如何将Hibernate应用到实际的Web开发项目中。文档还涵盖了Hibernate的体系结构，如基本架构的不同选项、JMX集成、上下文相关的会话管理，这些内容有助于开发者理解系统的内部运作机制。在配置方面，文档详细讲解了编程式配置SessionFactory的方式，JDBC连接的管理，以及一系列可选配置属性，如SQL方言的选择、外连接抓取策略、处理二进制流和缓存策略，这些都是优化性能和适应不同数据库需求的关键要素。 Hibernate 3.6.7中文帮助文档为Java开发者提供了一套完整的教程和参考手册，无论你是初次接触Hibernate的新手还是寻求高级特性的老手，都能从中获益匪浅。通过这份文档，你将掌握如何在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
资源: 1

Hibernate 3.6.7中文教程：入门与配置详解

Hibernate 3.6.7 帮助文档

hibernate-3.6.7中文帮助文档

Hibernate3.6.7中文文档chm版

Hibernate3.6.7中文文档

hibernate3.6.7

Hibernate 3.6.7 中文教程与参考文档

Hibernate 3.6.7 中文教程与参考手册

Hibernate 3.6.7中文教程与配置详解

Hibernate 3.6.7 中文教程与持久化指南

Hibernate 3.6.7中文教程：入门与核心配置

最新资源