Hibernate-Annotation中文教程.pdf

(1)

简介：

在过去几年里，Hibernate 不断发展，几乎成为 Java 数据库持久性的事实标准。

它非常强大、灵活，而且具备了优异的性能。在本文中，我们将了解如何使用

Java 5 注释来简化 Hibernate 代码，并使持久层的编码过程变得更为轻松。

传统上，Hibernate 的配置依赖于外部 XML 文件：数据库映射被定义为一

组 XML 映射文件，并且在启动时进行加载。

在最近发布的几个 Hibernate 版本中，出现了一种基于 Java 5 注释的更为

巧妙的新方法。借助新的 Hibernate Annotation 库，即可一次性地分配所有旧

第一步，

环境与 jar 包：

要使用 Hibernate Annotation，您至少需要具备 Hibernate 3.2 和 Java 5。

可以从 Hibernate 站点下载 Hibernate 3.2 和 Hibernate Annotation 库。除

了标准的 Hibernate JAR 和依赖项之外，您还需要 Hibernate

Annotations .jar 文件（hibernate-annotations.jar）、Java 持久性 API

（lib/ejb3-persistence.jar）。

添加 hibernate3.2.jar,hibernate-annotations- 3.3.0.jar ，

hibernate-commons-annotations.jar 和 ejb3-persistence.jar 。这样就可以

使用 hibernate 的 annotation 了。

</dependency>

<dependency>

<groupId>org.hibernate</groupId>

<artifactId>hibernate-annotations</artifactId>

<version>3.2.0.ga</version>

</dependency>

<dependency>

<groupId>javax.persistence</groupId>

<artifactId>persistence-api</artifactId>

<version>1.0</version>

获取 Hibernate 会话工厂。尽管无需惊天的修改，但这一工作与使用 Hibernate

Annotations 有所不同。您需要使用 AnnotationConfiguration 类来建立会话

工厂：

sessionFactory = new AnnotationConfiguration().buildSessionFactory();

第三步，

尽管通常使用 <mapping> 元素来声明持久性类，您还是需要在 Hibernate 配置

文件（通常是 hibernate.cfg.xml）中声明持久性类：

<!DOCTYPE hibernate-configuration PUBLIC

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

<mapping

class="com.onjava.modelplanes.domain.ModelPlane"/>

</session-factory>

</hibernate-configuration>

近期的许多 Java 项目都使用了轻量级的应用框架，例如 Spring。如果您

正在使用 Spring 框架，可以使用

AnnotationSessionFactoryBean 类轻松建立一个基于注释的 Hibernate 会话

工厂，如下所示：

<!-- Hibernate session factory -->

<bean id="sessionFactory"

<prop

key="hibernate.dialect">org.hibernate.dialect.DerbyDialect</prop>

<prop key="hibernate.hbm2ddl.auto">create</prop>

...

</props>

</property>

<property name="annotatedClasses">

<list>

<value>com.onjava.modelplanes.domain.PlaneType</value>

<value>com.onjava.modelplanes.domain.ModelPlane</value>

</property>

</bean>

(3)

hibernate Annotation 标签的使用:

[1]

1.带注释的持久性类也是普通 POJO,它们只是具备了持久性注释的普通 POJO 。

2.事实上，您既可以保持字段的持久性（注释写在成员变量之上），也可以保持

属性（注释写在 getter 方法之上）的持久性。

3.常用的 hibernate annotation 标签如下:

@Table(name="promotion_info" ) -- 持久性映射的表(表名

="promotion_info).@Table 是类一级的注解 ,定义在@Entity 下,为实体 bean 映射表,目录和

schema 的名字,默认为实体 bean 的类名,不带包名.

@Id-- 注释可以表明哪种属性是该类中的独特标识符 (即相当于数据表的主键 )。

@GeneratedValue -- 定义自动增长的主键的生成策略 .

@Transient --将忽略这些字段和属性,不用持久化到数据库 .适用于,在当前的持久

类中,某些属性不是用于映射到数据表 ,而是用于其它的业务逻辑需要 ,这时,须将这些属性进行

transient 的注解.否则系统会因映射不到数据表相应字段而出错 .

@Temporal (TemporalType.TIMESTAMP)-- 声明时间格式

@Enumerated -- 声明枚举

用 sum、average 、max 等)

@OrderBy --Many 端某个字段排序(List)

1.2

Hibernate 能够出色地自动生成主键。Hibernate/EBJ 3 注释也可以为主键的自

动生成提供丰富的支持，允许实现各种策略。

其生成规则由@GeneratedValue 设定的.这里的@id 和@GeneratedValue 都是 JPA

的标准用法, JPA 提供四种标准用法,由@GeneratedValue 的源代码可以明显看出.

JPA 提供的四种标准用法为 TABLE,SEQUENCE,IDENTITY,AUTO.

TABLE：使用一个特定的数据库表格来保存主键。

SEQUENCE：根据底层数据库的序列来生成主键，条件是数据库支持序列。

IDENTITY：主键由数据库自动生成（主要是自动增长型）