Hibernate 3.5.4 中文权威教程与参考文档

需积分: 0 66 浏览量更新于2024-07-24 收藏 1.79MB PDF 举报

“Hibernate3.5.4中文帮助文档”是一份详尽的指南，由Gavin King、Christian Bauer等多位专家编译，并包含了图形设计师James Cobb和Cheyenne Weaver的贡献。这份文档提供了关于Hibernate 3.5.4版本的权威翻译，旨在帮助Java开发者理解和使用Hibernate进行关系型数据库持久化。文档内容主要分为教程、架构、配置等多个部分，旨在逐步引导读者掌握Hibernate的核心概念和技术。 1. **教程**：这部分从基础开始，介绍如何搭建第一个Hibernate应用。包括设置环境、定义实体类、创建映射文件、配置Hibernate、使用Maven构建项目、创建启动和辅助类以及加载和存储对象。此外，还深入介绍了关联映射，如单向和双向Set-based关联、值类型集合以及如何管理复杂的关联关系。 2. **体系结构**：这部分概述了Hibernate的总体设计，包括实例的状态管理、JMX整合、对JCA（Java Connector Architecture）的支持，以及上下文相关的会话管理。这些内容有助于理解Hibernate内部的工作原理和交互机制。 3. **配置**：这部分详细讲解了如何配置Hibernate，包括通过编程方式配置、获取SessionFactory、JDBC连接的设置，以及各种可选配置属性。这些属性涉及SQL方言、外连接抓取、二进制流处理、二级缓存和查询缓存的使用，还有查询语言中的占位符替换和Hibernate的统计功能。同时，还讨论了日志管理和命名策略的实现。文档中还包括了实际的web应用程序案例——EventManager，演示了如何在Servlet环境中使用Hibernate处理数据，包括编写servlet、处理和渲染数据，以及部署和测试应用。 "Hibernate3.5.4中文帮助文档"是学习和使用Hibernate进行Java开发的重要参考资料，涵盖了从基础到高级的各种主题，适合不同水平的开发者参考。通过这份文档，读者能够深入理解Hibernate的持久化机制，有效利用其功能来简化数据库操作。

第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://hibernate.sourceforge.net/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 第26.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://hibernate.sourceforge.net/hibernate-configuration-3.0.dtd">

<hibernate-configuration>

<session-factory>

剩余317页未读，继续阅读

low_key_style

粉丝: 0

Hibernate 3.5.4 中文权威教程与参考文档

hibernate3.5.4中文帮助文档.pdf

hibernate3.5.4全中文帮助文档

Hibernate 3.5.4 中文教程与参考文档

Hibernate 3.5.4 中文教程与配置详解

Hibernate 3.5.4中文教程与配置详解

Hibernate 3.5.4中文教程：入门到高级配置

Hibernate 3.5.4 中文教程与持久化框架详解

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

Jbpm4.4+hibernate3.5.4+spring3.0.4+struts2.1.8整合

RSuite 3.5.4 的查询功能源代码分析及修改

最新资源