Hibernate入门指南与配置详解

需积分: 9 95 浏览量更新于2024-07-28 收藏 1.87MB PDF 举报

"Hibernate_reference, 开源文档, 关系型持久化框架, Java idiomatic, GavinKing, ChristianBauer, MaxRydahlAndersen, EmmanuelBernard, SteveEbersole, Hibernate教程, 体系结构, 配置" 《Hibernate Reference Documentation》是关于Hibernate，一个Java领域的关系型数据持久化框架的重要参考资料。该文档由Gavin King、Christian Bauer等多位贡献者共同编写，并且开源。Hibernate的主要目标是提供一种更加idiomatic的方式，即更符合Java语言习惯的方式来处理关系数据库的持久化。文档分为多个部分，首先是一个逐步的教程，引导开发者从零开始学习Hibernate。教程包括设置环境、定义实体类、创建映射文件、配置Hibernate、使用Maven构建项目、启动辅助类以及如何加载和存储对象。在关联映射部分，讲解了如何处理Person类的关联，包括单向Set-based关联、值类型的集合、双向关联及其配置。此外，还展示了如何在EventManager web应用程序中使用Hibernate，涵盖了servlet的编写、处理与渲染以及部署和测试。在体系结构章节，文档概述了Hibernate的整体架构，包括实例的状态管理、与Java Management Extensions (JMX)的集成、对Java Connector Architecture (JCA)的支持，以及上下文相关的会话管理。配置部分详细阐述了如何设置和使用Hibernate，如编程式配置、SessionFactory的获取、JDBC连接的管理，以及各种可选配置属性，如SQL方言选择、外连接抓取策略、二进制流处理、二级缓存和查询缓存的配置，还有查询语言中的占位符替换和Hibernate的统计机制。同时，文档还涵盖了日志系统和命名策略的实现。《Hibernate Reference Documentation》是学习和掌握Hibernate框架不可或缺的资源，无论对于初学者还是有经验的开发人员，都能从中找到详尽的指导和深入的理解。通过这份文档，开发者可以更好地利用Hibernate来简化Java应用程序与数据库之间的交互，提高开发效率和代码质量。

第1章教程

public Event() {}

public Long getId() {

return id;

}

private void setId(Long id) {

this.id = id;

}

public Date getDate() {

return date;

}

public void setDate(Date date) {

this.date = date;

}

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 配置

</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 用反射（reflection）来决定这个映射类型。这需

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

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

1.1.4.Hibernate 配置

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

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

第1章教程

注意

We do this do that the data remains between runs.

在开发的根目录下创建一个 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 内置的连接池。

小心

The built-in Hibernate connection pool is in no way intended for production

use. It lacks several features found on any decent connection pool.

为了保存 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>

<property name="connection.driver_class"

>org.hsqldb.jdbcDriver</property>

<property name="connection.url"

>jdbc:hsqldb:hsql://localhost</property>

<property name="connection.username"

>sa</property>

<property name="connection.password"

></property>

剩余339页未读，继续阅读

tianyawuhen1988

粉丝: 0

Hibernate入门指南与配置详解

hibernate_reference(中文文档)

hibernate_reference

hibernate_reference 3.12

hibernate_reference3.2.1

hibernate_reference文档

hibernate_reference_3.5.pdf

hibernate_reference_3.5.6.pdf

hibernate_reference_entityManager 3.5.0_final pdf

hibernate_reference.pdf

《No.986 三菱PLC与组态王协同驱动的饮料自动装箱机控制系统优化设计》,三菱PLC与组态王结合的饮料自动装箱机控制系统设计与应用No.986,No.986 三菱PLC和组态王组态饮料自动装箱机控

最新资源