HIBERNATE - 符合Java习惯的关系数据库持久化 Hibernate参考文档
Hibernate参考文档
3.1.2
目录
前言
1. 翻译说明
2. 版权声明
1.Hibernate入门
1.1.前言
1.2.第一部分-第一个Hibernate应用程序
1.2.1.第一个class
1.2.2.映射文件
1.2.3. Hibernate配置
1.2.4.用Ant构建
1.2.5.启动和辅助类
1.2.6. 加载并存储对象
1.3.第二部分-关联映射
1.3.1. 映射Person类
1.3.2. 单向Set-based的关联
1.3.3.使关联工作
1.3.4. 值类型的集合
1.3.5. 双向关联
1.3.6. 使双向连起来
1.4.第三部分 - EventManager web应用程序
1.4.1.编写基本的servlet
1.4.2.处理与渲染
1.4.3.部署与测试
1.5.总结
2.体系结构(Architecture)
2.1.概况(Overview)
2.2.实例状态
2.3.JMX整合
2.4.对JCA的支持
2.5.上下文相关的(Contextual)Session
3. 配置
3.1.可编程的配置方式
3.2.获得SessionFactory
3.3.JDBC连接
3.4.可选的配置属性
3.4.1. SQL方言
3.4.2. 外连接抓取(OuterJoin Fetching)
3.4.3. 二进制流(Binary Streams)
3.4.4. 二级缓存与查询缓存
3.4.5. 查询语言中的替换
3.4.6. Hibernate的统计(statistics)机制
3.5.日志
3.6.实现NamingStrategy
3.7.XML配置文件
3.8.J2EE应用程序服务器的集成
3.8.1. 事务策略配置
3.8.2.JNDI绑定的SessionFactory
3.8.3. 在JTA环境下使用Current Session context (当前session上下文)管理
3.8.4.JMX部署
4. 持久化类(PersistentClasses)
4.1.一个简单的POJO例子
4.1.1. 实现一个默认的(即无参数的)构造方法(constructor)
4.1.2. 提供一个标识属性(identifierproperty)(可选)
4.1.3.使用非final的类(可选)
4.1.4. 为持久化字段声明访问器(accessors)和是否可变的标志(mutators)(可选)
4.2. 实现继承(Inheritance)
4.3. 实现equals()和hashCode()
4.4. 动态模型(Dynamicmodels)
4.5.元组片断映射(Tuplizers)
5.对象/关系数据库映射基础(BasicO/R Mapping)
5.1.映射定义(Mapping declaration)
5.1.1.Doctype
5.1.2.hibernate-mapping
5.1.3.class
5.1.4.id
5.1.4.1. Generator
5.1.4.2.高/低位算法(Hi/LoAlgorithm)
5.1.4.3.UUID算法(UUID Algorithm )
5.1.4.4. 标识字段和序列(Identitycolumns and Sequences)
5.1.4.5. 程序分配的标识符(AssignedIdentifiers)
5.1.4.6.触发器实现的主键生成器(Primary keys assigned by triggers)
5.1.5. composite-id
5.1.6. 鉴别器(discriminator)
5.1.7.版本(version)(可选)
5.1.8.timestamp (可选)
5.1.9.property
5.1.10.多对一(many-to-one)
5.1.11.一对一
5.1.12.自然ID(natural-id)
5.1.13.组件(component), 动态组件(dynamic-component)
5.1.14. properties
5.1.15.子类(subclass)
5.1.16. 连接的子类(joined-subclass)
5.1.17. 联合子类(union-subclass)
5.1.18.连接(join)
5.1.19.键(key)
5.1.20.字段和规则元素(column and formula elements)
5.1.21.引用(import)
5.1.22.any
5.2.Hibernate 的类型
5.2.1.实体(Entities)和值(values)
5.2.2.基本值类型
5.2.3.自定义值类型
5.3.多次映射同一个类
5.4.SQL中引号包围的标识符
5.5.其他元数据(Metadata)
5.5.1.使用 XDoclet 标记
5.5.2.使用 JDK 5.0 的注解(Annotation)
5.6.数据库生成属性(Generated Properties)
5.7.辅助数据库对象(Auxiliary Database Objects)
6.集合类(Collections)映射
6.1.持久化集合类(Persistent collections)
6.2.集合映射( Collection mappings )
6.2.1.集合外键(Collection foreign keys)
6.2.2.集合元素(Collection elements)
6.2.3.索引集合类(Indexed collections)
6.2.4.值集合于多对多关联(Collections of values andmany-to-many associations)
6.2.5.一对多关联(One-to-many Associations)
6.3.高级集合映射(Advanced collection mappings)
6.3.1.有序集合(Sorted collections)
6.3.2.双向关联(Bidirectional associations)
6.3.3. 双向关联,涉及有序集合类
6.3.4.三重关联(Ternary associations)
6.3.5.使用<idbag>
6.4.集合例子(Collection example)
7.关联关系映射
7.1.介绍
7.2.单向关联(Unidirectional associations)
7.2.1.多对一(many to one)
7.2.2.一对一(one to one)
7.2.3.一对多(one to many)
7.3.使用连接表的单向关联(Unidirectional associations with jointables)
7.3.1.一对多(one to many)
7.3.2.多对一(many to one)
7.3.3.一对一(one to one)
7.3.4.多对多(many to many)
7.4.双向关联(Bidirectional associations)
7.4.1.一对多(one to many) / 多对一(many to one)
7.4.2.一对一(one to one)
7.5.使用连接表的双向关联(Bidirectional associations with jointables)
7.5.1.一对多(one to many)/多对一( many to one)
7.5.2.一对一(one to one)
7.5.3.多对多(many to many)
7.6.更复杂的关联映射
8.组件(Component)映射
8.1.依赖对象(Dependent objects)
8.2.在集合中出现的依赖对象 (Collections of dependent objects)
8.3.组件作为Map的索引(Componentsas Map indices )
8.4.组件作为联合标识符(Components as composite identifiers)
8.5.动态组件(Dynamic components)
9.继承映射(Inheritance Mappings)
9.1.三种策略
9.1.1.每个类分层结构一张表(Table per class hierarchy)
9.1.2.每个子类一张表(Table per subclass)
9.1.3. 每个子类一张表(Tableper subclass),使用辨别标志(Discriminator)
9.1.4. 混合使用“每个类分层结构一张表”和“每个子类一张表”
9.1.5.每个具体类一张表(Table per concrete class)
9.1.6. Table per concrete class, using implicit polymorphism
9.1.7.隐式多态和其他继承映射混合使用
9.2.限制
10.与对象共事
10.1.Hibernate对象状态(object states)
10.2.使对象持久化
10.3.装载对象
10.4.查询
10.4.1. 执行查询
10.4.1.1. 迭代式获取结果(Iteratingresults)
10.4.1.2. 返回元组(tuples)的查询
10.4.1.3. 标量(Scalar)结果
10.4.1.4. 绑定参数
10.4.1.5. 分页
10.4.1.6. 可滚动遍历(Scrollableiteration)
10.4.1.7. 外置命名查询(Externalizingnamed queries)
10.4.2.过滤集合
10.4.3.条件查询(Criteria queries)
10.4.4. 使用原生SQL的查询
10.5.修改持久对象
10.6.修改脱管(Detached)对象
10.7.自动状态检测
10.8.删除持久对象
10.9.在两个不同数据库间复制对象
10.10.Session刷出(flush)
10.11.传播性持久化(transitive persistence)
10.12.使用元数据
11.事务和并发
11.1.Session和事务范围(transaction scope)
11.1.1.操作单元(Unit of work)
11.1.2.长对话
11.1.3.关注对象标识(Considering object identity)
11.1.4.常见问题
11.2.数据库事务声明
11.2.1. 非托管环境
11.2.2.使用JTA
11.2.3. 异常处理
11.2.4. 事务超时
11.3.乐观并发控制(Optimistic concurrency control)
11.3.1. 应用程序级别的版本检查(Applicationversion checking)
11.3.2. 扩展周期的session和自动版本化
11.3.3. 脱管对象(deatchedobject)和自动版本化
11.3.4. 定制自动版本化行为
11.4.悲观锁定(Pessimistic Locking)
11.5. 连接释放模式(ConnectionRelease Modes)
12.拦截器与事件(Interceptors and events)
12.1.拦截器(Interceptors)
12.2.事件系统(Event system)
12.3.Hibernate的声明式安全机制
13.批量处理(Batch processing)
13.1.批量插入(Batch inserts)
13.2.批量更新(Batch updates)
13.3.StatelessSession (无状态session)接口
13.4.DML(数据操作语言)风格的操作(DML-styleoperations)
14.HQL: Hibernate查询语言
14.1.大小写敏感性问题
14.2.from子句
14.3.关联(Association)与连接(Join)
14.4.join 语法的形式
14.5.select子句
14.6.聚集函数
14.7.多态查询
14.8.where子句
14.9.表达式
14.10.order by子句
14.11.group by子句
14.12.子查询
14.13.HQL示例
14.14.批量的UPDATE和DELETE
14.15.小技巧 & 小窍门
15.条件查询(Criteria Queries)
15.1.创建一个Criteria 实例
15.2.限制结果集内容
15.3.结果集排序
15.4.关联
15.5.动态关联抓取
15.6.查询示例
15.7.投影(Projections)、聚合(aggregation)和分组(grouping)
15.8.离线(detached)查询和子查询
15.9.根据自然标识查询(Queries by natural identifier)
16.Native SQL查询
16.1.使用SQLQuery
16.2.别名和属性引用
16.3.命名SQL查询
16.3.1.使用return-property来明确地指定字段/别名
16.3.2.使用存储过程来查询
16.3.2.1. 使用存储过程的规则和限制
16.4.定制SQL用来create,update和delete
16.5.定制装载SQL
17.过滤数据
17.1.Hibernate 过滤器(filters)
18.XML映射
18.1.用XML数据进行工作
18.1.1.指定同时映射XML和类
18.1.2.只定义XML映射
18.2.XML映射元数据
18.3.操作XML数据
19.提升性能
19.1.抓取策略(Fetching strategies)
19.1.1.操作延迟加载的关联
19.1.2.调整抓取策略(Tuning fetch strategies)
19.1.3.单端关联代理(Single-ended association proxies)
19.1.4. 实例化集合和代理(Initializingcollections and proxies)
19.1.5.使用批量抓取(Using batch fetching)
19.1.6. 使用子查询抓取(Usingsubselect fetching)
19.1.7. 使用延迟属性抓取(Usinglazy property fetching)
19.2.二级缓存(The Second Level Cache)
19.2.1.缓存映射(Cache mappings)
19.2.2.策略:只读缓存(Strategy: read only)
19.2.3.策略:读/写缓存(Strategy: read/write)
19.2.4.策略:非严格读/写缓存(Strategy: nonstrict read/write)
19.2.5. 策略:事务缓存(transactional)
19.3.管理缓存(Managing the caches)
19.4.查询缓存(The Query Cache)
19.5.理解集合性能(Understanding Collection performance)
19.5.1. 分类(Taxonomy)
19.5.2. Lists, maps 和sets用于更新效率最高
19.5.3. Bag和list是反向集合类中效率最高的
19.5.4. 一次性删除(Oneshot delete)
19.6.监测性能(Monitoring performance)
19.6.1.监测SessionFactory
19.6.2. 数据记录(Metrics)
20.工具箱指南
20.1.Schema自动生成(Automatic schema generation)
20.1.1.对schema定制化(Customizingthe schema)
20.1.2.运行该工具
20.1.3.属性(Properties)
20.1.4.使用Ant(Using Ant)
20.1.5.对schema的增量更新(Incrementalschema updates)
20.1.6.用Ant来增量更新schema(UsingAnt for incremental schema updates)
20.1.7.Schema 校验
20.1.8.使用Ant进行schema校验
21. 示例:父子关系(ParentChild Relationships)
21.1. 关于collections需要注意的一点
21.2.双向的一对多关系(Bidirectional one-to-many)
21.3.级联生命周期(Cascading lifecycle)
21.4.级联与未保存值(Cascades and unsaved-value)
21.5. 结论
22.示例:Weblog 应用程序
22.1.持久化类
22.2.Hibernate 映射
22.3.Hibernate 代码
23. 示例:复杂映射实例
23.1.Employer(雇主)/Employee(雇员)
23.2.Author(作家)/Work(作品)
23.3. Customer(客户)/Order(订单)/Product(产品)
23.4.杂例
23.4.1. "Typed" one-to-one association
23.4.2. Composite key example
23.4.3. 共有组合键属性的多对多(Many-to-manywith shared composite key attribute)
23.4.4. Content based discrimination
23.4.5. Associations on alternate keys
24.最佳实践(Best Practices)
Translator(s): RedSaga Translate Team满江红翻译团队 <caoxg@yahoo.com>
Hibernate不仅仅管理Java类到数据库表的映射(包括Java数据类型到SQL数据类型的映射),还提供数据查询和获取数据的方法,可以大幅度减少开发时人工使用SQL和JDBC处理数据的时间。
如果你对Hibernate和对象/关系数据库映射还是个新手,或者甚至对Java也不熟悉,请按照下面的步骤来学习。
- 阅读第1章Hibernate入门,这是一篇包含详细的逐步指导的指南。本指南的源代码包含在发行包中,你可以在doc/reference/tutorial/目录下找到。
- 阅读第2章体系结构(Architecture)来理解Hibernate可以使用的环境。
- 查看Hibernate发行包中的eg/目录,里面有一个简单的独立运行的程序。把你的JDBC驱动拷贝到lib/目录下,修改一下src/hibernate.properties,指定其中你的数据库的信息。进入命令行,切换到你的发行包的目录,输入ant eg(使用了Ant),或者在Windows操作系统中使用build eg。
- 把这份参考文档作为你学习的主要信息来源。
- 在Hibernate 的网站上可以找到经常提问的问题与解答(FAQ)。
- 在Hibernate网站上还有第三方的演示、示例和教程的链接。
- Hibernate网站的“社区(Community Area)”是讨论关于设计模式以及很多整合方案(Tomcat, JBoss AS, Struts, EJB,等等)的好地方。
如果你有问题,请使用Hibernate网站上链接的用户论坛。我们也提供一个JIRA问题追踪系统,来搜集bug报告和新功能请求。如果你对开发Hibernate有兴趣,请加入开发者的邮件列表。(Hibernate网站上的用户论坛有一个中文版面,JavaEye也有Hibernate中文版面,您可以在那里交流问题与经验。)
商业开发、产品支持和Hibernate培训可以通过JBossInc.获得。(请查阅:http://www.hibernate.org/SupportTraining/)。 Hibernate是一个专业的开放源代码项目(ProfessionalOpen Source project),也是JBossEnterprise Middleware System(JEMS),JBoss企业级中间件系统的一个核心组件。
表1. Hibernate v3翻译团队
序号 |
标题 |
中文标题 |
v3翻译 |
v3审校 |
v3.1审校 |
-- |
Quickstart with Tomcat |
在Tomcat中快速上手(3.1版本中取消) |
曹晓钢 |
zoujm |
-- |
#1 |
Turtotial |
Hibernate入门 |
Zheng Shuai |
- |
Sean Chan |
#2 |
Architecture |
体系结构 |
Hilton(BJUG) |
厌倦发呆 |
Sean Chan |
#3 |
Configuration |
配置 |
Goncha |
mochow |
zcgly |
#4 |
Persistent Classes |
持久化类 |
曹晓钢 |
mochow |
DigitalSonic |
#5 |
Basic O/R Mapping |
对象/关系数据库映射基础(上) |
moxie |
Kingfish |
张成钢 |
对象/关系数据库映射基础(下) |
inter_dudu |
刘国雄(vincent) |
张成钢 |
||
#6 |
Collection Mapping |
集合类映射 |
曹晓钢 |
robbin |
-- |
#7 |
Association Mappings |
关联关系映射 |
Robbin |
devils.advocate |
-- |
#8 |
Component Mapping |
组件映射 |
曹晓钢 |
Robbin |
Song guo qiang |
#9 |
Inheritance Mappings |
继承映射 |
morning(BJUG) |
mochow |
Liang cheng |
#10 |
Working with objects |
与对象共事 |
程广楠 |
厌倦发呆 |
-- |
#11 |
Transactions And Concurrency |
事务和并发 |
Robbin |
mochow |
-- |
#12 |
Interceptors and events |
继承映射 |
七彩狼(BJUG) |
厌倦发呆 |
-- |
#13 |
Batch processing |
批量处理 |
Kingfish(BJUG) |
厌倦发呆 |
-- |
#14 |
HQL: The Hibernate Query Language |
HQL: Hibernate查询语言 |
郑浩(BJUG) |
Zheng Shuai |
-- |
#15 |
Criteria Queries |
条件查询 |
nemo(BJUG) |
Zheng Shuai |
-- |
#16 |
Native SQL |
Native SQL查询 |
似水流年 |
zoujm |
-- |
#17 |
Filters |
过滤数据 |
冰云(BJUG) |
Goncha |
-- |
#18 |
XML Mapping |
XML映射 |
edward(BJUG) |
Goncha |
huxb |
#19 |
Improving performance |
性能提升 |
Wangjinfeng |
Robbin |
-- |
#20 |
Toolset Guide |
工具箱指南 |
曹晓钢 |
Robbin |
-- |
#21 |
Example: Parent/Child |
示例:父子关系 |
曹晓钢 |
devils.advocate |
-- |
#22 |
Example: Weblog Application |
示例:Weblog 应用程序 |
曹晓钢 |
devils.advocate |
-- |
#23 |
Example: Various Mappings |
示例:多种映射 |
shidu(BJUG) |
冰云 |
-- |
#24 |
Best Practices |
最佳实践 |
曹晓钢 |
冰云 |
-- |
关于我们
满江红.开源, http://www.redsaga.com
从成立之初就致力于Java开放源代码在中国的传播与发展,与国内多个Java团体及出版社有深入交流。坚持少说多做的原则,目前有两个团队,“OpenDoc团队”与“翻译团队”,本翻译文档即为翻译团队作品。OpenDoc团队已经推出包括Hibernate、iBatis、Spring、WebWork的多份开放文档,并于2005年5月在Hibernate开放文档基础上扩充成书,出版了原创书籍:《深入浅出Hibernate》,本书400余页,适合各个层次的Hibernate用户。(http://www.redsaga.com/hibernate_book.html)敬请支持。
北京Java用户组, http://www.bjug.org
BeiingJava User Group,民间技术交流组织,成立于2004年6月。以交流与共享为宗旨,每两周举行一次技术聚会活动。BJUG的目标是,通过小部分人的努力,形成一个技术社群,创建良好的交流氛围,并将新的技术和思想推广到整个IT界,让我们共同进步。
Java视线, http://www.javaeye.com
Java视线在是Hibernate中文论坛(http://www.hibernate.org.cn,Hibernate中文论坛是中国最早的Hibernate专业用户论坛,为Hibernate在中国的推广做出了巨大的贡献)基础上发展起来的Java深度技术网站,目标是成为一个高品质的,有思想深度的、原创精神的Java技术交流网站,为软件从业人员提供一个自由的交流技术,交流思想和交流信息的平台。
致谢
还有一些朋友给我们发来了勘误,在此致谢:Kurapica,李毅,李海林。
Hibernate英文文档属于Hibernate发行包的一部分,遵循LGPL协议。本翻译版本同样遵循LGPL协议。参与翻译的译者一致同意放弃除署名权外对本翻译版本的其它权利要求。
本章是面向Hibernate初学者的一个入门教程。我们从一个使用驻留内存式(in-memory)数据库的简单命令行应用程序开始,用易于理解的方式逐步开发。
本章的源代码已包含在发布包中,位于doc/reference/tutorial/目录下。
首先我们将创建一个简单的基于控制台的(console-based)Hibernate应用程序。由于我们使用Java数据库(HSQLDB),所以不必安装任何数据库服务器。
假设我们希望有一个小应用程序可以保存我们希望参加的活动(events)和这些活动主办方的相关信息。(译者注:在本教程的后面部分,我们将直接使用event而不是它的中文翻译“活动”,以免混淆。)
接下来我们创建一个类,用来代表那些我们希望储存在数据库里的event。
我们的第一个持久化类是一个带有一些属性(property)的简单JavaBean类:
public voidsetDate(Date date) {
public voidsetTitle(String title) {
把这个Java源代码文件放到开发目录下的src目录里,注意包位置要正确。现在这个目录看起来应该像这样:
<Hibernate andthird-party libraries>
<!DOCTYPE hibernate-mapping PUBLIC
"-//Hibernate/Hibernate Mapping DTD 3.0//EN"
"http://hibernate.sourceforge.net/hibernate-mapping-3.0.dtd">
为缩短代码长度,在以后的例子里我们会省略DTD的声明。当然,在实际的应用程序中,DTD声明是必须的。
<classname="events.Event" table="EVENTS">
<classname="events.Event" table="EVENTS">
<idname="id" column="EVENT_ID">
最后我们在映射文件里面包含需要持久化属性的声明。默认情况下,类里面的属性都被视为非持久化的:
<classname="events.Event" table="EVENTS">
<idname="id" column="EVENT_ID">
<propertyname="date" type="timestamp"column="EVENT_DATE"/>
<Hibernate andthird-party libraries>
<?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">
<!-- Databaseconnection settings -->
<propertyname="connection.driver_class">org.hsqldb.jdbcDriver</property>
<propertyname="connection.url">jdbc:hsqldb:hsql://localhost</property>
<propertyname="connection.username">sa</property>
<propertyname="connection.password"></property>
<!-- JDBCconnection pool (use the built-in) -->
<propertyname="connection.pool_size">1</property>
<propertyname="dialect">org.hibernate.dialect.HSQLDialect</property>
<!-- EnableHibernate's automatic session context management -->
<propertyname="current_session_context_class">thread</property>
<!-- Disablethe second-level cache -->
<propertyname="cache.provider_class">org.hibernate.cache.NoCacheProvider</property>
<!-- Echo allexecuted SQL to stdout -->
<propertyname="show_sql">true</property>
<!-- Drop andre-create the database schema on startup -->
<propertyname="hbm2ddl.auto">create</property>
<mappingresource="events/Event.hbm.xml"/>
把这个文件拷贝到源代码目录下面,这样它就位于classpath的根目录的最后。Hibernate在启动时会自动在classpath的根目录查找名为hibernate.cfg.xml的配置文件。
<project name="hibernate-tutorial"default="compile">
<propertyname="sourcedir" value="${basedir}/src"/>
<propertyname="targetdir" value="${basedir}/bin"/>
<propertyname="librarydir" value="${basedir}/lib"/>
<targetname="compile" depends="clean, copy-resources">
[copy] Copying 2files to C:\hibernateTutorial\bin
[javac] Compiling 1source file to C:\hibernateTutorial\bin
我们将创建一个HibernateUtil辅助类(helper class)来负责启动Hibernate和更方便地操作SessionFactory。让我们来看一下它的实现:
private static finalSessionFactory sessionFactory;
// Create theSessionFactory from hibernate.cfg.xml
sessionFactory= new Configuration().configure().buildSessionFactory();
// Make sureyou log the exception, as it might be swallowed
System.err.println("Initial SessionFactory creation failed." +ex);
throw newExceptionInInitializerError(ex);
public staticSessionFactory getSessionFactory() {
把HibernateUtil.java放在开发目录的源代码路径下,与放events的包并列:
<Hibernate andthird-party libraries>
示例的基本框架完成了-现在我们可以用Hibernate来做些真正的工作。
我们终于可以使用Hibernate来加载和存储对象了,编写一个带有main()方法的EventManager类:
public static voidmain(String[] args) {
EventManager mgr =new EventManager();
mgr.createAndStoreEvent("My Event", new Date());
HibernateUtil.getSessionFactory().close();
private voidcreateAndStoreEvent(String title, Date theDate) {
Session session =HibernateUtil.getSessionFactory().getCurrentSession();
session.getTransaction().commit();
关于事务处理及事务边界界定的详细信息,请参看第11章事务和并发。在上面的例子中,我们也忽略了所有的错误与回滚的处理。
为第一次运行我们的程序,我们得在Ant的build文件中增加一个可以调用得到的target。
<target name="run" depends="compile">
<javafork="true" classname="events.EventManager"classpathref="libraries">
<classpathpath="${targetdir}"/>
action参数(argument)的值是通过命令行调用这个target的时候设置的:
C:\hibernateTutorial\>ant run -Daction=store
你应该会看到,编译以后,Hibernate根据你的配置启动,并产生一大堆的输出日志。在日志最后你会看到下面这行:
[java] Hibernate: insert into EVENTS (EVENT_DATE, title,EVENT_ID) values (?, ?, ?)
这是Hibernate执行的INSERT命令,问号代表JDBC的绑定参数。如果想要看到绑定参数的值或者减少日志的长度,就要调整你在log4j.properties文件里的设置。
我们想要列出所有已经被存储的events,就要增加一个条件分支选项到main方法中去。
if (args[0].equals("store")) {
mgr.createAndStoreEvent("My Event", new Date());
else if (args[0].equals("list")) {
List events =mgr.listEvents();
for (int i = 0; i <events.size(); i++) {
Event theEvent =(Event) events.get(i);
System.out.println("Event: " + theEvent.getTitle() +
" Time: " + theEvent.getDate());
Session session =HibernateUtil.getSessionFactory().getCurrentSession();
List result =session.createQuery("from Event").list();
session.getTransaction().commit();
- 运行ant run -Daction=store来保存一些内容到数据库。当然,先得用hbm2ddl来生成数据库schema。
- 现在把hibernate.cfg.xml文件中hbm2ddl属性注释掉,这样我们就取消了在启动时用hbm2ddl来生成数据库schema。通常只有在不断重复进行单元测试的时候才需要打开它,但再次运行hbm2ddl会把你保存的一切都删掉(drop)——create配置的真实含义是:“在创建SessionFactory的时候,从schema 中drop 掉所有的表,再重新创建它们”。
如果你现在使用命令行参数-Daction=list运行Ant,你会看到那些至今为止我们所储存的events。当然,你也可以多调用几次store以保存更多的envents。
// Accessor methodsfor all properties, private setter for 'id'
创建一个名为Person.hbm.xml的新映射文件(别忘了最上面的DTD引用):
<classname="events.Person" table="PERSON">
<idname="id" column="PERSON_ID">
<mapping resource="events/Event.hbm.xml"/>
<mapping resource="events/Person.hbm.xml"/>
我们需要用set 实现一个单向多值关联。让我们在Java类里为这个关联编码,接着映射它:
private Set events =new HashSet();
public voidsetEvents(Set events) {
<class name="events.Person"table="PERSON">
<idname="id" column="PERSON_ID">
<setname="events" table="PERSON_EVENT">
<many-to-manycolumn="EVENT_ID" class="events.Event"/>
_____________ __________________
| EVENTS | | PERSON_EVENT | | |
|_____________| |__________________| | PERSON |
| *EVENT_ID | <--> | *EVENT_ID | | |
| EVENT_DATE | | *PERSON_ID | <--> | *PERSON_ID |
| TITLE | |__________________| | AGE |
我们把一些people和events一起放到EventManager的新方法中:
private void addPersonToEvent(Long personId, Long eventId) {
Session session =HibernateUtil.getSessionFactory().getCurrentSession();
Person aPerson =(Person) session.load(Person.class, personId);
Event anEvent =(Event) session.load(Event.class, eventId);
aPerson.getEvents().add(anEvent);
session.getTransaction().commit();
private void addPersonToEvent(Long personId, Long eventId) {
Session session =HibernateUtil.getSessionFactory().getCurrentSession();
Person aPerson =(Person) session
.createQuery("select p from Person p left join fetch p.events wherep.id = :pid")
.setParameter("pid", personId)
.uniqueResult(); // Eager fetch the collection so we can use it detached
Event anEvent =(Event) session.load(Event.class, eventId);
session.getTransaction().commit();
aPerson.getEvents().add(anEvent); // aPerson (and its collection) isdetached
Session session2 =HibernateUtil.getSessionFactory().getCurrentSession();
session2.update(aPerson); // Reattachment of aPerson
session2.getTransaction().commit();
对update的调用使一个脱管对象重新持久化,你可以说它被绑定到一个新的单元操作上,所以在脱管状态下对它所做的任何修改都会被保存到数据库里。这也包括你对这个实体对象的集合所作的任何改动(增加/删除)。
else if (args[0].equals("addpersontoevent")) {
Long eventId =mgr.createAndStoreEvent("My Event", new Date());
Long personId =mgr.createAndStorePerson("Foo", "Bar");
mgr.addPersonToEvent(personId, eventId);
System.out.println("Added person " + personId + " toevent " + eventId);
你也可以设计一个值类型的集合,这在概念上与引用其它实体的集合有很大的不同,但是在Java里面看起来几乎是一样的。
我们把一个值类型对象的集合加入Person实体中。我们希望保存email地址,所以使用String类型,而且这次的集合类型又是Set:
private Set emailAddresses = new HashSet();
public Set getEmailAddresses() {
public void setEmailAddresses(Set emailAddresses) {
this.emailAddresses =emailAddresses;
<set name="emailAddresses" table="PERSON_EMAIL_ADDR">
<elementtype="string" column="EMAIL_ADDR"/>
_____________ __________________
| EVENTS | | PERSON_EVENT | | | ___________________
|_____________| |__________________| | PERSON | | |
| | | | |_____________| | PERSON_EMAIL_ADDR |
| *EVENT_ID | <--> | *EVENT_ID | | | |___________________|
| EVENT_DATE | | *PERSON_ID | <--> | *PERSON_ID | <--> | *PERSON_ID |
| TITLE | |__________________| | AGE | | *EMAIL_ADDR |
|_____________| | FIRSTNAME | |___________________|
你可以看到集合表的主键实际上是个复合主键,同时使用了2个字段。这也暗示了对于同一个person不能有重复的email地址,这正是Java里面使用Set时候所需要的语义(Set里元素不能重复)。
你现在可以试着把元素加入到这个集合,就像我们在之前关联person和event的那样。其实现的Java代码是相同的:
private void addEmailToPerson(Long personId, StringemailAddress) {
Session session =HibernateUtil.getSessionFactory().getCurrentSession();
Person aPerson =(Person) session.load(Person.class, personId);
// ThegetEmailAddresses() might trigger a lazy load of the collection
aPerson.getEmailAddresses().add(emailAddress);
session.getTransaction().commit();
这次我们没有使用fetch查询来初始化集合。因此,调用其getter方法会触发另一附加的select来初始化集合,这样我们才能把元素添加进去。检查SQL log,试着通过预先抓取来优化它。
首先,把一个参与者(person)的集合加入Event类中:
private Set participants = new HashSet();
public Set getParticipants() {
public void setParticipants(Set participants) {
this.participants =participants;
<set name="participants"table="PERSON_EVENT" inverse="true">
<many-to-manycolumn="PERSON_ID" class="events.Person"/>
这意味着在需要的时候,Hibernate能在关联的另一端-Person类得到两个实体间关联的信息。这将会极大地帮助你理解双向关联是如何在两个实体间被创建的。
许多开发人员防御式地编程,创建管理关联的方法来保证正确的设置了关联的两端,比如在Person里:
protected void setEvents(Set events) {
public void addToEvent(Event event) {
event.getParticipants().add(this);
public void removeFromEvent(Event event) {
this.getEvents().remove(event);
event.getParticipants().remove(this);
1.4.第三部分 - EventManager web应用程序
public class EventManagerServlet extends HttpServlet {
private finalSimpleDateFormat dateFormatter =
new SimpleDateFormat("dd.MM.yyyy");
我们后面会用到dateFormatter的工具,它把Date对象转换为字符串。只要一个formatter作为servlet的成员就可以了。
这个servlet只处理HTTPGET请求,因此,我们要实现的是doGet()方法:
protected void doGet(HttpServletRequest request,
throwsServletException, IOException {
HibernateUtil.getSessionFactory()
.getCurrentSession().beginTransaction();
// Process requestand render page...
HibernateUtil.getSessionFactory()
.getCurrentSession().getTransaction().commit();
HibernateUtil.getSessionFactory()
.getCurrentSession().getTransaction().rollback();
throw newServletException(ex);
下一步,对请求的可能动作进行处理,渲染出反馈的HTML。我们很快就会涉及到那部分。
PrintWriter out = response.getWriter();
out.println("<html><head><title>EventManager</title></head><body>");
if ("store".equals(request.getParameter("action")) ) {
String eventTitle =request.getParameter("eventTitle");
String eventDate =request.getParameter("eventDate");
if ("".equals(eventTitle) || "".equals(eventDate) ) {
out.println("<b><i>Please enter event title anddate.</i></b>");
createAndStoreEvent(eventTitle, dateFormatter.parse(eventDate));
out.println("<b><i>Addedevent.</i></b>");
out.println("</body></html>");
private void printEventForm(PrintWriter out) {
out.println("<h2>Add new event:</h2>");
out.println("Title: <input name='eventTitle'length='50'/><br/>");
out.println("Date(e.g. 24.12.2009): <input name='eventDate' length='10'/><br/>");
out.println("<input type='submit' name='action'value='store'/>");
listEvents()方法使用绑定到当前线程的HibernateSession来执行查询:
private void listEvents(PrintWriter out) {
List result =HibernateUtil.getSessionFactory()
.getCurrentSession().createCriteria(Event.class).list();
out.println("<h2>Events in database:</h2>");
out.println("<table border='1'>");
out.println("<th>Event title</th>");
out.println("<th>Event date</th>");
for (Iterator it =result.iterator(); it.hasNext();) {
Event event =(Event) it.next();
out.println("<td>" + event.getTitle() +"</td>");
out.println("<td>" +dateFormatter.format(event.getDate()) + "</td>");
最后,store动作会被导向到createAndStoreEvent()方法,它也使用当前线程的Session:
protected void createAndStoreEvent(String title, Date theDate) {
HibernateUtil.getSessionFactory()
.getCurrentSession().save(theEvent);
要发布这个程序,你得把它打成web发布包:WAR文件。把下面的脚本加入到你的build.xml中:
<target name="war" depends="compile">
<wardestfile="hibernate-tutorial.war" webxml="web.xml">
这段代码在你的开发目录中创建一个hibernate-tutorial.war的文件。它把所有的类库和web.xml描述文件都打包进去,web.xml 文件应该位于你的开发根目录中:
<?xml version="1.0" encoding="UTF-8"?>
xmlns="http://java.sun.com/xml/ns/j2ee"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://java.sun.com/xml/ns/j2eehttp://java.sun.com/xml/ns/j2ee/web-app_2_4.xsd">
<servlet-name>Event Manager</servlet-name>
<servlet-class>events.EventManagerServlet</servlet-class>
<servlet-name>Event Manager</servlet-name>
<url-pattern>/eventmanager</url-pattern>
本章覆盖了如何编写一个简单独立的Hibernate命令行应用程序及小型的Hibernateweb应用程序的基本要素。
别忘了去Hibernate的网站查看更多(有针对性的)示例。
从这个图可以看出,Hibernate使用数据库和配置信息来为应用程序提供持久化服务(以及持久的对象)。
“全面解决”的体系结构方案,将应用层从底层的JDBC/JTA API中抽象出来,而让Hibernate来处理这些细节。
SessionFactory (org.hibernate.SessionFactory)
Session (org.hibernate.Session)
瞬态(transient)和脱管(detached)的对象及其集合
那些目前没有与session关联的持久化类实例。他们可能是在被应用程序实例化后,尚未进行持久化的对象。也可能是因为实例化他们的Session已经被关闭而脱离持久化的对象。
事务Transaction (org.hibernate.Transaction)
ConnectionProvider (org.hibernate.connection.ConnectionProvider)
(可选的)生成JDBC连接的工厂(同时也起到连接池的作用)。它通过抽象将应用从底层的Datasource或DriverManager隔离开。仅供开发者扩展/实现用,并不暴露给应用程序使用。
TransactionFactory (org.hibernate.TransactionFactory)
(可选的)生成Transaction对象实例的工厂。仅供开发者扩展/实现用,并不暴露给应用程序使用。
Hibernate提供了很多可选的扩展接口,你可以通过实现它们来定制你的持久层的行为。具体请参考API文档。
在特定“轻型”的体系结构中,应用程序可能绕过Transaction/TransactionFactory以及ConnectionProvider等API直接跟JTA或JDBC打交道。
该实例从未与任何持久化上下文关联过。它没有持久化标识(相当于主键值)。
想要看如何在JBoss应用服务器上将Hibernate部署为一个JMX服务的例子,您可以参考JBoss用户指南。我们现在说一下在Jboss应用服务器上,使用JMX来部署Hibernate的好处:
- Session管理: Hibernate的Session对象的生命周期可以 自动跟一个JTA事务边界绑定。这意味着你无需手工开关Session了, 这项 工作会由JBoss EJB 拦截器来完成。你再也不用担心你的代码中的事务边界了(除非你想利用Hibernate提供可选 的Transaction API来自己写一个便于移植的的持久层)。 你通过调用HibernateContext来访问Session。
- HAR 部署: 通常情况下,你会使用JBoss的服务部署描述符(在EAR或/和SAR文件中)来部署Hibernate JMX服务。 这种部署方式支持所有常见的Hibernate SessionFactory的配置选项。 不过,你仍需在部署描述符中,列出你所有的映射文件的名字。如果你使用HAR部署方式, JBoss 会自动探测出你的HAR文件中所有的映射文件。
将Hibernate以部署为JMX服务的另一个好处,是可以查看Hibernate的运行时统计信息。参看第3.4.6节“ Hibernate的统计(statistics)机制”.
Hibernate也可以被配置为一个JCA连接器(JCAconnector)。更多信息请参看网站。请注意,Hibernate对JCA的支持,仍处于实验性阶段。
- org.hibernate.context.JTASessionContext - 当前session根据JTA来跟踪和界定。这和以前的仅支持JTA的方法是完全一样的。详情请参阅Javadoc。
- org.hibernate.context.ThreadLocalSessionContext - 当前session通过当前执行的线程来跟踪和界定。详情也请参阅Javadoc。
你可以直接实例化Configuration来获取一个实例,并为它指定XML映射定义文件. 如果映射定义文件在类路径(classpath)中, 请使用addResource():
Configuration cfg = new Configuration()
一个替代方法(有时是更好的选择)是,指定被映射的类,让Hibernate帮你寻找映射定义文件:
Configuration cfg = new Configuration()
.addClass(org.hibernate.auction.Item.class)
.addClass(org.hibernate.auction.Bid.class);
Configuration cfg = new Configuration()
.addClass(org.hibernate.auction.Item.class)
.addClass(org.hibernate.auction.Bid.class)
.setProperty("hibernate.dialect","org.hibernate.dialect.MySQLInnoDBDialect")
.setProperty("hibernate.connection.datasource","java:comp/env/jdbc/test")
.setProperty("hibernate.order_updates", "true");
当然这不是唯一的传递Hibernate配置属性的方式, 其他可选方式还包括:
- 传一个java.util.Properties实例给 Configuration.setProperties().
- 将hibernate.properties放置在类路径(classpath)的根目录下 (root directory).
- 通过java -Dproperty=value来设置系统 (System)属性.
- 在hibernate.cfg.xml中加入元素 <property> (稍后讨论).
如果想尽快体验Hibernate,hibernate.properties是最简单的方式.
Configuration实例被设计成启动期间(startup-time)对象, 一旦SessionFactory创建完成它就被丢弃了.
当所有映射定义被Configuration解析后, 应用程序必须获得一个用于构造Session实例的工厂. 这个工厂将被应用程序的所有线程共享:
SessionFactory sessions = cfg.buildSessionFactory();
Hibernate允许你的应用程序创建多个SessionFactory实例. 这对使用多个数据库的应用来说很有用.
通常你希望SessionFactory来为你创建和缓存(pool)JDBC连接. 如果你采用这种方式, 只需要如下例所示那样,打开一个Session:
Session session = sessions.openSession(); // open a new Session
一旦你需要进行数据访问时, 就会从连接池(connectionpool)获得一个JDBC连接.
如果你设置如下属性,Hibernate将使用java.sql.DriverManager来获得(和缓存)JDBC连接 :
表3.1. Hibernate JDBC属性
属性名 |
用途 |
hibernate.connection.driver_class |
jdbc驱动类 |
hibernate.connection.url |
jdbc URL |
hibernate.connection.username |
数据库用户 |
hibernate.connection.password |
数据库用户密码 |
hibernate.connection.pool_size |
连接池容量上限数目 |
但Hibernate自带的连接池算法相当不成熟.它只是为了让你快些上手,并不适合用于产品系统或性能测试中。出于最佳性能和稳定性考虑你应该使用第三方的连接池。只需要用特定连接池的设置替换hibernate.connection.pool_size即可。这将关闭Hibernate自带的连接池. 例如, 你可能会想用C3P0.
C3P0是一个随Hibernate一同分发的开源的JDBC连接池, 它位于lib目录下。如果你设置了hibernate.c3p0.*相关的属性, Hibernate将使用C3P0ConnectionProvider来缓存JDBC连接. 如果你更原意使用Proxool, 请参考发行包中的hibernate.properties并到Hibernate网站获取更多的信息.
这是一个使用C3P0的hibernate.properties样例文件:
hibernate.connection.driver_class= org.postgresql.Driver
hibernate.connection.url =jdbc:postgresql://localhost/mydatabase
hibernate.connection.username = myuser
hibernate.connection.password = secret
hibernate.c3p0.min_size=5
hibernate.c3p0.max_size=20
hibernate.c3p0.timeout=1800
hibernate.c3p0.max_statements=50
hibernate.dialect = org.hibernate.dialect.PostgreSQLDialect
为了能在应用程序服务器(application server)中使用Hibernate, 应当总是将Hibernate配置成从注册在JNDI中的Datasource处获得连接,你至少需要设置下列属性中的一个:
表3.2. Hibernate数据源属性
属性名 |
用途 |
hibernate.connection.datasource |
数据源JNDI名字 |
hibernate.jndi.url |
JNDI提供者的URL (可选) |
hibernate.jndi.class |
JNDI InitialContextFactory类 (可选) |
hibernate.connection.username |
数据库用户 (可选) |
hibernate.connection.password |
数据库用户密码 (可选) |
这是一个使用应用程序服务器提供的JNDI数据源的hibernate.properties样例文件:
hibernate.connection.datasource = java:/comp/env/jdbc/test
hibernate.transaction.factory_class = \
org.hibernate.transaction.JTATransactionFactory
hibernate.transaction.manager_lookup_class = \
org.hibernate.transaction.JBossTransactionManagerLookup
hibernate.dialect = org.hibernate.dialect.PostgreSQLDialect
从JNDI数据源获得的JDBC连接将自动参与到应用程序服务器中容器管理的事务(container-managed transactions)中去.
任何连接(connection)属性的属性名都要以"hibernate.connnection"开头. 例如, 你可能会使用hibernate.connection.charSet来指定字符集charSet.
通过实现org.hibernate.connection.ConnectionProvider接口,你可以定义属于你自己的获得JDBC连接的插件策略。通过设置hibernate.connection.provider_class,你可以选择一个自定义的实现.
有大量属性能用来控制Hibernate在运行期的行为. 它们都是可选的, 并拥有适当的默认值.
表3.3. Hibernate配置属性
属性名 |
用途 |
hibernate.dialect |
一个Hibernate Dialect类名允许Hibernate针对特定的关系数据库生成优化的SQL. 取值 full.classname.of.Dialect |
hibernate.show_sql |
输出所有SQL语句到控制台. 有一个另外的选择是把org.hibernate.SQL这个log category设为debug。 eg. true | false |
hibernate.format_sql |
在log和console中打印出更漂亮的SQL。 取值 true | false |
hibernate.default_schema |
在生成的SQL中, 将给定的schema/tablespace附加于非全限定名的表名上. 取值 SCHEMA_NAME |
hibernate.default_catalog |
在生成的SQL中, 将给定的catalog附加于非全限定名的表名上. 取值 CATALOG_NAME |
hibernate.session_factory_name |
SessionFactory创建后,将自动使用这个名字绑定到JNDI中. 取值 jndi/composite/name |
hibernate.max_fetch_depth |
为单向关联(一对一, 多对一)的外连接抓取(outer join fetch)树设置最大深度. 值为0意味着将关闭默认的外连接抓取. 取值 建议在0到3之间取值 |
hibernate.default_batch_fetch_size |
为Hibernate关联的批量抓取设置默认数量. 取值 建议的取值为4, 8, 和16 |
hibernate.default_entity_mode |
为由这个SessionFactory打开的所有Session指定默认的实体表现模式. 取值 dynamic-map, dom4j, pojo |
hibernate.order_updates |
强制Hibernate按照被更新数据的主键,为SQL更新排序。这么做将减少在高并发系统中事务的死锁。 取值 true | false |
hibernate.generate_statistics |
如果开启, Hibernate将收集有助于性能调节的统计数据. 取值 true | false |
hibernate.use_identifer_rollback |
如果开启, 在对象被删除时生成的标识属性将被重设为默认值. 取值 true | false |
hibernate.use_sql_comments |
如果开启, Hibernate将在SQL中生成有助于调试的注释信息, 默认值为false. 取值 true | false |
表3.4. Hibernate JDBC和连接(connection)属性
属性名 |
用途 |
hibernate.jdbc.fetch_size |
非零值,指定JDBC抓取数量的大小 (调用Statement.setFetchSize()). |
hibernate.jdbc.batch_size |
非零值,允许Hibernate使用JDBC2的批量更新. 取值 建议取5到30之间的值 |
hibernate.jdbc.batch_versioned_data |
如果你想让你的JDBC驱动从executeBatch()返回正确的行计数 , 那么将此属性设为true(开启这个选项通常是安全的). 同时,Hibernate将为自动版本化的数据使用批量DML. 默认值为false. eg. true | false |
hibernate.jdbc.factory_class |
选择一个自定义的Batcher. 多数应用程序不需要这个配置属性. eg. classname.of.Batcher |
hibernate.jdbc.use_scrollable_resultset |
允许Hibernate使用JDBC2的可滚动结果集. 只有在使用用户提供的JDBC连接时,这个选项才是必要的, 否则Hibernate会使用连接的元数据. 取值 true | false |
hibernate.jdbc.use_streams_for_binary |
在JDBC读写binary (二进制)或serializable (可序列化) 的类型时使用流(stream)(系统级属性). 取值 true | false |
hibernate.jdbc.use_get_generated_keys |
在数据插入数据库之后,允许使用JDBC3PreparedStatement.getGeneratedKeys() 来获取数据库生成的key(键)。需要JDBC3+驱动和JRE1.4+, 如果你的数据库驱动在使用Hibernate的标 识生成器时遇到问题,请将此值设为false. 默认情况下将使用连接的元数据来判定驱动的能力. 取值 true|false |
hibernate.connection.provider_class |
自定义ConnectionProvider的类名, 此类用来向Hibernate提供JDBC连接. 取值 classname.of.ConnectionProvider |
hibernate.connection.isolation |
设置JDBC事务隔离级别. 查看java.sql.Connection来了解各个值的具体意义, 但请注意多数数据库都不支持所有的隔离级别. 取值 1, 2, 4, 8 |
hibernate.connection.autocommit |
允许被缓存的JDBC连接开启自动提交(autocommit) (不建议). 取值 true | false |
hibernate.connection.release_mode |
指定Hibernate在何时释放JDBC连接. 默认情况下,直到Session被显式关闭或被断开连接时,才会释放JDBC连接. 对于应用程序服务器的JTA数据源, 你应当使用after_statement, 这样在每次JDBC调用后,都会主动的释放连接. 对于非JTA的连接, 使用after_transaction在每个事务结束时释放连接是合理的. auto将为JTA和CMT事务策略选择after_statement, 为JDBC事务策略选择after_transaction. 取值 on_close | after_transaction | after_statement | auto |
hibernate.connection.<propertyName> |
将JDBC属性propertyName传递到DriverManager.getConnection()中去. |
hibernate.jndi.<propertyName> |
将属性propertyName传递到JNDI InitialContextFactory中去. |
表3.5. Hibernate缓存属性
属性名 |
用途 |
hibernate.cache.provider_class |
自定义的CacheProvider的类名. 取值 classname.of.CacheProvider |
hibernate.cache.use_minimal_puts |
以频繁的读操作为代价, 优化二级缓存来最小化写操作. 在Hibernate3中,这个设置对的集群缓存非常有用, 对集群缓存的实现而言,默认是开启的. 取值 true|false |
hibernate.cache.use_query_cache |
允许查询缓存, 个别查询仍然需要被设置为可缓存的. 取值 true|false |
hibernate.cache.use_second_level_cache |
能用来完全禁止使用二级缓存. 对那些在类的映射定义中指定<cache>的类,会默认开启二级缓存. 取值 true|false |
hibernate.cache.query_cache_factory |
自定义实现QueryCache接口的类名, 默认为内建的StandardQueryCache. 取值 classname.of.QueryCache |
hibernate.cache.region_prefix |
二级缓存区域名的前缀. 取值 prefix |
hibernate.cache.use_structured_entries |
强制Hibernate以更人性化的格式将数据存入二级缓存. 取值 true|false |
表3.6. Hibernate事务属性
属性名 |
用途 |
hibernate.transaction.factory_class |
一个TransactionFactory的类名, 用于Hibernate TransactionAPI (默认为JDBCTransactionFactory). 取值 classname.of.TransactionFactory |
jta.UserTransaction |
一个JNDI名字,被JTATransactionFactory用来从应用服务器获取JTA UserTransaction. 取值 jndi/composite/name |
hibernate.transaction.manager_lookup_class |
一个TransactionManagerLookup的类名 - 当使用JVM级缓存,或在JTA环境中使用hilo生成器的时候需要该类. 取值 classname.of.TransactionManagerLookup |
hibernate.transaction.flush_before_completion |
如果开启, session在事务完成后将被自动清洗(flush)。 现在更好的方法是使用自动session上下文管理。请参见第 2.5节 “上下文相关的(Contextual)Session”。 取值 true | false |
hibernate.transaction.auto_close_session |
如果开启, session在事务完成后将被自动关闭。 现在更好的方法是使用自动session上下文管理。请参见第 2.5节 “上下文相关的(Contextual)Session”。 取值 true | false |
表3.7. 其他属性
属性名 |
用途 |
hibernate.current_session_context_class |
为"当前" Session指定一个(自定义的)策略。关于内置策略的详情,请参见第 2.5节 “上下文相关的(Contextual)Session” 。 eg. jta | thread | custom.Class |
hibernate.query.factory_class |
选择HQL解析器的实现. 取值 org.hibernate.hql.ast.ASTQueryTranslatorFactory ororg.hibernate.hql.classic.ClassicQueryTranslatorFactory |
hibernate.query.substitutions |
将Hibernate查询中的符号映射到SQL查询中的符号 (符号可能是函数名或常量名字). 取值 hqlLiteral=SQL_LITERAL, hqlFunction=SQLFUNC |
hibernate.hbm2ddl.auto |
在SessionFactory创建时,自动检查数据库结构,或者将数据库schema的DDL导出到数据库. 使用 create-drop时,在显式关闭SessionFactory时,将drop掉数据库schema. 取值 validate | update | create | create-drop |
hibernate.cglib.use_reflection_optimizer |
开启CGLIB来替代运行时反射机制(系统级属性). 反射机制有时在除错时比较有用. 注意即使关闭这个优化, Hibernate还是需要CGLIB. 你不能在hibernate.cfg.xml中设置此属性. 取值 true | false |
表3.8. Hibernate SQL方言 (hibernate.dialect)
RDBMS |
方言 |
DB2 |
org.hibernate.dialect.DB2Dialect |
DB2 AS/400 |
org.hibernate.dialect.DB2400Dialect |
DB2 OS390 |
org.hibernate.dialect.DB2390Dialect |
PostgreSQL |
org.hibernate.dialect.PostgreSQLDialect |
MySQL |
org.hibernate.dialect.MySQLDialect |
MySQL with InnoDB |
org.hibernate.dialect.MySQLInnoDBDialect |
MySQL with MyISAM |
org.hibernate.dialect.MySQLMyISAMDialect |
Oracle (any version) |
org.hibernate.dialect.OracleDialect |
Oracle 9i/10g |
org.hibernate.dialect.Oracle9Dialect |
Sybase |
org.hibernate.dialect.SybaseDialect |
Sybase Anywhere |
org.hibernate.dialect.SybaseAnywhereDialect |
Microsoft SQL Server |
org.hibernate.dialect.SQLServerDialect |
SAP DB |
org.hibernate.dialect.SAPDBDialect |
Informix |
org.hibernate.dialect.InformixDialect |
HypersonicSQL |
org.hibernate.dialect.HSQLDialect |
Ingres |
org.hibernate.dialect.IngresDialect |
Progress |
org.hibernate.dialect.ProgressDialect |
Mckoi SQL |
org.hibernate.dialect.MckoiDialect |
Interbase |
org.hibernate.dialect.InterbaseDialect |
Pointbase |
org.hibernate.dialect.PointbaseDialect |
FrontBase |
org.hibernate.dialect.FrontbaseDialect |
Firebird |
org.hibernate.dialect.FirebirdDialect |
3.4.2. 外连接抓取(Outer Join Fetching)
参见第19.1节“抓取策略(Fetching strategies) ”获得更多信息.
你可以使用hibernate.query.substitutions在Hibernate中定义新的查询符号. 例如:
hibernate.query.substitutions true=1, false=0
将导致符号true和false在生成的SQL中被翻译成整数常量.
hibernate.query.substitutions toLowercase=LOWER
3.4.6. Hibernate的统计(statistics)机制
Hibernate使用Apache commons-logging来为各种事件记录日志.
我们强烈建议你熟悉一下Hibernate的日志消息. 在不失可读性的前提下,我们做了很多工作,使Hibernate的日志可能地详细. 这是必要的查错利器. 最令人感兴趣的日志分类有如下这些:
表3.9. Hibernate日志类别
类别 |
功能 |
org.hibernate.SQL |
在所有SQL DML语句被执行时为它们记录日志 |
org.hibernate.type |
为所有JDBC参数记录日志 |
org.hibernate.tool.hbm2ddl |
在所有SQL DDL语句执行时为它们记录日志 |
org.hibernate.pretty |
在session清洗(flush)时,为所有与其关联的实体(最多20个)的状态记录日志 |
org.hibernate.cache |
为所有二级缓存的活动记录日志 |
org.hibernate.transaction |
为事务相关的活动记录日志 |
org.hibernate.jdbc |
为所有JDBC资源的获取记录日志 |
org.hibernate.hql.AST |
在解析查询的时候,记录HQL和SQL的AST分析日志 |
org.hibernate.secure |
为JAAS认证请求做日志 |
org.hibernate |
为任何Hibernate相关信息做日志 (信息量较大, 但对查错非常有帮助) |
在使用Hibernate开发应用程序时, 你应当总是为org.hibernate.SQL开启debug级别的日志记录,或者开启hibernate.show_sql属性。
org.hibernate.cfg.NamingStrategy接口允许你为数据库中的对象和schema 元素指定一个“命名标准”.
你可能会提供一些通过Java标识生成数据库标识或将映射定义文件中"逻辑"表/列名处理成"物理"表/列名的规则. 这个特性有助于减少冗长的映射定义文件.
在加入映射定义前,你可以调用Configuration.setNamingStrategy()指定一个不同的命名策略:
SessionFactory sf = new Configuration()
.setNamingStrategy(ImprovedNamingStrategy.INSTANCE)
org.hibernate.cfg.ImprovedNamingStrategy是一个内建的命名策略, 对一些应用程序而言,可能是非常有用的起点.
另一个配置方法是在hibernate.cfg.xml文件中指定一套完整的配置. 这个文件可以当成hibernate.properties的替代。若两个文件同时存在,它将覆盖前者的属性.
XML配置文件被默认是放在CLASSPATH的根目录下. 这是一个例子:
<?xml version='1.0' encoding='utf-8'?>
<!DOCTYPE hibernate-configuration PUBLIC
"-//Hibernate/Hibernate Configuration DTD//EN"
"http://hibernate.sourceforge.net/hibernate-configuration-3.0.dtd">
<!-- 以/jndi/name绑定到JNDI的SessionFactory实例 -->
name="java:hibernate/SessionFactory">
<property name="connection.datasource">java:/comp/env/jdbc/MyDB</property>
<propertyname="dialect">org.hibernate.dialect.MySQLDialect</property>
<propertyname="show_sql">false</property>
<propertyname="transaction.factory_class">
org.hibernate.transaction.JTATransactionFactory
<propertyname="jta.UserTransaction">java:comp/UserTransaction</property>
<mappingresource="org/hibernate/auction/Item.hbm.xml"/>
<mappingresource="org/hibernate/auction/Bid.hbm.xml"/>
<class-cacheclass="org.hibernate.auction.Item" usage="read-write"/>
<class-cacheclass="org.hibernate.auction.Bid" usage="read-only"/>
<collection-cache collection="org.hibernate.auction.Item.bids"usage="read-write"/>
使用XML配置,使得启动Hibernate变的异常简单, 如下所示,一行代码就可以搞定:
SessionFactory sf = newConfiguration().configure().buildSessionFactory();
SessionFactory sf = new Configuration()
org.hibernate.transaction.JDBCTransactionFactory
org.hibernate.transaction.JTATransactionFactory
如果在上下文环境中存在运行着的事务(如, EJB会话Bean的方法), 则委托给容器管理的事务, 否则,将启动一个新的事务,并使用Bean管理的事务.
org.hibernate.transaction.CMTTransactionFactory
你也可以定义属于你自己的事务策略 (如, 针对CORBA的事务服务)
表3.10. JTATransactionManagers
Transaction工厂类 |
应用程序服务器 |
org.hibernate.transaction.JBossTransactionManagerLookup |
JBoss |
org.hibernate.transaction.WeblogicTransactionManagerLookup |
Weblogic |
org.hibernate.transaction.WebSphereTransactionManagerLookup |
WebSphere |
org.hibernate.transaction.WebSphereExtendedJTATransactionLookup |
WebSphere 6 |
org.hibernate.transaction.OrionTransactionManagerLookup |
Orion |
org.hibernate.transaction.ResinTransactionManagerLookup |
Resin |
org.hibernate.transaction.JOTMTransactionManagerLookup |
JOTM |
org.hibernate.transaction.JOnASTransactionManagerLookup |
JOnAS |
org.hibernate.transaction.JRun4TransactionManagerLookup |
JRun4 |
org.hibernate.transaction.BESTransactionManagerLookup |
Borland ES |
假若你使用JNDISessionFactory,EJB或者任何其它类都可以从JNDI中找到此SessionFactory。
3.8.3.在JTA环境下使用CurrentSession context (当前session上下文)管理
<mbean code="org.hibernate.jmx.HibernateService"
name="jboss.jca:service=HibernateFactory,name=HibernateFactory">
<depends>jboss.jca:service=RARDeployer</depends>
<depends>jboss.jca:service=LocalTxCM,name=HsqlDS</depends>
<attributename="JndiName">java:/hibernate/SessionFactory</attribute>
<attributename="Datasource">java:HsqlDS</attribute>
<attributename="Dialect">org.hibernate.dialect.HSQLDialect</attribute>
<attributename="TransactionStrategy">
org.hibernate.transaction.JTATransactionFactory</attribute>
<attribute name="TransactionManagerLookupStrategy">
org.hibernate.transaction.JBossTransactionManagerLookup</attribute>
<attributename="FlushBeforeCompletionEnabled"&tt;true</attribute>
<attributename="AutoCloseSessionEnabled">true</attribute>
<attributename="MaximumFetchDepth">5</attribute>
<attributename="SecondLevelCacheEnabled">true</attribute>
<attributename="CacheProviderClass">org.hibernate.cache.EhCacheProvider</attribute>
<attribute name="QueryCacheEnabled">true</attribute>
<attributename="ShowSqlEnabled">true</attribute>
<attributename="MapResources">auction/Item.hbm.xml,auction/Category.hbm.xml</attribute>
在应用程序中,用来实现业务问题实体的(如,在电子商务应用程序中的Customer和Order)类就是持久化类。不能认为所有的持久化类的实例都是持久的状态——一个实例的状态也可能是瞬时的或脱管的。
private Set kittens =new HashSet();
// addKitten notneeded by Hibernate
public voidaddKitten(Cat kitten) {
kitten.setLitterId(kittens.size() );
4.1.1.实现一个默认的(即无参数的)构造方法(constructor)
4.1.2.提供一个标识属性(identifier property)(可选)
标识符属性是可选的。可以不用管它,让Hibernate内部来追踪对象的识别。但是我们并不推荐这样做。
- 托管对象的传播性再连接(级联更新或级联合并) ——参阅 第10.11节“传播性持久化(transitive persistence)”
- Session.saveOrUpdate()
- Session.merge()
我们建议你对持久化类声明命名一致的标识属性。我们还建议你使用一个可以为空(也就是说,不是原始类型)的类型。
代理(proxies)是Hibernate的一个重要的功能,它依赖的条件是,持久化类或者是非final的,或者是实现了一个所有方法都声明为public的接口。
你可以用Hibernate持久化一个没有实现任何接口的final类,但是你不能使用代理来延迟关联加载,这会限制你进行性能优化的选择。
你也应该避免在非final类中声明publicfinal的方法。如果你想使用一个有publicfinal方法的类,你必须通过设置lazy="false"来明确地禁用代理。
4.1.4.为持久化字段声明访问器(accessors)和是否可变的标志(mutators)(可选)
属性不需要要声明为public的。Hibernate可以持久化一个有default、protected或private的get/set方法对的属性进行持久化。
子类也必须遵守第一条和第二条规则。它从超类Cat继承了标识属性。
public class DomesticCat extends Cat {
protected voidsetName(String name) {
如果你有如下需求,你必须重载equals()和hashCode()方法:
public booleanequals(Object other) {
if (this == other)return true;
if ( !(otherinstanceof Cat) ) return false;
if (!cat.getLitterId().equals( getLitterId() ) ) return false;
if (!cat.getMother().equals( getMother() ) ) return false;
result =getMother().hashCode();
result = 29 *result + getLitterId();
注意,业务键不必像数据库的主键那样固定不变(参见第11.1.3节“关注对象标识(Considering object identity)”)。对业务键而言,不可变或唯一的属性是不错的选择。
下面是用Map来表示的例子。首先,在映射文件中,要声明entity-name来代替一个类名(或作为一种附属)。
<many-to-onename="organization"
注意,虽然是用目标类名来声明关联的,但是关联的目标类型除了是POJO之外,也可以是一个动态的实体。
在使用dynamic-map为SessionFactory设置了默认的实体模式之后,可以在运行期使用Map的Map。
Transaction tx = s.beginTransaction();
foobar.put("name", "Foobar Inc.");
david.put("organization", foobar);
s.save("Organization", foobar);
Session dynamicSession = pojoSession.getSession(EntityMode.MAP);
dynamicSession.save("Customer", david);
关于XML表示能力的更多信息可以在第18章XML映射中找到。
Override thedynamic-map entity-mode
tuplizer forthe customer entity
<tuplizerentity-mode="dynamic-map"
class="CustomMapTuplizerImpl"/>
<idname="id" type="long" column="ID">
public class CustomMapTuplizerImpl
extendsorg.hibernate.tuple.DynamicMapEntityTuplizer {
// override thebuildInstantiator() method to plug in our custom map...
protected finalInstantiator buildInstantiator(
org.hibernate.mapping.PersistentClass mappingInfo) {
return newCustomMapInstantiator( mappingInfo );
private static finalclass CustomMapInstantiator
extendsorg.hibernate.tuple.DynamicMapInstantitor {
// override thegenerateMap() method to return our custom map...
protected final Map generateMap() {
TODO:property和proxy包里的用户扩展框架文档。
第5章对象/关系数据库映射基础(Basic O/R Mapping)
请注意,虽然很多Hibernate用户选择手写XML映射文档,但也有一些工具可以用来生成映射文档,包括XDoclet,Middlegen和AndroMDA。
<?xmlversion="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="eg">
<classname="Cat"
table="cats"
discriminator-value="C">
<idname="id">
<generator class="native"/>
</id>
<discriminator column="subclass"
type="character"/>
<property name="weight"/>
<property name="birthdate"
type="date"
not-null="true"
update="false"/>
<property name="color"
type="eg.types.ColorUserType"
not-null="true"
update="false"/>
<property name="sex"
not-null="true"
update="false"/>
<property name="litterId"
column="litterId"
update="false"/>
<many-to-one name="mother"
column="mother_id"
update="false"/>
<setname="kittens"
inverse="true"
order-by="litter_id">
<key column="mother_id"/>
<one-to-many class="Cat"/>
</set>
<subclass name="DomesticCat"
discriminator-value="D">
<property name="name"
type="string"/>
</subclass>
</class>
<classname="Dog">
<!--mapping for Dog could go here -->
</class>
</hibernate-mapping>
我们现在开始讨论映射文档的内容。我们只描述Hibernate在运行时用到的文档元素和属性。映射文档还包括一些额外的可选属性和元素,它们在使用schema导出工具的时候会影响导出的数据库schema结果。(比如,not-null属性。)
default-cascade="cascade_style" (3)
default-access="field|property|ClassName" (4)
(1) |
schema (可选): 数据库schema的名称。 |
(2) |
catalog (可选): 数据库catalog的名称。 |
(3) |
default-cascade (可选 - 默认为 none): 默认的级联风格。 |
(4) |
default-access (可选 - 默认为 property): Hibernate用来访问所有属性的策略。可以通过实现PropertyAccessor接口 自定义。 |
(5) |
default-lazy (可选 - 默认为 true): 指定了未明确注明lazy属性的Java属性和集合类, Hibernate会采取什么样的默认加载风格。 |
(6) |
auto-import (可选 - 默认为 true): 指定我们是否可以在查询语言中使用非全限定的类名(仅限于本映射文件中的类)。 |
(7) |
package (可选): 指定一个包前缀,如果在映射文档中没有指定全限定的类名, 就使用这个作为包名。 |
discriminator-value="discriminator_value" (3)
dynamic-update="true|false" (8)
dynamic-insert="true|false" (9)
select-before-update="true|false" (10)
polymorphism="implicit|explicit" (11)
where="arbitrary sql where condition" (12)
persister="PersisterClass" (13)
optimistic-lock="none|version|dirty|all" (15)
check="arbitrary sql check condition" (18)
subselect="SQL expression" (20)
(1) |
name (可选): 持久化类(或者接口)的Java全限定名。 如果这个属性不存在,Hibernate将假定这是一个非POJO的实体映射。 |
(2) |
table (可选 - 默认是类的非全限定名): 对应的数据库表名。 |
(3) |
discriminator-value (可选 - 默认和类名一样): 一个用于区分不同的子类的值,在多态行为时使用。它可以接受的值包括 null 和 not null。 |
(4) |
mutable (可选,默认值为true): 表明该类的实例是可变的或者不可变的。 |
(5) |
schema (可选): 覆盖在根<hibernate-mapping>元素中指定的schema名字。 |
(6) |
catalog (可选): 覆盖在根<hibernate-mapping>元素中指定的catalog名字。 |
(7) |
proxy (可选): 指定一个接口,在延迟装载时作为代理使用。 你可以在这里使用该类自己的名字。 |
(8) |
dynamic-update (可选, 默认为 false): 指定用于UPDATE 的SQL将会在运行时动态生成,并且只更新那些改变过的字段。 |
(9) |
dynamic-insert (可选, 默认为 false): 指定用于INSERT的 SQL 将会在运行时动态生成,并且只包含那些非空值字段。 |
(10) |
select-before-update (可选, 默认为 false): 指定Hibernate除非确定对象真正被修改了(如果该值为true-译注),否则不会执行SQL UPDATE操作。在特定场合(实际上,它只在一个瞬时对象(transient object)关联到一个 新的session中时执行的update()中生效),这说明Hibernate会在UPDATE 之前执行一次额外的SQLSELECT操作,来决定是否应该执行 UPDATE。 |
(11) |
polymorphism(多态) (可选, 默认值为 implicit (隐式) ): 界定是隐式还是显式的使用多态查询(这只在Hibernate的具体表继承策略中用到-译注)。 |
(12) |
where (可选) 指定一个附加的SQLWHERE 条件, 在抓取这个类的对象时会一直增加这个条件。 |
(13) |
persister (可选): 指定一个定制的ClassPersister。 |
(14) |
batch-size (可选,默认是1) 指定一个用于 根据标识符(identifier)抓取实例时使用的"batch size"(批次抓取数量)。 |
(15) |
optimistic-lock(乐观锁定) (可选,默认是version): 决定乐观锁定的策略。 |
(16) |
lazy (可选): 通过设置lazy="false", 所有的延迟加载(Lazy fetching)功能将被全部禁用(disabled)。 |
(17) |
entity-name (可选,默认为类名): Hibernate3允许一个类进行多次映射( 前提是映射到不同的表),并且允许使用Maps或XML代替Java层次的实体映射 (也就是实现动态领域模型,不用写持久化类-译注)。 更多信息请看第 4.4节 “动态模型(Dynamic models)” and 第 18章XML映射。 |
(18) |
check (可选): 这是一个SQL表达式, 用于为自动生成的schema添加多行(multi-row)约束检查。 |
(19) |
rowid (可选): Hibernate可以使用数据库支持的所谓的ROWIDs,例如: Oracle数据库,如果你设置这个可选的rowid, Hibernate可以使用额外的字段rowid实现快速更新。ROWID是这个功能实现的重点, 它代表了一个存储元组(tuple)的物理位置。 |
(20) |
subselect (可选): 它将一个不可变(immutable)并且只读的实体映射到一个数据库的 子查询中。当你想用视图代替一张基本表的时候,这是有用的,但最好不要这样做。更多的介绍请看下面内容。 |
(21) |
abstract (可选): 用于在<union-subclass>的继承结构 (hierarchies)中标识抽象超类。 |
不可变类,mutable="false"不可以被应用程序更新或者删除。这可以让Hibernate做一些小小的性能优化。
使用select-before-update通常会降低性能。如果你重新连接一个脱管(detache)对象实例到一个Session中时,它可以防止数据库不必要的触发update。这就很有用了。
如果你打开了dynamic-update,你可以选择几种乐观锁定的策略:
select item.name,max(bid.amount), count(*)
join bid onbid.item_id = item.id
定义这个实体用到的表为同步(synchronize),确保自动刷新(auto-flush)正确执行,并且依赖原实体的查询不会返回过期数据。<subselect>在属性元素和一个嵌套映射元素中都可见。
被映射的类必须定义对应数据库表主键字段。大多数类有一个JavaBeans风格的属性,为每一个实例包含唯一的标识。<id>元素定义了该属性到数据库表主键字段的映射。
unsaved-value="null|any|none|undefined|id_value" (4)
access="field|property|ClassName" (5)
node="element-name|@attribute-name|element/@attribute|.">
<generatorclass="generatorClass"/>
(1) |
name (可选): 标识属性的名字。 |
(2) |
type (可选): 标识Hibernate类型的名字。 |
(3) |
column (可选 - 默认为属性名): 主键字段的名字。 |
(4) |
unsaved-value (可选 - 默认为一个切合实际(sensible)的值): 一个特定的标识属性值,用来标志该实例是刚刚创建的,尚未保存。 这可以把这种实例和从以前的session中装载过(可能又做过修改--译者注) 但未再次持久化的实例区分开来。 |
(5) |
access (可选 - 默认为property): Hibernate用来访问属性值的策略。 |
unsaved-value属性在Hibernate3中几乎不再需要。
还有一个另外的<composite-id>定义可以访问旧式的多主键数据。我们强烈不建议使用这种方式。
可选的<generator>子元素是一个Java类的名字,用来为该持久化类的实例生成唯一的标识。如果这个生成器实例需要某些配置值或者初始化参数,用<param>元素来传递。
<id name="id" type="long"column="cat_id">
<generatorclass="org.hibernate.id.TableHiLoGenerator">
<paramname="table">uid_table</param>
<paramname="column">next_hi_value_column</param>
用于为long,short或者int类型生成唯一标识。只有在没有其他进程往同一张表中插入数据时才能使用。在集群下不要使用。
对DB2,MySQL,MS SQL Server, Sybase和HypersonicSQL的内置标识字段提供支持。返回的标识符是long,short或者int类型的。
使用一个高/低位算法高效的生成long,short或者int类型的标识符。给定一个表和字段(默认分别是hibernate_unique_key和next_hi)作为高位值的来源。高/低位算法生成的标识符只在一个特定的数据库中是唯一的。
seqhilo
使用一个高/低位算法来高效的生成long,short或者int类型的标识符,给定一个数据库序列(sequence)的名字。
uuid
用一个128-bit的UUID算法生成字符串类型的标识符,这在一个网络中是唯一的(使用了IP地址)。UUID被编码为一个32位16进制数字的字符串。
guid
在MSSQL Server 和 MySQL 中使用数据库生成的GUID字符串。
native
根据底层数据库的能力选择identity,sequence或者hilo中的一个。
assigned
让应用程序在save()之前为对象分配一个标示符。这是<generator>元素没有指定时的默认生成策略。
select
通过数据库触发器选择一些唯一主键的行并返回主键值来分配一个主键。
foreign
使用另外一个相关联的对象的标识符。通常和<one-to-one>联合起来使用。
5.1.4.2.高/低位算法(Hi/LoAlgorithm)
<id name="id" type="long"column="cat_id">
<paramname="table">hi_value</param>
<paramname="column">next_value</param>
<paramname="max_lo">100</param>
<id name="id" type="long"column="cat_id">
<paramname="sequence">hi_value</param>
<paramname="max_lo">100</param>
5.1.4.3. UUID算法(UUID Algorithm )
5.1.4.4.标识字段和序列(Identity columns and Sequences)
<id name="id" type="long"column="person_id">
<paramname="sequence">person_id_sequence</param>
<id name="id" type="long"column="person_id" unsaved-value="0">
对于跨平台开发,native策略会从identity,sequence和hilo中进行选择,选择哪一个,这取决于底层数据库的支持能力。
5.1.4.5.程序分配的标识符(Assigned Identifiers)
5.1.4.6.触发器实现的主键生成器(Primary keys assigned by triggers)
仅仅用于遗留的schema中(Hibernate不能使用触发器生成DDL)。
<id name="id" type="long"column="person_id">
<paramname="key">socialSecurityNumber</param>
access="field|property|ClassName"
<key-propertyname="propertyName" type="typename"column="column_name"/>
<key-many-to-one name="propertyName class="ClassName"column="column_name"/>
如果表使用联合主键,你可以映射类的多个属性为标识符属性。<composite-id>元素接受<key-property>属性映射和<key-many-to-one>属性映射作为子元素。
<key-propertyname="medicareNumber"/>
<key-propertyname="dependent"/>
你的持久化类必须重载equals()和hashCode()方法,来实现组合的标识符的相等判断。实现Serializable接口也是必须的。
<composite-id class="MedicareId"mapped="true">
<key-propertyname="medicareNumber"/>
<key-propertyname="dependent"/>
- mapped (可选, 默认为false): 指明使用一个映射式组合标识符,其包含的属性映射同时在实体类和组合标识符类中出现。
- class (可选,但对映射式组合标识符必须指定): 作为组合标识符类使用的类名.
- name (可选,但对这种方法而言必须): 包含此组件标识符的组件类型的名字 (参阅第9章).
- access (可选 - 默认为property): Hibernate应该使用的访问此属性值的策略
- class (可选 - 默认会用反射来自动判定属性类型 ): 用来作为组合标识符的组件类的类名(参阅下一节)
第三种方式,被称为identifier component(标识符组件)是我们对几乎所有应用都推荐使用的方式。
column="discriminator_column" (1)
formula="arbitrary sql expression" (5)
(1) |
column (可选 - 默认为 class) 鉴别器字段的名字 |
(2) |
type (可选 - 默认为 string) 一个Hibernate字段类型的名字 |
(3) |
force(强制) (可选 - 默认为 false) "强制"Hibernate指定允许的鉴别器值,即使当取得的所有实例都是根类的。 |
(4) |
insert (可选 - 默认为true) 如果你的鉴别器字段也是映射为复合标识(composite identifier)的一部分,则需将 这个值设为false。(告诉Hibernate在做SQL INSERT 时不包含该列) |
(5) |
formula (可选) 一个SQL表达式,在类型判断(判断是父类还是具体子类-译注)时执行。可用于基于内容的鉴别器。 |
鉴别器字段的实际值是根据<class>和<subclass>元素中的discriminator-value属性得来的。
force属性仅仅在这种情况下有用的:表中包含没有被映射到持久化类的附加辨别器值。这种情况不会经常遇到。
使用formula属性你可以定义一个SQL表达式,用来判断一个行数据的类型。
formula="casewhen CLASS_TYPE in ('a', 'b', 'c') then 0 else 1 end"
<version>元素是可选的,表明表中包含附带版本信息的数据。这在你准备使用长事务(long transactions)的时候特别有用。(见后)
access="field|property|ClassName" (4)
unsaved-value="null|negative|undefined" (5)
node="element-name|@attribute-name|element/@attribute|."
(1) |
column (可选 - 默认为属性名): 指定持有版本号的字段名。 |
(2) |
name: 持久化类的属性名。 |
(3) |
type (可选 - 默认是 integer): 版本号的类型。 |
(4) |
access (可选 - 默认是 property): Hibernate用于访问属性值的策略。 |
(5) |
unsaved-value (可选 - 默认是undefined): 用于标明某个实例时刚刚被实例化的(尚未保存)版本属性值,依靠这个值就可以把这种情况 和已经在先前的session中保存或装载的脱管(detached)实例区分开来。 (undefined指明应被使用的标识属性值。) |
(6) |
generated (可选 - 默认是 never): 表明此版本属性值是否实际上是由数据库生成的。请参阅第 5.6节 “数据库生成属性(Generated Properties)”部分的讨论。 |
(7) |
insert (可选 - 默认是 true): 表明此版本列应该包含在SQL插入语句中。只有当数据库字段有默认值0的时候,才可以设置为false。 |
版本号必须是以下类型:long,integer,short,timestamp或者calendar。
可选的<timestamp>元素指明了表中包含时间戳数据。这用来作为版本的替代。时间戳本质上是一种对乐观锁定的一种不是特别安全的实现。当然,有时候应用程序可能在其他方面使用时间戳。
access="field|property|ClassName" (3)
unsaved-value="null|undefined" (4)
node="element-name|@attribute-name|element/@attribute|."
(1) |
column (可选 - 默认为属性名): 持有时间戳的字段名。 |
(2) |
name: 在持久化类中的JavaBeans风格的属性名, 其Java类型是 Date 或者 Timestamp的。 |
(3) |
access (可选 - 默认是 property): Hibernate用于访问属性值的策略。 |
(4) |
unsaved-value (可选 - 默认是null): 用于标明某个实例时刚刚被实例化的(尚未保存)版本属性值,依靠这个值就可以把这种情况和 已经在先前的session中保存或装载的脱管(detached)实例区分开来。(undefined 指明使用标识属性值进行这种判断。) |
(5) |
source (可选 - 默认是 vm): Hibernate如何才能获取到时间戳的值呢?从数据库,还是当前JVM?从数据库获取会带来一些负担,因为Hibernate必须访问数据库来获得“下一个值”,但是在集群环境中会更安全些。还要注意,并不是所有的Dialect(方言)都支持获得数据库的当前时间戳的,而支持的数据库中又有一部分因为精度不足,用于锁定是不安全的(例如Oracle 8)。 |
(6) |
generated (可选 - 默认是 never): 指出时间戳值是否实际上是由数据库生成的.请参阅第 5.6节 “数据库生成属性(Generated Properties)”的讨论。 |
<property>元素为类定义了一个持久化的,JavaBean风格的属性。
formula="arbitrary SQL expression" (5)
access="field|property|ClassName" (6)
optimistic-lock="true|false" (10)
generated="never|insert|always" (11)
node="element-name|@attribute-name|element/@attribute|."
(1) |
name: 属性的名字,以小写字母开头。 |
(2) |
column (可选 - 默认为属性名字): 对应的数据库字段名。 也可以通过嵌套的<column>元素指定。 |
(3) |
type (可选): 一个Hibernate类型的名字。 |
(4) |
update, insert (可选 - 默认为 true) : 表明用于UPDATE 和/或 INSERT 的SQL语句中是否包含这个被映射了的字段。这二者如果都设置为false 则表明这是一个“外源性(derived)”的属性,它的值来源于映射到同一个(或多个) 字段的某些其他属性,或者通过一个trigger(触发器)或其他程序生成。 |
(5) |
formula (可选): 一个SQL表达式,定义了这个计算 (computed) 属性的值。计算属性没有和它对应的数据库字段。 |
(6) |
access (可选 - 默认值为 property): Hibernate用来访问属性值的策略。 |
(7) |
lazy (可选 - 默认为 false): 指定 指定实例变量第一次被访问时,这个属性是否延迟抓取(fetched lazily)( 需要运行时字节码增强)。 |
(8) |
unique (可选): 使用DDL为该字段添加唯一的约束。 同样,允许它作为property-ref引用的目标。 |
(9) |
not-null (可选): 使用DDL为该字段添加可否为空(nullability)的约束。 |
(10) |
optimistic-lock (可选 - 默认为 true): 指定这个属性在做更新时是否需要获得乐观锁定(optimistic lock)。 换句话说,它决定这个属性发生脏数据时版本(version)的值是否增长。 |
(11) |
generated (可选 - 默认为 never): 表明此属性值是否实际上是由数据库生成的。请参阅第 5.6节 “数据库生成属性(Generated Properties)”的讨论。 |
- Hibernate基本类型名(比如:integer, string, character,date, timestamp, float, binary, serializable, object, blob)。
- 一个Java类的名字,这个类属于一种默认基础类型 (比如: int, float,char, java.lang.String, java.util.Date, java.lang.Integer, java.sql.Clob)。
- 一个可以序列化的Java类的名字。
- 一个自定义类型的类的名字。(比如: com.illflow.type.MyCustomType)。
formula="( SELECTSUM (li.quantity*p.price) FROM LineItem li, Product p
WHEREli.productId = p.productId
ANDli.orderNumber = orderNumber )"/>
注意,你可以使用实体自己的表,而不用为这个特别的列定义别名(上面例子中的customerId)。同时注意,如果你不喜欢使用属性,你可以使用嵌套的<formula>映射元素。
通过many-to-one元素,可以定义一种常见的与另一个持久化类的关联。这种关系模型是多对一关联(实际上是一个对象引用-译注):这个表的一个外键引用目标表的主键字段。
property-ref="propertyNameFromAssociatedClass" (7)
access="field|property|ClassName" (8)
optimistic-lock="true|false" (11)
lazy="proxy|no-proxy|false" (12)
not-found="ignore|exception" (13)
formula="arbitrary SQL expression" (15)
node="element-name|@attribute-name|element/@attribute|."
foreign-key="foreign_key_name"
(1) |
name: 属性名。 |
(2) |
column (可选): 外间字段名。它也可以通过嵌套的 <column>元素指定。 |
(3) |
class (可选 - 默认是通过反射得到属性类型): 关联的类的名字。 |
(4) |
cascade(级联) (可选): 指明哪些操作会从父对象级联到关联的对象。 |
(5) |
fetch (可选 - 默认为 select): 在外连接抓取(outer-join fetching)和序列选择抓取(sequential select fetching)两者中选择其一。 |
(6) |
update, insert (可选 - 默认为 true) 指定对应的字段是否包含在用于UPDATE 和/或 INSERT 的SQL语句中。如果二者都是false,则这是一个纯粹的 “外源性(derived)”关联,它的值是通过映射到同一个(或多个)字段的某些其他属性得到 或者通过trigger(触发器)、或其他程序生成。 |
(6) |
property-ref: (可选) 指定关联类的一个属性,这个属性将会和本外键相对应。 如果没有指定,会使用对方关联类的主键。 |
(7) |
access (可选 - 默认是 property): Hibernate用来访问属性的策略。 |
(8) |
unique (可选): 使用DDL为外键字段生成一个唯一约束。此外, 这也可以用作property-ref的目标属性。这使关联同时具有 一对一的效果。 |
(9) |
not-null (可选): 使用DDL为外键字段生成一个非空约束。 |
(10) |
optimistic-lock (可选 - 默认为 true): 指定这个属性在做更新时是否需要获得乐观锁定(optimistic lock)。 换句话说,它决定这个属性发生脏数据时版本(version)的值是否增长。 |
(11) |
lazy (可选 - 默认为 proxy): 默认情况下,单点关联是经过代理的。lazy="no-proxy"指定此属性应该在实例变量第一次被访问时应该延迟抓取(fetche lazily)(需要运行时字节码的增强)。 lazy="false"指定此关联总是被预先抓取。 |
(12) |
not-found (可选 - 默认为 exception): 指定外键引用的数据不存在时如何处理: ignore会将行数据不存在视为一个空(null)关联。 |
(13) |
entity-name (可选): 被关联的类的实体名。 |
(14) |
formula (可选): SQL表达式,用于定义computed(计算出的)外键值。 |
<many-to-one name="product"class="Product" column="PRODUCT_ID"/>
<property name="serialNumber"unique="true" type="string"column="SERIAL_NUMBER"/>
<many-to-one name="product"property-ref="serialNumber"column="PRODUCT_SERIAL_NUMBER"/>
如果被引用的唯一主键由关联实体的多个属性组成,你应该在名称为<properties>的元素里面映射所有关联的属性。
<many-to-one name="owner"property-ref="identity.ssn" column="OWNER_SSN"/>
持久化对象之间一对一的关联关系是通过one-to-one元素定义的。
property-ref="propertyNameFromAssociatedClass" (6)
access="field|property|ClassName" (7)
formula="anySQL expression" (8)
lazy="proxy|no-proxy|false" (9)
node="element-name|@attribute-name|element/@attribute|."
foreign-key="foreign_key_name"
(1) |
name: 属性的名字。 |
(2) |
class (可选 - 默认是通过反射得到的属性类型):被关联的类的名字。 |
(3) |
cascade(级联) (可选) 表明操作是否从父对象级联到被关联的对象。 |
(4) |
constrained(约束) (可选) 表明该类对应的表对应的数据库表,和被关联的对象所对应的数据库表之间,通过一个外键引用对主键进行约束。 这个选项影响save()和delete()在级联执行时的先后顺序以及 决定该关联能否被委托(也在schema export tool中被使用). |
(5) |
fetch (可选 - 默认设置为选择): 在外连接抓取或者序列选择抓取选择其一. |
(6) |
property-ref: (可选) 指定关联类的属性名,这个属性将会和本类的主键相对应。如果没有指定,会使用对方关联类的主键。 |
(7) |
access (可选 - 默认是 property): Hibernate用来访问属性的策略。 |
(8) |
formula (可选):绝大多数一对一的关联都指向其实体的主键。在一些少见的情况中, 你可能会指向其他的一个或多个字段,或者是一个表达式,这些情况下,你可以用一个SQL公式来表示。 (可以在org.hibernate.test.onetooneformula找到例子) |
(9) |
lazy (可选 - 默认为 proxy): 默认情况下,单点关联是经过代理的。lazy="no-proxy"指定此属性应该在实例变量第一次被访问时应该延迟抓取(fetche lazily)(需要运行时字节码的增强)。 lazy="false"指定此关联总是被预先抓取。注意,如果constrained="false", 不可能使用代理,Hibernate会采取预先抓取! |
(10) |
entity-name (可选): 被关联的类的实体名。 |
主键关联不需要额外的表字段;如果两行是通过这种一对一关系相关联的,那么这两行就共享同样的主关键字值。所以如果你希望两个对象通过主键一对一关联,你必须确认它们被赋予同样的标识值!
比如说,对下面的Employee和Person进行主键一对一关联:
<one-to-one name="person"class="Person"/>
<one-to-one name="employee"class="Employee" constrained="true"/>
现在我们必须确保PERSON和EMPLOYEE中相关的字段是相等的。我们使用一个被成为foreign的特殊的hibernate标识符生成策略:
<class name="person" table="PERSON">
<idname="id" column="PERSON_ID">
<paramname="property">employee</param>
一个刚刚保存的Person实例被赋予和该Person的employee属性所指向的Employee实例同样的关键字值。
另一种方式是一个外键和一个惟一关键字对应,上面的Employee和Person的例子,如果使用这种关联方式,可以表达成:
<many-to-one name="person" class="Person"column="PERSON_ID" unique="true"/>
<one-to-one name"employee"class="Employee" property-ref="person"/>
<natural-id mutable="true|false"/>
我们强烈建议你实现equals()和hashCode()方法,来比较实体的自然键属性。
5.1.13.组件(component), 动态组件(dynamic-component)
<component>元素把子对象的一些元素与父类对应的表的一些字段映射起来。然后组件可以定义它们自己的属性、组件或者集合。参见后面的“Components”一章。
access="field|property|ClassName" (5)
optimistic-lock="true|false" (7)
(1) |
name: 属性名 |
(2) |
class (可选 - 默认为通过反射得到的属性类型):组件(子)类的名字。 |
(3) |
insert: 被映射的字段是否出现在SQL的INSERT语句中? |
(4) |
update: 被映射的字段是否出现在SQL的UPDATE语句中? |
(5) |
access (可选 - 默认是 property): Hibernate用来访问属性的策略。 |
(6) |
lazy (可选 - 默认是 false): 表明此组件应在实例变量第一次被访问的时候延迟加载(需要编译时字节码装置器) |
(7) |
optimistic-lock (可选 - 默认是 true):表明更新此组件是否需要获取乐观锁。换句话说,当这个属性变脏时,是否增加版本号(Version) |
(8) |
unique (可选 - 默认是 false):表明组件映射的所有字段上都有唯一性约束 |
其<property>子标签为子类的一些属性与表字段之间建立映射。
<component>元素允许加入一个<parent>子元素,在组件类内部就可以有一个指向其容器的实体的反向引用。
<dynamic-component>元素允许把一个Map映射为组件,其属性名对应map的键值。参见第8.5节“动态组件(Dynamic components)”.
optimistic-lock="true|false" (4)
(1) |
name: 分组的逻辑名称 - 不是 实际属性的名称. |
(2) |
insert: 被映射的字段是否出现在SQL的 INSERT语句中? |
(3) |
update: 被映射的字段是否出现在SQL的 UPDATE语句中? |
(4) |
optimistic-lock (可选 - 默认是 true):表明更新此组件是否需要获取乐观锁。换句话说,当这个属性变脏时,是否增加版本号(Version) |
(5) |
unique (可选 - 默认是 false):表明组件映射的所有字段上都有唯一性约束 |
然后,我们可能有一些遗留的数据关联,引用Person表的这个唯一键,而不是主键。
class="Person"property-ref="name">
最后,多态持久化需要为父类的每个子类都进行定义。对于“每一棵类继承树对应一个表”的策略来说,就需要使用<subclass>定义。
discriminator-value="discriminator_value" (2)
(1) |
name: 子类的全限定名。 |
(2) |
discriminator-value(辨别标志) (可选 - 默认为类名):一个用于区分每个独立的子类的值。 |
(3) |
proxy(代理) (可选): 指定一个类或者接口,在延迟装载时作为代理使用。 |
(4) |
lazy (可选, 默认是true): 设置为 lazy="false" 禁止使用延迟抓取 |
更多关于继承映射的信息, 参考第9章继承映射(Inheritance Mappings)章节.
此外,每个子类可能被映射到他自己的表中(每个子类一个表的策略)。被继承的状态通过和超类的表关联得到。我们使用<joined-subclass>元素。
(1) |
name: 子类的全限定名。 |
(2) |
table: 子类的表名. |
(3) |
proxy (可选): 指定一个类或者接口,在延迟装载时作为代理使用。 |
(4) |
lazy (可选, 默认是 true): 设置为 lazy="false" 禁止使用延迟装载。 |
这种映射策略不需要指定辨别标志(discriminator)字段。但是,每一个子类都必须使用<key>元素指定一个表字段来持有对象的标识符。本章开始的映射可以被用如下方式重写:
<!DOCTYPE hibernate-mapping PUBLIC
"-//Hibernate/Hibernate Mapping DTD//EN"
"http://hibernate.sourceforge.net/hibernate-mapping-3.0.dtd">
<hibernate-mapping package="eg">
<classname="Cat" table="CATS">
<idname="id" column="uid" type="long">
<property name="birthdate" type="date"/>
<propertyname="color" not-null="true"/>
<property name="sex" not-null="true"/>
<joined-subclass name="DomesticCat"table="DOMESTIC_CATS">
<property name="name" type="string"/>
<!--mapping for Dog could go here -->
更多关于继承映射的信息,参考第9章继承映射(Inheritance Mappings)。
(1) |
name: 子类的全限定名。 |
(2) |
table: 子类的表名 |
(3) |
proxy (可选): 指定一个类或者接口,在延迟装载时作为代理使用。 |
(4) |
lazy (可选, 默认是 true): 设置为 lazy="false" 禁止使用延迟装载。 |
这种映射策略不需要指定辨别标志(discriminator)字段。
更多关于继承映射的信息,参考第9章继承映射(Inheritance Mappings)。
(1) |
table: 被连接表的名称。 |
(2) |
schema (可选):覆盖由根<hibernate-mapping>元素指定的模式名称。 |
(3) |
catalog (可选): 覆盖由根 <hibernate-mapping>元素指定的目录名称。 |
(4) |
fetch (可选 - 默认是 join): 如果设置为默认值join, Hibernate 将使用一个内连接来得到这个类或其超类定义的<join>,而使用一个外连接来得到其子类定义的<join>。如果设置为select,则 Hibernate 将为子类定义的 <join>使用顺序选择。这仅在一行数据表示一个子类的对象的时候才会发生。对这个类和其超类定义的<join>,依然会使用内连接得到。 |
(5) |
inverse (可选 - 默认是 false): 如果打开,Hibernate 不会插入或者更新此连接定义的属性。 |
(6) |
optional (可选 - 默认是 false): 如果打开,Hibernate 只会在此连接定义的属性非空时插入一行数据,并且总是使用一个外连接来得到这些属性。 |
例如,一个人(person)的地址(address)信息可以被映射到单独的表中(并保留所有属性的值类型语义):
<idname="id" column="PERSON_ID">...</id>
此特性常常对遗留数据模型有用,我们推荐表个数比类个数少,以及细粒度的领域模型。然而,在单独的继承树上切换继承映射策略是有用的,后面会解释这点。
我们目前已经见到过<key>元素多次了。这个元素在父映射元素定义了对新表的连接,并且在被连接表中定义了一个外键引用原表的主键的情况下经常使用。
on-delete="noaction|cascade" (2)
property-ref="propertyName" (3)
(1) |
column (可选): 外键字段的名称。也可以通过嵌套的 <column>指定。 |
(2) |
on-delete (可选, 默认是 noaction): 表明外键关联是否打开数据库级别的级联删除。 |
(3) |
property-ref (可选): 表明外键引用的字段不是原表的主键(提供给遗留数据)。 |
(4) |
not-null (可选): 表明外键的字段不可为空(这意味着无论何时外键都是主键的一部分)。 |
(5) |
update (可选): 表明外键决不应该被更新(这意味着无论何时外键都是主键的一部分)。 |
(6) |
unique (可选): 表明外键应有唯一性约束 (这意味着无论何时外键都是主键的一部分)。 |
not-null和update属性在映射单向一对多关联的时候有用。如果你映射一个单向一对多关联到非空的(non-nullable)外键,你必须用<key not-null="true">定义此键字段。
5.1.20.字段和规则元素(column and formula elements)
任何接受column属性的映射元素都可以选择接受<column>子元素。同样的,formula子元素也可以替换<formula>属性。
unique-key="multicolumn_unique_key_name"
<formula>SQL expression</formula>
column和formula属性甚至可以在同一个属性或关联映射中被合并来表达,例如,一些奇异的连接条件。
<many-to-one name="homeAddress"class="Address"
insert="false" update="false">
<columnname="person_id" not-null="true" length="10"/>
<import class="java.lang.Object"rename="Universe"/>
(1) |
class: 任何Java类的全限定名。 |
(2) |
rename (可选 - 默认为类的全限定名): 在查询语句中可以使用的名字。 |
meta-type属性使得应用程序能指定一个将数据库字段的值映射到持久化类的自定义类型。这个持久化类包含有用id-type指定的标识符属性。你必须指定从meta-type的值到类名的映射。
<any name="being" id-type="long"meta-type="string">
<meta-valuevalue="TBL_ANIMAL" class="Animal"/>
<meta-valuevalue="TBL_HUMAN" class="Human"/>
<meta-valuevalue="TBL_ALIEN" class="Alien"/>
access="field|property|ClassName" (5)
optimistic-lock="true|false" (6)
(1) |
name: 属性名 |
(2) |
id-type: 标识符类型 |
(3) |
meta-type (可选 -默认是 string): 允许辨别标志(discriminator)映射的任何类型 |
(4) |
cascade (可选 -默认是none): 级联的类型 |
(5) |
access (可选 -默认是 property): Hibernate 用来访问属性值的策略。 |
(6) |
optimistic-lock (可选 -默认是 true): 表明更新此组件是否需要获取乐观锁。换句话说,当这个属性变脏时,是否增加版本号(Version) |
为了理解很多与持久化服务相关的Java语言级对象的行为,我们需要把它们分为两类:
所有的Hibernate内建类型,除了collections以外,都支持空(null)语义。
integer, long, short, float, double,character, byte, boolean, yes_no, true_false
从java.lang.String到VARCHAR(或者 Oracle的VARCHAR2)的映射。
从java.util.Date和其子类到SQL类型DATE,TIME和TIMESTAMP(或等价类型)的映射。
从java.util.Calendar到SQL 类型TIMESTAMP和DATE(或等价类型)的映射。
从java.math.BigDecimal和java.math.BigInteger到NUMERIC(或者 Oracle 的NUMBER类型)的映射。
从java.lang.Class到VARCHAR(或者 Oracle 的VARCHAR2类型)的映射。Class被映射为它的全限定名。
把字节数组(bytearrays)映射为对应的 SQL二进制类型。
把可序列化的Java类型映射到对应的SQL二进制类型。你也可以为一个并非默认为基本类型的可序列化Java类或者接口指定Hibernate类型serializable。
imm_date, imm_time, imm_timestamp,imm_calendar, imm_calendar_date, imm_serializable, imm_binary
实体及其集合的唯一标识可以是除了binary、blob和clob之外的任何基础类型。(联合标识也是允许的,后面会说到。)
在org.hibernate.Hibernate中,定义了基础类型对应的Type常量。比如,Hibernate.STRING代表string类型。
<property name="twoStrings"type="org.hibernate.test.DoubleStringType">
注意使用<column>标签来把一个属性映射到多个字段的做法。
CompositeUserType,EnhancedUserType,UserCollectionType, 和UserVersionType接口为更特殊的使用方式提供支持。
<typename="com.mycompany.usertypes.DefaultValueIntegerType">
<paramname="default">0</param>
现在,UserType可以从传入的Properties对象中得到default参数的值。
<typedef class="com.mycompany.usertypes.DefaultValueIntegerType"name="default_zero">
<paramname="default">0</param>
<property name="priority"type="default_zero"/>
也可以根据具体案例通过属性映射中的类型参数覆盖在typedef中提供的参数。
<class name="Contract" table="Contracts"
entity-name="CurrentContract">
<setname="history" inverse="true"
order-by="effectiveEndDate desc">
<keycolumn="currentContractId"/>
<one-to-manyentity-name="HistoricalContract"/>
<class name="Contract"table="ContractHistory"
entity-name="HistoricalContract">
<many-to-onename="currentContract"
entity-name="CurrentContract"/>
注意这里关联是如何用entity-name来代替class的。
<class name="LineItem" table="`LineItem`">
<idname="id" column="`Item Id`"/><generatorclass="assigned"/></id>
<propertyname="itemNumber" column="`Item #`"/>
XML 并不适用于所有人, 因此有其他定义HibernateO/R 映射元数据(metadata)的方法。
*@hibernate.collection-one-to-many
// addKitten notneeded by Hibernate
public voidaddKitten(Cat kitten) {
参考Hibernate网站更多的Xdoclet和Hibernate的例子
5.5.2.使用 JDK 5.0 的注解(Annotation)
这是一个被注解为EJB entity bean 的POJO类的例子
@Entity(access = AccessType.FIELD)
public class Customer implements Serializable {
@OneToMany(cascade=CascadeType.ALL)
@JoinColumn(name="CUSTOMER_ID")
// Getter/setter andbusiness methods
注意:对 JDK 5.0 注解 (和 JSR-220)支持的工作仍然在进行中,并未完成。更多细节请参阅Hibernate Annotations 模块。
5.6.数据库生成属性(Generated Properties)
always- 标明此属性值在insert和update时都会被生成。
5.7.辅助数据库对象(Auxiliary Database Objects)
第一种模式是在映射文件中显式声明CREATE和DROP命令:
<create>CREATE TRIGGER my_trigger ...</create>
<drop>DROPTRIGGER my_trigger</drop>
第二种模式是提供一个类,这个类知道如何组织CREATE和DROP命令。这个特别类必须实现org.hibernate.mapping.AuxiliaryDatabaseObject接口。
<definitionclass="MyTriggerDefinition"/>
<definitionclass="MyTriggerDefinition"/>
<dialect-scopename="org.hibernate.dialect.Oracle9Dialect"/>
<dialect-scopename="org.hibernate.dialect.OracleDialect"/>
6.1.持久化集合类(Persistent collections)
(译者注:在阅读本章的时候,以后整个手册的阅读过程中,我们都会面临一个名词方面的问题,那就是“集合”。"Collections"和"Set"在中文里对应都被翻译为“集合”,但是他们的含义很不一样。Collections是一个超集,Set是其中的一种。大部分情况下,本译稿中泛指的未加英文注明的“集合”,都应当理解为“Collections”。在有些二者同时出现,可能造成混淆的地方,我们用“集合类”来特指“Collecions”,“集合(Set)”来指"Set",一般都会在后面的括号中给出英文。希望大家在阅读时联系上下文理解,不要造成误解。与此同时,“元素”一词对应的英文“element”,也有两个不同的含义。其一为集合的元素,是内存中的一个变量;另一含义则是XML文档中的一个标签所代表的元素。也请注意区别。本章中,特别是后半部分是需要反复阅读才能理解清楚的。如果遇到任何疑问,请记住,英文版本的reference是惟一标准的参考资料。)
Hibernate要求持久化集合值字段必须声明为接口,比如:
public class Product {
private StringserialNumber;
private Set parts =new HashSet();
public Set getParts(){ return parts; }
void setParts(Setparts) { this.parts = parts; }
public StringgetSerialNumber() { return serialNumber; }
voidsetSerialNumber(String sn) { serialNumber = sn; }
}
实际的接口可能是java.util.Set,java.util.Collection,java.util.List,java.util.Map,java.util.SortedSet,java.util.SortedMap或者...任何你喜欢的类型!("任何你喜欢的类型" 代表你需要编写org.hibernate.usertype.UserCollectionType的实现.)
注意我们是如何用一个HashSet实例来初始化实例变量的.这是用于初始化新创建(尚未持久化)的类实例中集合值属性的最佳方法。当你持久化这个实例时——比如通过调用persist()——Hibernate会自动把HashSet替换为Hibernate自己的Set实现。观察下面的错误:
Cat cat = new DomesticCat();
Cat kitten = new DomesticCat();
....
Set kittens = new HashSet();
kittens.add(kitten);
cat.setKittens(kittens);
session.persist(cat);
kittens = cat.getKittens(); //Okay, kittens collection is a Set
(HashSet) cat.getKittens(); //Error!
根据不同的接口类型,被Hibernate注射的持久化集合类的表现类似HashMap,HashSet,TreeMap,TreeSetorArrayList。
集合类实例具有值类型的通常行为。当被持久化对象引用后,他们会自动被持久化,当不再被引用后,自动被删除。假若实例被从一个持久化对象传递到另一个,它的元素可能从一个表转移到另一个表。两个实体不能共享同一个集合类实例的引用。因为底层关系数据库模型的原因,集合值属性无法支持空值语义;Hibernate对空的集合引用和空集合不加区别。
你不需要过多的为此担心。就如同你平时使用普通的Java集合类一样来使用持久化集合类。只是要确认你理解了双向关联的语义(后文讨论)。
6.2.集合映射( Collection mappings )
用于映射集合类的Hibernate映射元素取决于接口的类型。比如,<set>元素用来映射Set类型的属性。
<idname="serialNumber" column="productSerialNumber"/>
<keycolumn="productSerialNumber" not-null="true"/>
除了<set>,还有<list>,<map>,<bag>,<array>和<primitive-array>映射元素。<map>具有代表性:
cascade="all|none|save-update|delete|all-delete-orphan|delet(6)e-orphan"
sort="unsorted|natural|comparatorClass" (7)
order-by="column_name asc|desc" (8)
where="arbitrarysql where condition" (9)
fetch="join|select|subselect" (10)
access="field|property|ClassName" (12)
optimistic-lock="true|false" (13)
(1) |
name 集合属性的名称 |
(2) |
table (可选——默认为属性的名称)这个集合表的名称(不能在一对多的关联关系中使用) |
(3) |
schema (可选) 表的schema的名称, 他将覆盖在根元素中定义的schema |
(4) |
lazy (可选--默认为true) 可以用来关闭延迟加载(false),指定一直使用预先抓取,或者打开"extra-lazy" 抓取,此时大多数操作不会初始化集合类(适用于非常大的集合) |
(5) |
inverse (可选——默认为false) 标记这个集合作为双向关联关系中的方向一端。 |
(6) |
cascade (可选——默认为none) 让操作级联到子实体 |
(7) |
sort(可选)指定集合的排序顺序, 其可以为自然的(natural)或者给定一个用来比较的类。 |
(8) |
order-by (可选, 仅用于jdk1.4) 指定表的字段(一个或几个)再加上asc或者desc(可选), 定义Map,Set和Bag的迭代顺序 |
(9) |
where (可选) 指定任意的SQL where条件, 该条件将在重新载入或者删除这个集合时使用(当集合中的数据仅仅是所有可用数据的一个子集时这个条件非常有用) |
(10) |
fetch (可选, 默认为select) 用于在外连接抓取、通过后续select抓取和通过后续subselect抓取之间选择。 |
(11) |
batch-size (可选, 默认为1) 指定通过延迟加载取得集合实例的批处理块大小("batch size")。 |
(12) |
access(可选-默认为属性property):Hibernate取得集合属性值时使用的策略 |
(13) |
乐观锁 (可选 - 默认为 true): 对集合的状态的改变会是否导致其所属的实体的版本增长。 (对一对多关联来说,关闭这个属性常常是有理的) |
(14) |
mutable(可变) (可选 - 默认为true): 若值为false,表明集合中的元素不会改变(在某些情况下可以进行一些小的性能优化)。 |
6.2.1.集合外键(Collection foreign keys)
集合实例在数据库中依靠持有集合的实体的外键加以辨别。此外键作为集合关键字段(collection key column)(或多个字段)加以引用。集合关键字段通过<key>元素映射。
在外键字段上可能具有非空约束。对于大多数集合来说,这是隐含的。对单向一对多关联来说,外键字段默认是可以为空的,因此你可能需要指明not-null="true"。
<key column="productSerialNumber"not-null="true"/>
<key column="productSerialNumber"on-delete="cascade"/>
6.2.2.集合元素(Collection elements)
6.2.3.索引集合类(Indexed collections)
formula="anySQL expression" (2)
(1) |
column(可选):保存集合索引值的字段名。 |
(2) |
formula (可选): 用于计算map关键字的SQL公式 |
(3) |
type (必须):映射键(map key)的类型。 |
formula="anySQL expression" (2)(3)
(1) |
column(可选):集合索引值中外键字段的名称 |
(2) |
formula (可选): 用于计算map关键字的外键的SQL公式 |
(3) |
class (必需):映射的键(map key)使用的实体类。 |
假若你的表没有一个索引字段,当你仍然希望使用List作为属性类型,你应该把此属性映射为Hibernate<bag>。从数据库中获取的时候,bag不维护其顺序,但也可选择性的进行排序。
从集合类可以产生很大一部分映射,覆盖了很多常见的关系模型。我们建议你试验schema生成工具,来体会一下不同的映射声明是如何被翻译为数据库表的。
6.2.4.值集合于多对多关联(Collections of values and many-to-many associations)
任何值集合或者多对多关联需要专用的具有一个或多个外键字段的collection table、一个或多个collection element column,以及还可能有一个或多个索引字段。
formula="anySQL expression" (2)
(1) |
column(可选):保存集合元素值的字段名。 |
(2) |
formula (可选): 用于计算元素的SQL公式 |
(3) |
type (必需):集合元素的类型 |
多对多关联(many-to-many association)使用<many-to-many>元素定义.
formula="anySQL expression" (2)
not-found="ignore|exception" (6)
property-ref="propertyNameFromAssociatedClass" (8)
(1) |
column(可选): 这个元素的外键关键字段名 |
(2) |
formula (可选): 用于计算元素外键值的SQL公式. |
(3) |
class (必需): 关联类的名称 |
(3) |
outer-join (可选 - 默认为auto): 在Hibernate系统参数中hibernate.use_outer_join被打开的情况下,该参数用来允许使用outer join来载入此集合的数据。 |
(4) |
为此关联打开外连接抓取或者后续select抓取。这是特殊情况;对于一个实体及其指向其他实体的多对多关联进全预先抓取(使用一条单独的SELECT),你不仅需要对集合自身打开join,也需要对<many-to-many>这个内嵌元素打开此属性。 |
(5) |
对外键字段允许DDL生成的时候生成一个惟一约束。这使关联变成了一个高效的一对多关联。(此句存疑:原文为This makes the association multiplicity effectively one to many.) |
(6) |
not-found (可选 - 默认为 exception): 指明引用的外键中缺少某些行该如何处理: ignore 会把缺失的行作为一个空引用处理。 |
(7) |
entity-name (可选): 被关联的类的实体名,作为class的替代。 |
(8) |
property-ref: (可选) 被关联到此外键(foreign key)的类中的对应属性的名字。若未指定,使用被关联类的主键。 |
<set name="names" table="NAMES">
<elementcolumn="NAME" type="string"/>
包含一组整数的bag(还设置了order-by参数指定了迭代的顺序):
<elementcolumn="size" type="integer"/>
一个实体数组,在这个案例中是一个多对多的关联(注意这里的实体是自动管理生命周期的对象(lifecycle objects),cascade="all"):
<list-index column="sortOrder"/>
<many-to-manycolumn="addressId" class="Address"/>
<map-keycolumn="hol_name" type="string"/>
<elementcolumn="hol_date" type="date"/>
<list-indexcolumn="sortOrder"/>
<composite-elementclass="CarComponent">
<propertyname="serialNumber" column="serialNum"/>
6.2.5.一对多关联(One-to-many Associations)
一对多关联通过外键连接两个类对应的表,而没有中间集合表。这个关系模型失去了一些Java集合的语义:
一个从Product到Part的关联需要关键字字段,可能还有一个索引字段指向Part所对应的表。<one-to-many>标记指明了一个一对多的关联。
not-found="ignore|exception" (2)
(1) |
class(必须):被关联类的名称。 |
(2) |
not-found (可选 - 默认为exception): 指明若缓存的标示值关联的行缺失,该如何处理: ignore 会把缺失的行作为一个空关联处理。 |
(3) |
entity-name (可选): 被关联的类的实体名,作为class的替代。 |
<one-to-manyclass="org.hibernate.Bar"/>
注意:<one-to-many>元素不需要定义任何字段。也不需要指定表名。
下面的例子展示一个Part实体的map,把name作为关键字。(partName是Part的持久化属性)。注意其中的基于公式的索引的用法。
<keycolumn="productId" not-null="true"/>
6.3.高级集合映射(Advanced collection mappings)
6.3.1.有序集合(Sorted collections)
Hibernate支持实现java.util.SortedMap和java.util.SortedSet的集合。你必须在映射文件中指定一个比较器:
<elementcolumn="name" type="string"/>
<map name="holidays"sort="my.custom.HolidayComparator">
<map-keycolumn="hol_name" type="string"/>
<elementcolumn="hol_date" type="date"/>
sort属性中允许的值包括unsorted,natural和某个实现了java.util.Comparator的类的名称。
分类集合的行为事实上象java.util.TreeSet或者java.util.TreeMap。
<set name="aliases"table="person_aliases" order-by="lower(name) asc">
<elementcolumn="name" type="string"/>
<map name="holidays" order-by="hol_date,hol_name">
<map-keycolumn="hol_name" type="string"/>
<elementcolumn="hol_date" type="date"/>
注意: 这个order-by属性的值是一个SQL排序子句而不是HQL的!
关联还可以在运行时使用集合filter()根据任意的条件来排序。
sortedUsers = s.createFilter( group.getUsers(), "order bythis.name" ).list();
6.3.2.双向关联(Bidirectional associations)
双向关联允许通过关联的任一端访问另外一端。在Hibernate中, 支持两种类型的双向关联:
要建立一个双向的多对多关联,只需要映射两个many-to-many关联到同一个数据库表中,并再定义其中的一端为inverse(使用哪一端要根据你的选择,但它不能是一个索引集合)。
这里有一个many-to-many的双向关联的例子;每一个category都可以有很多items,每一个items可以属于很多categories:
<idname="id" column="CATEGORY_ID"/>
<bagname="items" table="CATEGORY_ITEM">
<many-to-manyclass="Item" column="ITEM_ID"/>
<idname="id" column="CATEGORY_ID"/>
<bagname="categories" table="CATEGORY_ITEM"inverse="true">
<many-to-manyclass="Category" column="CATEGORY_ID"/>
category.getItems().add(item); // The category now "knows"about the relationship
item.getCategories().add(category); // The item now "knows" aboutthe relationship
session.persist(item); // The relationshipwon''t be saved!
session.persist(category); // The relationship will besaved
要建立一个一对多的双向关联,你可以通过把一个一对多关联,作为一个多对一关联映射到到同一张表的字段上,并且在"多"的那一端定义inverse="true"。
<idname="id" column="parent_id"/>
<setname="children" inverse="true">
<idname="id" column="child_id"/>
在“一”这一端定义inverse="true"不会影响级联操作,二者是正交的概念!
对于有一端是<list>或者<map>的双向关联,需要加以特别考虑。假若子类中的一个属性映射到索引字段,没问题,我们仍然可以在集合类映射上使用inverse="true":
<idname="id" column="parent_id"/>
<mapname="children" inverse="true">
<idname="id" column="child_id"/>
但是,假若子类中没有这样的属性存在,我们不能认为这个关联是真正的双向关联(信息不对称,在关联的一端有一些另外一端没有的信息)。在这种情况下,我们不能使用inverse="true"。我们需要这样用:
<idname="id" column="parent_id"/>
<idname="id" column="child_id"/>
注意在这个映射中,关联中集合类"值"一端负责来更新外键.TODO: Does this really result in some unnecessary updatestatements?
6.3.4.三重关联(Ternary associations)
有三种可能的途径来映射一个三重关联。第一种是使用一个Map,把一个关联作为其索引:
<keycolumn="employer_id" not-null="true"/>
<map-key-many-to-many column="employee_id"class="Employee"/>
<one-to-manyclass="Contract"/>
<keycolumn="incoming_node_id"/>
<map-key-many-to-many column="outgoing_node_id"class="Node"/>
<many-to-manycolumn="connection_id" class="Connection"/>
第二种方法是简单的把关联重新建模为一个实体类。这使我们最经常使用的方法。
<idbag>属性让你使用bag语义来映射一个List(或Collection)。
<idbag name="lovers" table="LOVERS">
<collection-idcolumn="ID" type="long">
<many-to-manycolumn="PERSON2" class="Person" fetch="join"/>
你可以理解,<idbag>人工的id生成器,就好像是实体类一样!集合的每一行都有一个不同的人造关键字。但是,Hibernate没有提供任何机制来让你取得某个特定行的人造关键字。
注意<idbag>的更新性能要比普通的<bag>高得多!Hibernate可以有效的定位到不同的行,分别进行更新或删除工作,就如同处理一个list, map或者set一样。
在目前的实现中,还不支持使用identity标识符生成器策略来生成<idbag>集合的标识符。
在前面的几个章节的确非常令人迷惑。因此让我们来看一个例子。这个类:
public long getId() {return id; }
private voidsetId(long id) { this.id=id; }
private SetgetChildren() { return children; }
private voidsetChildren(Set children) { this.children=children; }
这个类有一个Child的实例集合。如果每一个子实例至多有一个父实例, 那么最自然的映射是一个one-to-many的关联关系:
create table parent ( id bigint not null primary key )
create table child ( id bigint not null primary key, namevarchar(255), parent_id bigint )
alter table child add constraint childfk0 (parent_id) referencesparent
如果父亲是必须的, 那么就可以使用双向one-to-many的关联了:
<setname="children" inverse="true">
<many-to-onename="parent" class="Parent" column="parent_id"not-null="true"/>
create table parent ( id bigint not null primary key )
create table child ( id bigint not null
alter table child add constraint childfk0 (parent_id) referencesparent
另外,如果你绝对坚持这个关联应该是单向的,你可以对<key>映射声明NOT NULL约束:
<keycolumn="parent_id" not-null="true"/>
另外一方面,如果一个子实例可能有多个父实例,那么就应该使用many-to-many关联:
<setname="children" table="childset">
<many-to-many class="Child"column="child_id"/>
create table parent ( id bigint not null primary key )
create table child ( id bigint not null primary key, namevarchar(255) )
create table childset ( parent_id bigint not null,
primary key ( parent_id, child_id ) )
alter table childset add constraint childsetfk0 (parent_id)references parent
alter table childset add constraint childsetfk1 (child_id)references child
更多的例子,以及一个完整的父/子关系映射的排练,请参阅第21章示例:父子关系(Parent Child Relationships).
甚至可能出现更加复杂的关联映射,我们会在下一章中列出所有可能性。
关联关系映射通常情况是最难配置正确的。在这个部分中,我们从单向关系映射开始,然后考虑双向关系映射,由浅至深讲述一遍典型的案例。在所有的例子中,我们都使用Person和Address。
7.2.单向关联(Unidirectional associations)
<idname="id" column="personId">
<idname="id" column="addressId">
create table Person ( personId bigint not null primary key,addressId bigint not null )
create table Address ( addressId bigint not null primary key )
基于外键关联的单向一对一关联和单向多对一关联几乎是一样的。唯一的不同就是单向一对一关联中的外键字段具有唯一性约束。
<idname="id" column="personId">
<idname="id" column="addressId">
create table Person ( personId bigint not null primary key,addressId bigint not null unique )
create table Address ( addressId bigint not null primary key )
基于主键关联的单向一对一关联通常使用一个特定的id生成器。(请注意,在这个例子中我们掉换了关联的方向。)
<idname="id" column="personId">
<idname="id" column="personId">
<paramname="property">person</param>
<one-to-onename="person" constrained="true"/>
create table Person ( personId bigint not null primary key )
create table Address ( personId bigint not null primary key )
基于外键关联的单向一对多关联是一种很少见的情况,并不推荐使用。
<idname="id" column="personId">
<idname="id" column="addressId">
create table Person ( personId bigint not null primary key )
create table Address ( addressId bigint not null primary key,personId bigint not null )
7.3.使用连接表的单向关联(Unidirectional associations with join tables)
基于连接表的单向一对多关联应该优先被采用。请注意,通过指定unique="true",我们可以把多样性从多对多改变为一对多。
<idname="id" column="personId">
<setname="addresses" table="PersonAddress">
<many-to-manycolumn="addressId"
<idname="id" column="addressId">
create table Person ( personId bigint not null primary key )
create table PersonAddress ( personId not null, addressId bigintnot null primary key )
create table Address ( addressId bigint not null primary key )
基于连接表的单向多对一关联在关联关系可选的情况下应用也很普遍。
<idname="id" column="personId">
<keycolumn="personId" unique="true"/>
<id name="id"column="addressId">
create table Person ( personId bigint not null primary key )
create table PersonAddress ( personId bigint not null primarykey, addressId bigint not null )
create table Address ( addressId bigint not null primary key )
<idname="id" column="personId">
<idname="id" column="addressId">
create table Person ( personId bigint not null primary key )
create table PersonAddress ( personId bigint not null primarykey, addressId bigint not null unique )
create table Address ( addressId bigint not null primary key )
<idname="id" column="personId">
<setname="addresses" table="PersonAddress">
<many-to-manycolumn="addressId"
<idname="id" column="addressId">
create table Person ( personId bigint not null primary key )
create table Address ( addressId bigint not null primary key )
7.4.双向关联(Bidirectional associations)
7.4.1.一对多(one to many) / 多对一(many to one)
双向多对一关联是最常见的关联关系。(这也是标准的父/子关联关系。)
<idname="id" column="personId">
<idname="id" column="addressId">
<setname="people" inverse="true">
create table Person ( personId bigint not null primary key,addressId bigint not null )
create table Address ( addressId bigint not null primary key )
<keycolumn="addressId" not-null="true"/>
<list-indexcolumn="peopleIdx"/>
<idname="id" column="personId">
<idname="id" column="addressId">
create table Person ( personId bigint not null primary key,addressId bigint not null unique )
create table Address ( addressId bigint not null primary key )
<idname="id" column="personId">
<idname="id" column="personId">
<paramname="property">person</param>
create table Person ( personId bigint not null primary key )
create table Address ( personId bigint not null primary key )
7.5.使用连接表的双向关联(Bidirectional associations with join tables)
7.5.1.一对多(one to many) /多对一(many to one)
基于连接表的双向一对多关联。注意inverse="true"可以出现在关联的任意一端,即collection端或者join端。
<idname="id" column="personId">
<many-to-manycolumn="addressId"
<idname="id" column="addressId">
create table Person ( personId bigint not null primary key )
create table PersonAddress ( personId bigint not null, addressIdbigint not null primary key )
create table Address ( addressId bigint not null primary key )
<idname="id" column="personId">
<idname="id" column="addressId">
create table Person ( personId bigint not null primary key )
create table PersonAddress ( personId bigint not null primarykey, addressId bigint not null unique )
create table Address ( addressId bigint not null primary key )
<idname="id" column="personId">
<setname="addresses" table="PersonAddress">
<many-to-manycolumn="addressId"
<idname="id" column="addressId">
<setname="people" inverse="true" table="PersonAddress">
<many-to-manycolumn="personId"
create table Person ( personId bigint not null primary key )
create table Address ( addressId bigint not null primary key )
<properties name="currentAccountKey">
<propertyname="accountNumber" type="string"not-null="true"/>
<propertyname="currentAccount" type="boolean">
<formula>case when effectiveEndDate is null then 1 else 0end</formula>
<property name="effectiveEndDate"type="date"/>
<property name="effectiveStateDate"type="date" not-null="true"/>
那么我们可以对目前(current)实例(其effectiveEndDate为null)使用这样的关联映射:
<many-to-one name="currentAccountInfo"
property-ref="currentAccountKey"
having startDate =max(startDate)
<many-to-onename="mostRecentEmployer"
使用这一功能时可以充满创意,但通常更加实用的是用HQL或条件查询来处理这些情形。
组件(Component)这个概念在Hibernate中几处不同的地方为了不同的目的被重复使用.
private java.util.Datebirthday;
private voidsetKey(String key) {
public java.util.DategetBirthday() {
public voidsetBirthday(java.util.Date birthday) {
public voidsetName(Name name) {
void setInitial(charinitial) {
在持久化的过程中,姓名(Name)可以作为人(Person)的一个组件。需要注意的是:你应该为姓名的持久化属性定义getter和setter方法,但是你不需要实现任何的接口或申明标识符字段。
<class name="eg.Person"table="person">
<idname="Key" column="pid" type="string">
<propertyname="birthday" type="date"/>
<componentname="Name" class="eg.Name"> <!-- class attributeoptional -->
人员(Person)表中将包括pid,birthday,initial,first和last等字段。
<component>元素还允许有<parent>子元素,用来表明component类中的一个属性是指向包含它的实体的引用。
<class name="eg.Person"table="person">
<id name="Key"column="pid" type="string">
<propertyname="birthday" type="date">
<componentname="Name" class="eg.Name" unique="true">
<parentname="namedPerson"/> <!-- reference back to the Person -->
8.2.在集合中出现的依赖对象 (Collections of dependent objects)
Hibernate支持组件的集合(例如: 一个元素是姓名(Name)这种类型的数组)。你可以使用<composite-element>标签替代<element>标签来定义你的组件集合。
<set name="someNames" table="some_names"lazy="true">
<composite-elementclass="eg.Name"> <!-- class attribute required -->
注意,如果你定义的Set包含组合元素(composite-element),正确地实现equals()和hashCode()是非常重要的。
<setname="purchasedItems" table="purchase_items"lazy="true">
<composite-element class="eg.Purchase">
<propertyname="purchaseDate"/>
<many-to-one name="item" class="eg.Item"/><!-- class attribute is optional -->
<setname="purchasedItems" table="purchase_items"lazy="true">
<composite-elementclass="eg.OrderLine">
<many-to-one name="purchaseDetails"class="eg.Purchase"/>
<many-to-one name="item" class="eg.Item"/>
在查询中,表达组合元素的语法和关联到其他实体的语法是一样的。
8.3.组件作为Map的索引(Componentsas Map indices )
<composite-map-key>元素允许你映射一个组件类作为一个Map的key,前提是你必须正确的在这个类中重写了hashCode()和equals()方法。
8.4.组件作为联合标识符(Components as composite identifiers)
你可以使用一个组件作为一个实体类的标识符。你的组件类必须满足以下要求:
注意:在Hibernate3中,第二个要求并非是Hibernate强制必须的。但最好这样做。
你不能使用一个IdentifierGenerator产生组合关键字。一个应用程序必须分配它自己的标识符。
使用<composite-id>标签(并且内嵌<key-property>元素)代替通常的<id>标签。比如,OrderLine类具有一个主键,这个主键依赖于Order的(联合)主键。
<composite-idname="id" class="OrderLineId">
<key-propertyname="customerId"/>
<many-to-onename="order" class="Order"
insert="false" update="false">
现在,任何指向OrderLine的外键都是复合的。在你的映射文件中,必须为其他类也这样声明。例如,一个指向OrderLine的关联可能被这样映射:
<many-to-one name="orderLine"class="OrderLine">
<!-- the "class" attribute is optional, as usual-->
(注意在各个地方<column>标签都是column属性的替代写法。)
<set name="undeliveredOrderLines">
<key columnname="warehouseId"/>
<many-to-manyclass="OrderLine">
<set name="orderLines" inverse="true">
<one-to-manyclass="OrderLine"/>
(与通常一样,<one-to-many>元素不声明任何列.)
<key> <!-- a collection inherits the compositekey type -->
<list-indexcolumn="attemptId" base="1"/>
<composite-element class="DeliveryAttempt">
<dynamic-component name="userAttributes">
<propertyname="foo" column="FOO" type="string"/>
<propertyname="bar" column="BAR" type="integer"/>
<many-to-onename="baz" class="Baz" column="BAZ_ID"/>
- 每个类分层结构一张表(table per class hierarchy)
- 每个子类一张表(table per subclass)
- 每个具体类一张表(table per concrete class)
此外,Hibernate还支持第四种稍有不同的多态映射策略:
<subclassname="DomesticCat" extends="Cat"discriminator-value="D">
<propertyname="name" type="string"/>
9.1.1.每个类分层结构一张表(Table per class hierarchy)
<class name="Payment" table="PAYMENT">
<idname="id" type="long" column="PAYMENT_ID">
<discriminatorcolumn="PAYMENT_TYPE" type="string"/>
<propertyname="amount" column="AMOUNT"/>
<subclass name="CreditCardPayment"discriminator-value="CREDIT">
<propertyname="creditCardType" column="CCTYPE"/>
<subclassname="CashPayment" discriminator-value="CASH">
<subclassname="ChequePayment" discriminator-value="CHEQUE">
采用这种策略只需要一张表即可。它有一个很大的限制:要求那些由子类定义的字段,如CCTYPE,不能有非空(NOT NULL)约束。
9.1.2.每个子类一张表(Table per subclass)
对于上例中的几个类而言,采用“每个子类一张表”的映射策略,代码如下所示:
<class name="Payment" table="PAYMENT">
<idname="id" type="long" column="PAYMENT_ID">
<propertyname="amount" column="AMOUNT"/>
<joined-subclassname="CreditCardPayment" table="CREDIT_PAYMENT">
<joined-subclassname="CashPayment" table="CASH_PAYMENT">
<propertyname="creditCardType" column="CCTYPE"/>
<joined-subclassname="ChequePayment" table="CHEQUE_PAYMENT">
需要四张表。三个子类表通过主键关联到超类表(因而关系模型实际上是一对一关联)。
9.1.3.每个子类一张表(Table per subclass),使用辨别标志(Discriminator)
<class name="Payment" table="PAYMENT">
<idname="id" type="long" column="PAYMENT_ID">
<discriminatorcolumn="PAYMENT_TYPE" type="string"/>
<propertyname="amount" column="AMOUNT"/>
<subclassname="CreditCardPayment" discriminator-value="CREDIT">
<propertyname="creditCardType" column="CCTYPE"/>
<subclassname="CashPayment" discriminator-value="CASH">
<subclassname="ChequePayment" discriminator-value="CHEQUE">
<jointable="CHEQUE_PAYMENT" fetch="select">
可选的声明fetch="select",是用来告诉Hibernate,在查询超类时,不要使用外部连接(outer join)来抓取子类ChequePayment的数据。
9.1.4.混合使用“每个类分层结构一张表”和“每个子类一张表”
你甚至可以采取如下方法混和使用“每个类分层结构一张表”和“每个子类一张表”这两种策略:
<class name="Payment" table="PAYMENT">
<idname="id" type="long" column="PAYMENT_ID">
<discriminatorcolumn="PAYMENT_TYPE" type="string"/>
<propertyname="amount" column="AMOUNT"/>
<subclassname="CreditCardPayment" discriminator-value="CREDIT">
<propertyname="creditCardType" column="CCTYPE"/>
<subclassname="CashPayment" discriminator-value="CASH">
<subclassname="ChequePayment" discriminator-value="CHEQUE">
对上述任何一种映射策略而言,指向根类Payment的关联是使用<many-to-one>进行映射的。
<many-to-one name="payment"column="PAYMENT_ID" class="Payment"/>
9.1.5.每个具体类一张表(Table per concrete class)
对于“每个具体类一张表”的映射策略,可以采用两种方法。第一种方法是使用<union-subclass>。
<idname="id" type="long" column="PAYMENT_ID">
<propertyname="amount" column="AMOUNT"/>
<union-subclassname="CreditCardPayment" table="CREDIT_PAYMENT">
<propertyname="creditCardType" column="CCTYPE"/>
<union-subclassname="CashPayment" table="CASH_PAYMENT">
<union-subclassname="ChequePayment" table="CHEQUE_PAYMENT">
这里涉及三张与子类相关的表。每张表为对应类的所有属性(包括从超类继承的属性)定义相应字段。
假若超类是抽象类,请使用abstract="true"。当然,假若它不是抽象的,需要一个额外的表(上面的例子中,默认是PAYMENT),来保存超类的实例。
9.1.6. Tableper concrete class, using implicit polymorphism
9.1.6. Table per concrete class, using implicitpolymorphism
<class name="CreditCardPayment" table="CREDIT_PAYMENT">
<idname="id" type="long"column="CREDIT_PAYMENT_ID">
<propertyname="amount" column="CREDIT_AMOUNT"/>
<class name="CashPayment"table="CASH_PAYMENT">
<idname="id" type="long"column="CASH_PAYMENT_ID">
<propertyname="amount" column="CASH_AMOUNT"/>
<class name="ChequePayment"table="CHEQUE_PAYMENT">
<idname="id" type="long" column="CHEQUE_PAYMENT_ID">
<propertyname="amount" column="CHEQUE_AMOUNT"/>
这种方法的缺陷在于,在Hibernate执行多态查询时(polymorphicqueries)无法生成带UNION的SQL语句。
对于这种映射策略而言,通常用<any>来实现到Payment的多态关联映射。
<any name="payment" meta-type="string"id-type="long">
<meta-valuevalue="CREDIT" class="CreditCardPayment"/>
<meta-valuevalue="CASH" class="CashPayment"/>
<meta-valuevalue="CHEQUE" class="ChequePayment"/>
<class name="CreditCardPayment"table="CREDIT_PAYMENT">
<idname="id" type="long"column="CREDIT_PAYMENT_ID">
<discriminatorcolumn="CREDIT_CARD" type="string"/>
<propertyname="amount" column="CREDIT_AMOUNT"/>
<subclassname="MasterCardPayment" discriminator-value="MDC"/>
<subclassname="VisaPayment" discriminator-value="VISA"/>
<class name="NonelectronicTransaction"table="NONELECTRONIC_TXN">
<idname="id" type="long" column="TXN_ID">
<joined-subclassname="CashPayment" table="CASH_PAYMENT">
<propertyname="amount" column="CASH_AMOUNT"/>
<joined-subclassname="ChequePayment" table="CHEQUE_PAYMENT">
<propertyname="amount" column="CHEQUE_AMOUNT"/>
对“每个具体类映射一张表”(table per concrete-class)的映射策略而言,隐式多态的方式有一定的限制。而<union-subclass>映射的限制则没有那么严格。
下面表格中列出了在Hibernte中“每个具体类一张表”的策略和隐式多态的限制。
表9.1.继承映射特性(Features of inheritance mappings)
继承策略(Inheritance strategy) |
多态多对一 |
多态一对一 |
多态一对多 |
多态多对多 |
多态 load()/get() |
多态查询 |
多态连接(join) |
外连接(Outer join)读取 |
每个类分层结构一张表 |
<many-to-one> |
<one-to-one> |
<one-to-many> |
<many-to-many> |
s.get(Payment.class, id) |
from Payment p |
from Order o join o.payment p |
支持 |
每个子类一张表 |
<many-to-one> |
<one-to-one> |
<one-to-many> |
<many-to-many> |
s.get(Payment.class, id) |
from Payment p |
from Order o join o.payment p |
支持 |
每个具体类一张表(union-subclass) |
<many-to-one> |
<one-to-one> |
<one-to-many> (仅对于inverse="true"的情况) |
<many-to-many> |
s.get(Payment.class, id) |
from Payment p |
from Order o join o.payment p |
支持 |
每个具体类一张表(隐式多态) |
<any> |
不支持 |
不支持 |
<many-to-any> |
s.createCriteria(Payment.class).add( Restrictions.idEq(id) ).uniqueResult() |
from Payment p |
不支持 |
不支持 |
换句话说,使用Hibernate的开发者应该总是关注对象的状态(state),不必考虑SQL语句的执行。这部分细节已经由Hibernate掌管妥当,只有开发者在进行系统性能调优的时候才需要进行了解。
10.1. Hibernate对象状态(object states)
- 瞬时(Transient) - 由new操作符创建,且尚未与Hibernate Session 关联的对象被认定为瞬时(Transient)的。瞬时(Transient)对象不会被持久化到数据库中,也不会被赋予持久化标识(identifier)。 如果瞬时(Transient)对象在程序中没有被引用,它会被垃圾回收器(garbage collector)销毁。 使用Hibernate Session可以将其变为持久(Persistent)状态。(Hibernate会自动执行必要的SQL语句)
- 持久(Persistent) - 持久(Persistent)的实例在数据库中有对应的记录,并拥有一个持久化标识(identifier)。 持久(Persistent)的实例可能是刚被保存的,或刚被加载的,无论哪一种,按定义,它存在于相关联的Session作用范围内。 Hibernate会检测到处于持久(Persistent)状态的对象的任何改动,在当前操作单元(unit of work)执行完毕时将对象数据(state)与数据库同步(synchronize)。 开发者不需要手动执行UPDATE。将对象从持久(Persistent)状态变成瞬时(Transient)状态同样也不需要手动执行DELETE语句。
- 脱管(Detached) - 与持久(Persistent)对象关联的Session被关闭后,对象就变为脱管(Detached)的。 对脱管(Detached)对象的引用依然有效,对象可继续被修改。脱管(Detached)对象如果重新关联到某个新的Session上, 会再次转变为持久(Persistent)的(在Detached其间的改动将被持久化到数据库)。 这个功能使得一种编程模型,即中间会给用户思考时间(user think-time)的长时间运行的操作单元(unit of work)的编程模型成为可能。 我们称之为应用程序事务,即从用户观点看是一个操作单元(unit of work)。
接下来我们来细致的讨论下状态(states)及状态间的转换(statetransitions)(以及触发状态转换的Hibernate方法)。
DomesticCat fritz = new DomesticCat();
Long generatedId = (Long) sess.save(fritz);
DomesticCat pk = new DomesticCat();
pk.setKittens( new HashSet() );
sess.save( pk, new Long(1234) );
Cat fritz = (Cat) sess.load(Cat.class, generatedId);
// you need to wrap primitive identifiers
DomesticCat pk = (DomesticCat) sess.load( DomesticCat.class, newLong(id) );
此外, 你可以把数据(state)加载到指定的对象实例上(覆盖掉该实例原来的数据)。
sess.load( cat, new Long(pkId) );
Set kittens = cat.getKittens();
如果你不确定是否有匹配的行存在,应该使用get()方法,它会立刻访问数据库,如果没有对应的记录,会返回null。
Cat cat = (Cat) sess.get(Cat.class, id);
你甚至可以选用某个LockMode,用SQL的SELECT... FOR UPDATE装载对象。请查阅API文档以获取更多信息。
Cat cat = (Cat) sess.get(Cat.class, id, LockMode.UPGRADE);
注意,任何关联的对象或者包含的集合都不会被以FOR UPDATE方式返回,除非你指定了lock或者all作为关联(association)的级联风格(cascadestyle)。
任何时候都可以使用refresh()方法强迫装载对象和它的集合。如果你使用数据库触发器功能来处理对象的某些属性,这个方法就很有用了。
sess.flush(); //force the SQL INSERT
sess.refresh(cat); //re-read the state (after the triggerexecutes)
List cats = session.createQuery(
"from Cat as catwhere cat.birthdate < ?")
List mothers = session.createQuery(
"select motherfrom Cat as cat join cat.mother as mother where cat.name = ?")
List kittens = session.createQuery(
"from Cat as catwhere cat.mother = ?")
Cat mother = (Cat) session.createQuery(
"selectcat.mother from Cat as cat where cat = ?")
Query mothersWithKittens = (Cat) session.createQuery(
"select motherfrom Cat as mother left join fetch mother.kittens");
Set uniqueMothers = new HashSet(mothersWithKittens.list());
10.4.1.1.迭代式获取结果(Iterating results)
Iterator iter = sess.createQuery("from eg.Qux q order byq.likeliness").iterate();
Qux qux = (Qux)iter.next(); // fetch the object
// something wecouldnt express in the query
if (qux.calculateComplicatedAlgorithm() ) {
// dont need toprocess the rest
(译注:元组(tuples)指一条结果行包含多个对象)Hibernate查询有时返回元组(tuples),每个元组(tuples)以数组的形式返回:
Iterator kittensAndMothers = sess.createQuery(
"selectkitten, mother from Cat kitten join kitten.mother mother")
while ( kittensAndMothers.hasNext() ) {
Object[] tuple =(Object[]) kittensAndMothers.next();
查询可在select从句中指定类的属性,甚至可以调用SQL统计(aggregate)函数。属性或统计结果被认定为"标量(Scalar)"的结果(而不是持久(persistent state)的实体)。
Iterator results = sess.createQuery(
"selectcat.color, min(cat.birthdate), count(cat) from Cat cat " +
Object[] row =(Object[]) results.next();
Integer count =(Integer) row[2];
Query q = sess.createQuery("from DomesticCat cat wherecat.name = :name");
Query q = sess.createQuery("from DomesticCat cat wherecat.name = ?");
Query q = sess.createQuery("from DomesticCat cat wherecat.name in (:namesList)");
q.setParameterList("namesList", names);
如果你需要指定结果集的范围(希望返回的最大行数/或开始的行数),应该使用Query接口提供的方法:
Query q = sess.createQuery("from DomesticCat cat");
Hibernate 知道如何将这个有限定条件的查询转换成你的数据库的原生SQL(native SQL)。
10.4.1.6.可滚动遍历(Scrollable iteration)
如果你的JDBC驱动支持可滚动的ResuleSet,Query接口可以使用ScrollableResults,允许你在查询结果中灵活游走。
Query q = sess.createQuery("select cat.name, cat fromDomesticCat cat " +
ScrollableResults cats = q.scroll();
// find the first nameon each page of an alphabetical list of cats by name
firstNamesOfPages =new ArrayList();
String name =cats.getString(0);
while (cats.scroll(PAGE_SIZE) );
// Now get the first page of cats
while( ( PAGE_SIZE> i++ ) && cats.next() ) pageOfCats.add( cats.get(1) );
请注意,使用此功能需要保持数据库连接(以及游标(cursor))处于一直打开状态。如果你需要断开连接使用分页功能,请使用setMaxResult()/setFirstResult()
10.4.1.7.外置命名查询(Externalizing named queries)
你可以在映射文件中定义命名查询(named queries)。(如果你的查询串中包含可能被解释为XML标记(markup)的字符,别忘了用CDATA包裹起来。)
<queryname="eg.DomesticCat.by.name.and.minimum.weight"><![CDATA[
参数绑定及执行以编程方式(programatically)完成:
Query q =sess.getNamedQuery("eg.DomesticCat.by.name.and.minimum.weight");
请注意实际的程序代码与所用的查询语言无关,你也可在元数据中定义原生SQL(native SQL)查询,或将原有的其他的查询语句放在配置文件中,这样就可以让Hibernate统一管理,达到迁移的目的。
集合过滤器(filter)是一种用于一个持久化集合或者数组的特殊的查询。查询字符串中可以使用"this"来引用集合中的当前元素。
Collection blackKittens = session.createFilter(
.setParameter(Color.BLACK, Hibernate.custom(ColorUserType.class) )
请注意过滤器(filter)并不需要from子句(当然需要的话它们也可以加上)。过滤器(filter)不限定于只能返回集合元素本身。
Collection blackKittenMates = session.createFilter(
"select this.matewhere this.color = eg.Color.BLACK.intValue")
即使无条件的过滤器(filter)也是有意义的。例如,用于加载一个大集合的子集:
Collection tenKittens = session.createFilter(
.setFirstResult(0).setMaxResults(10)
HQL极为强大,但是有些人希望能够动态的使用一种面向对象API创建查询,而非在他们的Java代码中嵌入字符串。对于那部分人来说,Hibernate提供了直观的Criteria查询API。
Criteria crit = session.createCriteria(Cat.class);
crit.add( Expression.eq( "color", eg.Color.BLACK ) );
Criteria以及相关的样例(Example)API将会再第15章条件查询(Criteria Queries)中详细讨论。
List cats = session.createSQLQuery(
"SELECT {cat.*}FROM CAT {cat} WHERE ROWNUM<10",
List cats = session.createSQLQuery(
"SELECT {cat}.IDAS {cat.id}, {cat}.SEX AS {cat.sex}, " +
"{cat}.MATE AS {cat.mate}, {cat}.SUBCLASS AS {cat.class}, ..." +
"FROM CAT {cat}WHERE ROWNUM<10",
和Hibernate查询一样,SQL查询也可以包含命名参数和占位参数。可以在第16章Native SQL查询找到更多关于Hibernate中原生SQL(nativeSQL)的信息。
DomesticCat cat = (DomesticCat) sess.load( Cat.class, newLong(69) );
sess.flush(); // changesto cat are automatically detected and persisted
很多程序需要在某个事务中获取对象,然后将对象发送到界面层去操作,最后在一个新的事务保存所做的修改。在高并发访问的环境中使用这种方式,通常使用附带版本信息的数据来保证这些“长“工作单元之间的隔离。
Hibernate通过提供Session.update()或Session.merge()重新关联脱管实例的办法来支持这种模型。
Cat cat = (Cat) firstSession.load(Cat.class, catId);
Cat potentialMate = new Cat();
firstSession.save(potentialMate);
// in a higher layer of the application
secondSession.update(cat); // update cat
secondSession.update(mate); // update mate
如果具有catId持久化标识的Cat之前已经被另一Session(secondSession)装载了,应用程序进行重关联操作(reattach)的时候会抛出一个异常。
lock()方法也允许程序重新关联某个对象到一个新session上。不过,该脱管(detached)的对象必须是没有修改过的!
sess.lock(fritz, LockMode.NONE);
//do a version check, then reassociate:
sess.lock(izi, LockMode.READ);
//do a version check, using SELECT ... FOR UPDATE, thenreassociate:
sess.lock(pk, LockMode.UPGRADE);
请注意,lock()可以搭配多种LockMode,更多信息请阅读API文档以及关于事务处理(transactionhandling)的章节。重新关联不是lock()的唯一用途。
其他用于长时间工作单元的模型会在第11.3节“乐观并发控制(Optimistic concurrency control)”中讨论。
Cat cat = (Cat) firstSession.load(Cat.class, catID);
// in a higher tier of the application
secondSession.saveOrUpdate(cat); // update existing state (cat has a non-nullid)
secondSession.saveOrUpdate(mate); // save the new instance (mate has a null id)
通常下面的场景会使用update()或saveOrUpdate():
- 如果对象已经在本session中持久化了,不做任何事
- 如果另一个与本session关联的对象拥有相同的持久化标识(identifier),抛出一个异常
- 如果对象没有持久化标识(identifier)属性,对其调用save()
- 如果对象的持久标识(identifier)表明其是一个新实例化的对象,对其调用save()
- 如果对象是附带版本信息的(通过<version>或<timestamp>) 并且版本属性的值表明其是一个新实例化的对象,save()它。
- 否则update() 这个对象
- 如果session中存在相同持久化标识(identifier)的实例,用用户给出的对象的状态覆盖旧有的持久实例
- 如果session没有相应的持久实例,则尝试从数据库中加载,或创建新的持久化实例
- 最后返回该持久实例
- 用户给出的这个对象没有被关联到session上,它依旧是脱管的
你可以用你喜欢的任何顺序删除对象,不用担心外键约束冲突。当然,如果你搞错了顺序,还是有可能引发在外键字段定义的NOT NULL约束冲突。例如你删除了父对象,但是忘记删除孩子们。
偶尔会用到不重新生成持久化标识(identifier),将持久实例以及其关联的实例持久到不同的数据库中的操作。
//retrieve a cat from one database
Session session1 = factory1.openSession();
Transaction tx1 = session1.beginTransaction();
Cat cat = session1.get(Cat.class, catId);
//reconcile with a second database
Session session2 = factory2.openSession();
Transaction tx2 = session2.beginTransaction();
session2.replicate(cat, ReplicationMode.LATEST_VERSION);
ReplicationMode决定在和数据库中已存在记录由冲突时,replicate()如何处理。
- ReplicationMode.IGNORE - 忽略它
- ReplicationMode.OVERWRITE - 覆盖相同的行
- ReplicationMode.EXCEPTION - 抛出异常
- ReplicationMode.LATEST_VERSION - 如果当前的版本较新,则覆盖,否则忽略
每间隔一段时间,Session会执行一些必需的SQL语句来把内存中的对象的状态同步到JDBC连接中。这个过程被称为刷出(flush),默认会在下面的时间点执行:
- 所有对实体进行插入的语句,其顺序按照对象执行Session.save()的时间顺序
- 所有对实体进行更新的语句
- 所有进行集合删除的语句
- 所有对集合元素进行删除,更新或者插入的语句
- 所有进行集合插入的语句
- 所有对实体进行删除的语句,其顺序按照对象执行Session.delete()的时间顺序
(有一个例外是,如果对象使用native方式来生成ID(持久化标识)的话,它们一执行save就会被插入。)
Transaction tx = sess.beginTransaction();
sess.setFlushMode(FlushMode.COMMIT); // allow queries to returnstale state
Cat izi = (Cat) sess.load(Cat.class, id);
sess.find("from Cat as cat left outer join cat.kittenskitten");
// change to izi is not flushed!
刷出(flush)期间,可能会抛出异常。(例如一个DML操作违反了约束)异常处理涉及到对Hibernate事务性行为的理解,因此我们将在第11章事务和并发中讨论。
10.11.传播性持久化(transitive persistence)
对每一个对象都要执行保存,删除或重关联操作让人感觉有点麻烦,尤其是在处理许多彼此关联的对象的时候。一个常见的例子是父子关系。考虑下面的例子:
<one-to-one name="person"cascade="persist"/>
<one-to-one name="person"cascade="persist,delete,lock"/>
你可以使用cascade="all"来指定全部操作都顺着关联关系级联(cascaded)。默认值是cascade="none",即任何操作都不会被级联(cascaded)。
注意有一个特殊的级联风格(cascade style)delete-orphan,只应用于one-to-many关联,表明delete()操作应该被应用于所有从关联中删除的对象。
- 通常在<many-to-one>或<many-to-many>关系中应用级联(cascade)没什么意义。 级联(cascade)通常在 <one-to-one>和<one-to-many>关系中比较有用。
- 如果子对象的寿命限定在父亲对象的寿命之内,可通过指定cascade="all,delete-orphan"将其变为自动生命周期管理的对象(lifecycle object)。
- 其他情况,你可根本不需要级联(cascade)。但是如果你认为你会经常在某个事务中同时用到父对象与子对象,并且你希望少打点儿字,可以考虑使用cascade="persist,merge,save-update"。
- 如果父对象被persist(),那么所有子对象也会被persist()
- 如果父对象被merge(),那么所有子对象也会被merge()
- 如果父对象被save(),update()或 saveOrUpdate(),那么所有子对象则会被saveOrUpdate()
- 如果某个持久的父对象引用了瞬时(transient)或者脱管(detached)的子对象,那么子对象将会被saveOrUpdate()
- 如果父对象被删除,那么所有子对象也会被delete()
- 除非被标记为cascade="delete-orphan"(删除“孤儿”模式,此时不被任何一个父对象引用的子对象会被删除), 否则子对象失掉父对象对其的引用时,什么事也不会发生。 如果有特殊需要,应用程序可通过显式调用delete()删除子对象。
Hibernate提供了ClassMetadata接口,CollectionMetadata接口和Type层次体系来访问元数据。可以通过SessionFactory获取元数据接口的实例。
ClassMetadata catMeta =sessionfactory.getClassMetadata(Cat.class);
Object[] propertyValues = catMeta.getPropertyValues(fritz);
String[] propertyNames = catMeta.getPropertyNames();
Type[] propertyTypes = catMeta.getPropertyTypes();
// get a Map of all properties which are not collections orassociations
Map namedValues = new HashMap();
for ( int i=0; i<propertyNames.length; i++ ) {
if (!propertyTypes[i].isEntityType() &&!propertyTypes[i].isCollectionType() ) {
namedValues.put(propertyNames[i], propertyValues[i] );
除了对自动乐观并发控制提供版本管理,针对行级悲观锁定,Hibernate也提供了辅助的(较小的)API,它使用了SELECT FOR UPDATE的SQL语法。本章后面会讨论乐观并发控制和这个API。
我们从Configuration层、SessionFactory层, 和Session层开始讨论Hibernate的并行控制、数据库事务和应用程序的长事务。
11.1. Session和事务范围(transaction scope)
SessionFactory对象的创建代价很昂贵,它是线程安全的对象,它为所有的应用程序线程所共享。它只创建一次,通常是在应用程序启动的时候,由一个Configuraion的实例来创建。
- 在界面的第一屏,打开对话框,用户所看到的数据是被一个特定的 Session 和数据 库事务载入(load)的。用户可以随意修改对话框中的数据对象。
- 5分钟后,用户点击“保存”,期望所做出的修改被持久化;同时他也期望自己是唯一修改这个信息的人,不会出现 修改冲突。
从用户的角度来看,我们把这个操作单元称为长时间运行的对话(conversation),或者(or应用事务,application transaction)。在你的应用程序中,可以有很多种方法来实现它。
- 自动版本化 - Hibernate能够自动进行乐观并发控制 ,如果在用户思考 的过程中发生并发修改,Hibernate能够自动检测到。一般我们只在对话结束时才检查。
- 脱管对象(Detached Objects)- 如果你决定采用前面已经讨论过的 session-per-request模式,所有载入的实例在用户思考的过程 中都处于与Session脱离的状态。Hibernate允许你把与Session脱离的对象重新关联到Session 上,并且对修改进行持久化,这种模式被称为 session-per-request-with-detached-objects。自动版本化被用来隔离并发修改。
- Extended (or Long) Session - Hibernate 的Session 可以在数据库事务提交之后和底层的JDBC连接断开,当一个新的客户端请求到来的时候,它又重新连接上底层的 JDBC连接。这种模式被称之为session-per-conversation,这种情况可 能会造成不必要的Session和JDBC连接的重新关联。自动版本化被用来隔离并发修改, Session通常不允许自动flush,而是明确flush。
session-per-request-with-detached-objects和session-per-conversation各有优缺点,我们在本章后面乐观并发控制那部分再进行讨论。
11.1.3.关注对象标识(Considering object identity)
应用程序可能在两个不同的Session中并发访问同一持久化状态,但是,一个持久化类的实例无法在两个Session中共享。因此有两种不同的标识语义:
foo.getId().equals(bar.getId() )
- Session 对象是非线程安全的。如果一个Session 实例允许共享的话,那些支持并发运行的东东,例如HTTP request,session beans,或者是 Swing workers,将会导致出现资源争用(race condition)。如果在HttpSession中有 Hibernate 的Session的话(稍后讨论),你应该考虑同步访问你的Http session。 否则,只要用户足够快的点击浏览器的“刷新”,就会导致两个并发运行线程使用同一个 Session。
- 一个由Hibernate抛出的异常意味着你必须立即回滚数据库事务,并立即关闭Session (稍后会展开讨论)。如果你的Session绑定到一个应用程序上,你必 须停止该应用程序。回滚数据库事务并不会把你的业务对象退回到事务启动时候的状态。这 意味着数据库状态和业务对象状态不同步。通常情况下,这不是什么问题,因为异常是不可 恢复的,你必须在回滚之后重新开始执行。
- Session 缓存了处于持久化状态的每个对象(Hibernate会监视和检查脏数据)。 这意味着,如果你让Session打开很长一段时间,或是仅仅载入了过多的数据, Session占用的内存会一直增长,直到抛出OutOfMemoryException异常。这个 问题的一个解决方法是调用clear() 和evict()来管理 Session的缓存,但是如果你需要大批量数据操作的话,最好考虑 使用存储过程。在第13章批量处理(Batch processing)中有一些解决方案。在用户会话期间一直保持 Session打开也意味着出现脏数据的可能性很高。
session的同步(flush,刷出)前面已经讨论过了,我们现在进一步考察在托管和非托管环境下的事务声明和异常处理。
如果Hibernat持久层运行在一个非托管环境中,数据库连接通常由Hibernate的简单(即非DataSource)连接池机制来处理。session/transaction处理方式如下所示:
//Non-managed environment idiom
Session sess = factory.openSession();
throw e; // or displayerror message
更加灵活的方案是Hibernate内置的"currentsession"上下文管理,前文已经讲过:
// Non-managed environment idiom with getCurrentSession()
factory.getCurrentSession().beginTransaction();
factory.getCurrentSession().getTransaction().commit();
factory.getCurrentSession().getTransaction().rollback();
throw e; // or displayerror message
如果你使用bean管理事务(BMT),可以通过使用Hibernate的TransactionAPI来告诉应用服务器启动和结束BMT事务。因此,事务管理代码和在非托管环境下是一样的。
Session sess = factory.openSession();
throw e; // or displayerror message
如果你希望使用与事务绑定的Session,也就是使用getCurrentSession()来简化上下文管理,你将不得不直接使用JTAUserTransactionAPI。
// BMT idiom with getCurrentSession()
UserTransaction tx =(UserTransaction)new InitialContext()
.lookup("java:comp/UserTransaction");
// Do some work onSession bound to transaction
factory.getCurrentSession().load(...);
factory.getCurrentSession().persist(...);
throw e; // or displayerror message
在CMT方式下,事务声明是在sessionbean的部署描述符中,而不需要编程。因此,代码被简化为:
Session sess = factory.getCurrentSession();
- JDBCConnectionException - 指明底层的JDBC通讯出现错误
- SQLGrammarException - 指明发送的SQL语句的语法或者格式错误
- ConstraintViolationException - 指明某种类型的约束违例错误
- LockAcquisitionException - 指明了在执行请求操作时,获取 所需的锁级别时出现的错误。
- GenericJDBCException - 不属于任何其他种类的原生异常
Session sess = factory.openSession();
//set transactiontimeout to 3 seconds
sess.getTransaction().setTimeout(3);
sess.getTransaction().begin();
sess.getTransaction().commit()
sess.getTransaction().rollback();
throw e; // or displayerror message
注意setTimeout()不应该在CMT bean中调用,此时事务超时值应该是被声明式定义的。
11.3.乐观并发控制(Optimistic concurrency control)
11.3.1.应用程序级别的版本检查(Application version checking)
// foo is an instance loaded by a previous Session
session = factory.openSession();
Transaction t = session.beginTransaction();
int oldVersion = foo.getVersion();
session.load( foo, foo.getKey() ); // load the current state
if ( oldVersion!=foo.getVersion ) throw newStaleObjectStateException();
version属性使用<version>来映射,如果对象是脏数据,在同步的时候,Hibernate会自动增加版本号。
// foo is an instance loaded earlier by the old session
Transaction t = session.beginTransaction(); // Obtain a new JDBCconnection, start transaction
session.flush(); //Only for last transaction in conversation
t.commit(); //Also return JDBC connection
session.close(); //Only for last transaction in conversation
(注意,早期的Hibernate版本需要明确的对Session进行disconnec和reconnect。这些方法现在已经过时了,打开事务和关闭事务会起到同样的效果。)
11.3.3.脱管对象(deatched object)和自动版本化
// foo is an instance loaded by a previous Session
session = factory.openSession();
Transaction t = session.beginTransaction();
session.saveOrUpdate(foo); // Use merge() if "foo"might have been loaded already
Hibernate会再一次在同步的时候检查对象实例的版本,如果发生更新冲突,就抛出异常。
如果你确信对象没有被修改过,你也可以调用lock()来设置LockMode.READ(绕过所有的缓存,执行版本检查),从而取代update()操作。
对于特定的属性和集合,通过为它们设置映射属性optimistic-lock的值为false,来禁止Hibernate的版本自动增加。这样的话,如果该属性脏数据,Hibernate将不再增加版本号。
有些情况下,只要更改不发生交错,并发修改也是允许的。当你在<class>的映射中设置optimistic-lock="dirty",Hibernate在同步的时候将只比较有脏数据的字段。
11.4.悲观锁定(Pessimistic Locking)
Hibernate总是使用数据库的锁定机制,从不在内存中锁定对象!
类LockMode定义了Hibernate所需的不同的锁定级别。一个锁定可以通过以下的机制来设置:
- 当Hibernate更新或者插入一行记录的时候,锁定级别自动设置为LockMode.WRITE。
- 当用户显式的使用数据库支持的SQL格式SELECT ... FOR UPDATE 发送SQL的时候,锁定级别设置为LockMode.UPGRADE
- 当用户显式的使用Oracle数据库的SQL语句SELECT ... FOR UPDATE NOWAIT 的时候,锁定级别设置LockMode.UPGRADE_NOWAIT
- 当Hibernate在“可重复读”或者是“序列化”数据库隔离级别下读取数据的时候,锁定模式 自动设置为LockMode.READ。这种模式也可以通过用户显式指定进行设置。
- LockMode.NONE 代表无需锁定。在Transaction结束时, 所有的对象都切换到该模式上来。与session相关联的对象通过调用update() 或者saveOrUpdate()脱离该模式。
如果数据库不支持用户设置的锁定模式,Hibernate将使用适当的替代模式(而不是扔出异常)。这一点可以确保应用程序的可移植性。
11.5.连接释放模式(Connection Release Modes)
- ON_CLOSE - 基本上就是上面提到的老式行为。Hibernate session在第一次需要进行JDBC操作的时候获取连接,然后持有它,直到session关闭。
- AFTER_TRANSACTION - 在org.hibernate.Transaction结束后释放连接。
- AFTER_STATEMENT (也被称做积极释放) - 在每一条语句被执行后就释放连接。但假若语句留下了与session相关的资源,那就不会被释放。目前唯一的这种情形就是使用org.hibernate.ScrollableResults。
hibernate.connection.release_mode配置参数用来指定使用哪一种释放模式。可能的值有:
- auto(默认) - 这一选择把释放模式委派给org.hibernate.transaction.TransactionFactory.getDefaultReleaseMode()方法。对JTATransactionFactory来说,它会返回ConnectionReleaseMode.AFTER_STATEMENT;对JDBCTransactionFactory来说,则是ConnectionReleaseMode.AFTER_TRANSACTION。很少需要修改这一默认行为,因为假若设置不当,就会带来bug,或者给用户代码带来误导。
- on_close - 使用 ConnectionReleaseMode.ON_CLOSE. 这种方式是为了向下兼容的,但是已经完全不被鼓励使用了。
- after_transaction - 使用ConnectionReleaseMode.AFTER_TRANSACTION。这一设置不应该在JTA环境下使用。也要注意,使用ConnectionReleaseMode.AFTER_TRANSACTION的时候,假若session 处于auto-commit状态,连接会像AFTER_STATEMENT那样被释放。
- after_statement - 使用ConnectionReleaseMode.AFTER_STATEMENT。除此之外,会查询配置的ConnectionProvider,是否它支持这一设置((supportsAggressiveRelease()))。假若不支持,释放模式会被设置为ConnectionReleaseMode.AFTER_TRANSACTION。只有在你每次调用ConnectionProvider.getConnection()获取底层JDBC连接的时候,都可以确信获得同一个连接的时候,这一设置才是安全的;或者在auto-commit环境中,你可以不管是否每次都获得同一个连接的时候,这才是安全的。
第12章 拦截器与事件(Interceptors and events)
应用程序能够响应Hibernate内部产生的特定事件是非常有用的。这样就允许实现某些通用的功能以及允许对Hibernate功能进行扩展。
你可以直接实现Interceptor接口,也可以(最好)继承自EmptyInterceptor。
import org.hibernate.EmptyInterceptor;
import org.hibernate.Transaction;
import org.hibernate.type.Type;
public class AuditInterceptor extends EmptyInterceptor {
public voidonDelete(Object entity,
public booleanonFlushDirty(Object entity,
if ( entityinstanceof Auditable ) {
for ( int i=0;i < propertyNames.length; i++ ) {
if ("lastUpdateTimestamp".equals( propertyNames[i] ) ) {
public booleanonLoad(Object entity,
if ( entityinstanceof Auditable ) {
public booleanonSave(Object entity,
if ( entityinstanceof Auditable ) {
for ( int i=0;i<propertyNames.length; i++ ) {
if ("createTimestamp".equals( propertyNames[i] ) ) {
public voidafterTransactionCompletion(Transaction tx) {
System.out.println("Creations: " + creates + ", Updates:" + updates, "Loads: " + loads);
拦截器可以有两种:Session范围内的,和SessionFactory范围内的。
当使用某个重载的SessionFactory.openSession()使用Interceptor作为参数调用打开一个session的时候,就指定了Session范围内的拦截器。
Session session = sf.openSession( new AuditInterceptor() );
new Configuration().setInterceptor( new AuditInterceptor() );
如果需要响应持久层的某些特殊事件,你也可以使用Hibernate3的事件框架。该事件系统可以用来替代拦截器,也可以作为拦截器的补充来使用。
监听器应该被看作是单例(singleton)对象,也就是说,所有同类型的事件的处理共享同一个监听器实例,因此监听器不应该保存任何状态(也就是不应该使用成员变量)。
public class MyLoadListener implements LoadEventListener {
// this is the singlemethod defined by the LoadEventListener interface
public voidonLoad(LoadEvent event, LoadEventListener.LoadType loadType)
if (!MySecurity.isAuthorized( event.getEntityClassName(), event.getEntityId() ) ) {
throwMySecurityException("Unauthorized access");
你还需要修改一处配置,来告诉Hibernate,除了默认的监听器,还要附加选定的监听器。
<listenerclass="com.eg.MyLoadListener"/>
<listenerclass="org.hibernate.event.def.DefaultLoadEventListener"/>
Configuration cfg = new Configuration();
LoadEventListener[] stack = { new MyLoadListener(), newDefaultLoadEventListener() };
cfg.EventListeners().setLoadEventListeners(stack);
首先,你必须要配置适当的事件监听器(event listener),来激活使用JAAS管理授权的功能。
<listener type="pre-delete"class="org.hibernate.secure.JACCPreDeleteEventListener"/>
<listener type="pre-update" class="org.hibernate.secure.JACCPreUpdateEventListener"/>
<listener type="pre-insert"class="org.hibernate.secure.JACCPreInsertEventListener"/>
<listener type="pre-load"class="org.hibernate.secure.JACCPreLoadEventListener"/>
接下来,仍然在hibernate.cfg.xml文件中,绑定角色的权限:
<grant role="admin" entity-name="User"actions="insert,update,read"/>
<grant role="su" entity-name="User"actions="*"/>
这些角色的名字就是你的JACC provider所定义的角色的名字。
使用Hibernate将 100000 条记录插入到数据库的一个很自然的做法可能是这样的
Session session = sessionFactory.openSession();
Transaction tx = session.beginTransaction();
for ( int i=0; i<100000; i++ ) {
Customer customer =new Customer(.....);
hibernate.cache.use_second_level_cache false
但是,这不是绝对必须的,因为我们可以显式设置CacheMode来关闭与二级缓存的交互。
如果要将很多对象持久化,你必须通过经常的调用flush()以及稍后调用clear()来控制第一级缓存的大小。
Session session = sessionFactory.openSession();
Transaction tx = session.beginTransaction();
for ( int i=0; i<100000; i++ ) {
Customer customer =new Customer(.....);
if ( i % 20 == 0 ) {//20, same as the JDBC batch size //20,与JDBC批量设置相同
//flush a batch ofinserts and release memory:
此方法同样适用于检索和更新数据。此外,在进行会返回很多行数据的查询时,你需要使用scroll()方法以便充分利用服务器端游标所带来的好处。
Session session = sessionFactory.openSession();
Transaction tx = session.beginTransaction();
ScrollableResults customers =session.getNamedQuery("GetCustomers")
.setCacheMode(CacheMode.IGNORE)
.scroll(ScrollMode.FORWARD_ONLY);
Customer customer =(Customer) customers.get(0);
//flush a batch ofupdates and release memory:
13.3. StatelessSession (无状态session)接口
StatelessSession session =sessionFactory.openStatelessSession();
Transaction tx = session.beginTransaction();
ScrollableResults customers = session.getNamedQuery("GetCustomers")
.scroll(ScrollMode.FORWARD_ONLY);
Customer customer =(Customer) customers.get(0);
注意在上面的例子中,查询返回的Customer实例立即被脱管(detach)。它们与任何持久化上下文都没有关系。
13.4. DML(数据操作语言)风格的操作(DML-styleoperations)
UPDATE和DELETE语句的语法为:(UPDATE | DELETE ) FROM? EntityName (WHERE where_conditions)?有几点说明:
- 在FROM子句(from-clause)中,FROM关键字是可选的
- 在FROM子句(from-clause)中只能有一个实体名,它可以是别名。如果实体名是别名,那么任何被引用的属性都必须加上此别名的前缀;如果不是别名,那么任何有前缀的属性引用都是非法的。
- 不能在大批量HQL语句中使用第14.4节“join 语法的形式”(显式或者隐式的都不行)。不过在WHERE子句中可以使用子查询。可以在where子句中使用子查询,子查询本身可以包含join。
- 整个WHERE子句是可选的。
举个例子,使用Query.executeUpdate()方法执行一个HQLUPDATE语句(: (方法命名是来源于JDBC'sPreparedStatement.executeUpdate()):
Session session = sessionFactory.openSession();
Transactiontx = session.beginTransaction();
StringhqlUpdate = "update Customer c set c.name = :newName where c.name =:oldName";
// or StringhqlUpdate = "update Customer set name = :newName where name =:oldName";
intupdatedEntities = s.createQuery( hqlUpdate )
.setString( "newName",newName )
.setString( "oldName",oldName )
.executeUpdate();
tx.commit();
session.close();
HQLUPDATE语句,默认不会影响更新实体的第5.1.7节“版本(version)(可选)”或者第5.1.8节“timestamp (可选)”属性值。这和EJB3规范是一致的。但是,通过使用versioned update,你可以强制Hibernate正确的重置version或者timestamp属性值。这通过在UPDATE关键字后面增加VERSIONED关键字来实现的。
Session session = sessionFactory.openSession();
Transaction tx = session.beginTransaction();
String hqlVersionedUpdate = "update versioned Customer setname = :newName where name = :oldName";
int updatedEntities = s.createQuery( hqlUpdate )
.setString("newName", newName )
.setString("oldName", oldName )
.executeUpdate();
tx.commit();
session.close();
注意,自定义的版本类型(org.hibernate.usertype.UserVersionType)不允许和updateversioned语句联用。
执行一个HQLDELETE,同样使用Query.executeUpdate()方法:
Session session = sessionFactory.openSession();
Transactiontx = session.beginTransaction();
StringhqlDelete = "delete Customer c where c.name = :oldName";
// or StringhqlDelete = "delete Customer where name = :oldName";
intdeletedEntities = s.createQuery( hqlDelete )
.setString( "oldName",oldName )
.executeUpdate();
tx.commit();
session.close();
由Query.executeUpdate()方法返回的整型值表明了受此操作影响的记录数量。注意这个数值可能与数据库中被(最后一条SQL语句)影响了的“行”数有关,也可能没有。一个大批量HQL操作可能导致多条实际的SQL语句被执行,举个例子,对joined-subclass映射方式的类进行的此类操作。这个返回值代表了实际被语句影响了的记录数量。在那个joined-subclass的例子中,对一个子类的删除实际上可能不仅仅会删除子类映射到的表而且会影响“根”表,还有可能影响与之有继承关系的joined-subclass映射方式的子类的表。
INSERT语句的伪码是:INSERT INTO EntityName properties_listselect_statement. 要注意的是:
- 只支持INSERT INTO ... SELECT ...形式,不支持INSERT INTO ... VALUES ...形式.
properties_list和SQLINSERT语句中的字段定义(column speficiation)类似。对参与继承树映射的实体而言,只有直接定义在给定的类级别的属性才能直接在properties_list中使用。超类的属性不被支持;子类的属性无意义。换句话说,INSERT天生不支持多态。
- select_statement可以是任何合法的HQL选择查询,不过要保证返回类型必须和要插入的类型完全匹配。目前,这一检查是在查询编译的时候进行的,而不是把它交给数据库。注意,在HibernateType间如果只是等价(equivalent)而非相等(equal),会导致问题。定义为org.hibernate.type.DateType和org.hibernate.type.TimestampType的两个属性可能会产生类型不匹配错误,虽然数据库级可能不加区分或者可以处理这种转换。
- 对id属性来说,insert语句给你两个选择。你可以明确地在properties_list表中指定id属性(这样它的值是从对应的select表达式中获得),或者在properties_list中省略它(此时使用生成指)。后一种选择只有当使用在数据库中生成值的id产生器时才能使用;如果是“内存”中计算的类型生成器,在解析时会抛出一个异常。注意,为了说明这一问题,数据库产生值的生成器是org.hibernate.id.SequenceGenerator(和它的子类),以及任何org.hibernate.id.PostInsertIdentifierGenerator接口的实现。这儿最值得注意的意外是org.hibernate.id.TableHiLoGenerator,它不能在此使用,因为它没有得到其值的途径。
- 对映射为version 或 timestamp的属性来说,insert语句也给你两个选择,你可以在properties_list表中指定(此时其值从对应的select表达式中获得),或者在properties_list中省略它(此时,使用在org.hibernate.type.VersionType 中定义的seed value(种子值))。
执行HQLINSERT语句的例子如下:
Session session = sessionFactory.openSession();
Transaction tx = session.beginTransaction();
String hqlInsert = "insert into DelinquentAccount (id,name) select c.id, c.name from Customer c where ...";
int createdEntities = s.createQuery( hqlInsert )
.executeUpdate();
tx.commit();
session.close();
Hibernate配备了一种非常强大的查询语言,这种语言看上去很像SQL。但是不要被语法结构上的相似所迷惑,HQL是非常有意识的被设计为完全面向对象的查询,它可以理解如继承、多态和关联之类的概念。
本手册中的HQL关键字将使用小写字母. 很多用户发现使用完全大写的关键字会使查询语句的可读性更强, 但我们发现,当把查询语句嵌入到Java语句中的时候使用大写关键字比较难看。
该子句简单的返回eg.Cat类的所有实例。通常我们不需要使用类的全限定名, 因为auto-import(自动引入)是缺省的情况。所以我们几乎只使用如下的简单写法:
大多数情况下, 你需要指定一个别名, 原因是你可能需要在查询语句的其它部分引用到Cat
这个语句把别名cat指定给类Cat的实例, 这样我们就可以在随后的查询中使用此别名了。关键字as是可选的,我们也可以这样写:
子句中可以同时出现多个类, 其查询结果是产生一个笛卡儿积或产生跨表的连接。
from Formula as form, Parameter as param
查询语句中别名的开头部分小写被认为是实践中的好习惯,这样做与Java变量的命名标准保持了一致 (比如,domesticCat)。
我们也可以为相关联的实体甚至是对一个集合中的全部元素指定一个别名, 这时要使用关键字join。
left outer joincat.kittens as kitten
from Cat as cat left join cat.mate.kittens as kittens
from Formula form full join form.parameter param
语句inner join,left outer join以及right outer join可以简写。
left join cat.kittensas kitten
left join cat.kittensas kitten
一个fetch连接通常不需要被指定别名, 因为相关联的对象不应当被用在where子句 (或其它任何子句)中。同时,相关联的对象并不在查询的结果中直接返回,但可以通过他们的父对象来访问到他们。
left join fetchcat.kittens child
from Document fetch all properties order by name
from Document doc fetch all properties where lower(doc.name)like '%cats%'
HQL支持两种关联join的形式:implicit(隐式)与explicit(显式)。
上一节中给出的查询都是使用explicit(显式)形式的,其中form子句中明确给出了join关键字。这是建议使用的方式。
from Cat as cat where cat.mate.name like '%s%'
select子句选择将哪些对象与属性返回到查询结果集中. 考虑如下情况:
该语句将选择mates of otherCats。(其他猫的配偶)实际上, 你可以更简洁的用以下的查询语句表达相同的含义:
查询语句可以返回值为任何类型的属性,包括返回类型为某种组件(Component)的属性:
select cat.name from DomesticCat cat
select cust.name.firstName from Customer as cust
查询语句可以返回多个对象和(或)属性,存放在Object[]队列中,
select mother, offspr, mate.name
left outer joinmother.kittens as offspr
select new list(mother, offspr, mate.name)
left outer joinmother.kittens as offspr
select new Family(mother, mate, offspr)
left joinmother.kittens as offspr
select max(bodyWeight) as max, min(bodyWeight) as min, count(*)as n
这种做法在与子句select new map一起使用时最有用:
select new map( max(bodyWeight) as max, min(bodyWeight) as min,count(*) as n )
该查询返回了一个Map的对象,内容是别名与被选择的值组成的名-值映射。
select avg(cat.weight), sum(cat.weight), max(cat.weight), count(cat)
你可以在选择子句中使用数学操作符、连接以及经过验证的SQL函数:
select cat.weight + sum(kitten.weight)
select firstName||' '||initial||' '||upper(lastName) from Person
关键字distinct与all也可以使用,它们具有与SQL相同的语义.
select distinct cat.name from Cat cat
select count(distinct cat.name), count(cat) from Cat cat
from Named n, Named m where n.name = m.name
注意,最后的两个查询将需要超过一个的SQLSELECT.这表明orderby子句没有对整个结果集进行正确的排序.(这也说明你不能对这样的查询使用Query.scroll()方法.)
where子句允许你将返回的实例列表的范围缩小. 如果没有指定别名,你可以使用属性名来直接引用属性:
from Cat as cat where cat.name='Fritz'
返回名为(属性name等于)'Fritz'的Cat类的实例。
where foo.startDate = bar.date
将返回所有满足下面条件的Foo类的实例:存在如下的bar的一个实例,其date属性等于Foo的startDate属性。复合路径表达式使得where子句非常的强大,考虑如下情况:
from Cat cat where cat.mate.name is not null
该查询将被翻译成为一个含有表连接(内连接)的SQL查询。如果你打算写像这样的查询语句
where foo.bar.baz.customer.address.city is not null
from Cat cat, Cat rival where cat.mate = rival.mate
特殊属性(小写)id可以用来表示一个对象的唯一的标识符。(你也可以使用该对象的属性名。)
from Cat as cat where cat.id = 123
from Cat as cat where cat.mate.id = 69
同样也可以使用复合标识符。比如Person类有一个复合标识符,它由country属性与medicareNumber属性组成。
where person.id.country = 'AU'
and person.id.medicareNumber= 123456
where account.owner.id.country = 'AU'
andaccount.owner.id.medicareNumber = 123456
同样的,特殊属性class在进行多态持久化的情况下被用来存取一个实例的鉴别值(discriminator value)。一个嵌入到where子句中的Java类的名字将被转换为该类的鉴别值。
from Cat cat where cat.class = DomesticCat
store.owner.address.city // 正确
一个“任意”类型有两个特殊的属性id和class, 来允许我们按照下面的方式表达一个连接(AuditLog.item是一个属性,该属性被映射为<any>)。
from AuditLog log, Payment payment
where log.item.class = 'Payment' and log.item.id = payment.id
注意,在上面的查询与句中,log.item.class和payment.class将涉及到完全不同的数据库中的列。
在where子句中允许使用的表达式包括大多数你可以在SQL使用的表达式种类:
- 数学运算符+, -, *, /
- 二进制比较运算符=, >=, <=, <>, !=, like
- 逻辑运算符and, or, not
- in, not in, between, is null, is not null, is empty, is not empty, member of and not member of
- "简单的" case, case ... when ... then ... else ... end,和 "搜索" case, case when ... then ... else ... end
- 字符串连接符...||... or concat(...,...)
- current_date(), current_time(), current_timestamp()
- second(...), minute(...), hour(...), day(...), month(...), year(...),
- EJB-QL 3.0定义的任何函数或操作:substring(), trim(), lower(), upper(), length(), locate(), abs(), sqrt(), bit_length(), mod()
- coalesce() 和 nullif()
- str() 把数字或者时间值转换为可读的字符串
- cast(... as ...), 其第二个参数是某Hibernate类型的名字,以及extract(... from ...),只要ANSIcast() 和 extract() 被底层数据库支持
- HQL index() 函数,作用于join的有序集合的别名。
- HQL函数,把集合作为参数:size(), minelement(), maxelement(), minindex(), maxindex(),还有特别的elements() 和indices函数,可以与数量词加以限定:some, all, exists, any, in。
- 任何数据库支持的SQL标量函数,比如sign(), trunc(), rtrim(), sin()
- JDBC风格的参数传入 ?
- 命名参数:name, :start_date, :x1
- SQL 直接常量 'foo', 69, 6.66E+2, '1970-01-01 10:00:01.0'
- Java public static final 类型的常量 eg.Color.TABBY
from DomesticCat cat where cat.name between 'A' and 'B'
from DomesticCat cat where cat.name in ( 'Foo', 'Bar', 'Baz' )
from DomesticCat cat where cat.name not between 'A' and 'B'
from DomesticCat cat where cat.name not in ( 'Foo', 'Bar', 'Baz')
同样, 子句isnull与is not null可以被用来测试空值(null).
在Hibernate配置文件中声明HQL“查询替代(query substitutions)”之后,布尔表达式(Booleans)可以在其他表达式中轻松的使用:
<property name="hibernate.query.substitutions">true1, false 0</property>
系统将该HQL转换为SQL语句时,该设置表明将用字符1和0来取代关键字true和false:
from Cat cat where cat.alive = true
你可以用特殊属性size, 或是特殊函数size()测试一个集合的大小。
from Cat cat where cat.kittens.size > 0
from Cat cat where size(cat.kittens) > 0
from Calendar cal where maxelement(cal.holidays) >current_date
from Order order where maxindex(order.items) > 100
from Order order where minelement(order.items) > 10000
在传递一个集合的索引集或者是元素集(elements与indices函数) 或者传递一个子查询的结果的时候,可以使用SQL函数any,some, all, exists, in
select mother from Cat as mother, Cat as kit
where kit in elements(foo.kittens)
select p from NameList list, Person p
where p.name = some elements(list.names)
from Cat cat where exists elements(cat.kittens)
from Player p where 3 > all elements(p.scores)
from Show show where 'fizard' in indices(show.acts)
注意,在Hibernate3种,这些结构变量-size,elements,indices,minindex,maxindex,minelement,maxelement- 只能在where子句中使用。
一个被索引过的(有序的)集合的元素(arrays, lists, maps)可以在其他索引中被引用(只能在where子句中):
from Order order where order.items[0].id = 1234
select person from Person person, Calendar calendar
where calendar.holidays['national day'] = person.birthDay
andperson.nationality.calendar = calendar
select item from Item item, Order order
where order.items[ order.deliveredItemIndices[0] ] = item andorder.id = 11
select item from Item item, Order order
where order.items[ maxindex(order.items) ] = item and order.id =11
select item from Item item, Order order
where order.items[ size(order.items) - 1 ] = item
对于一个一对多的关联(one-to-many association)或是值的集合中的元素, HQL也提供内建的index()函数,
select item, index(item) from Order order
from DomesticCat cat where upper(cat.name) like 'FRI%'
如果你还不能对所有的这些深信不疑,想想下面的查询。如果使用SQL,语句长度会增长多少,可读性会下降多少:
inner joinstore.customers cust
andstore.location.name in ( 'Melbourne', 'Sydney' )
and prod = allelements(cust.currentOrder.lineItems)
SELECT cust.name, cust.address, cust.phone, cust.id,cust.current_order
AND loc.name IN ('Melbourne', 'Sydney' )
查询返回的列表(list)可以按照一个返回的类或组件(components)中的任何属性(property)进行排序:
order by cat.name asc, cat.weight desc, cat.birthdate
一个返回聚集值(aggregate values)的查询可以按照一个返回的类或组件(components)中的任何属性(property)进行分组:
select cat.color, sum(cat.weight), count(cat)
select foo.id, avg(name), max(name)
from Foo foo join foo.names name
select cat.color, sum(cat.weight), count(cat)
having cat.color in (eg.Color.TABBY, eg.Color.BLACK)
如果底层的数据库支持的话(例如不能在MySQL中使用),SQL的一般函数与聚集函数也可以出现在having与order by子句中。
having avg(kitten.weight) > 100
order by count(kitten) asc, sum(kitten.weight) desc
注意group by子句与order by子句中都不能包含算术表达式(arithmeticexpressions).
对于支持子查询的数据库,Hibernate支持在查询中使用子查询。一个子查询必须被圆括号包围起来(经常是SQL聚集函数的圆括号)。甚至相互关联的子查询(引用到外部查询中的别名的子查询)也是允许的。
select avg(cat.weight)from DomesticCat cat
select name.nickNamefrom Name as name
from Cat as mate wheremate.mate = cat
select name.nickNamefrom Name as name
select cat.id, (select max(kit.weight) from cat.kitten kit)
注意,HQL自查询只可以在select或者where子句中出现。
在select列表中包含一个表达式以上的子查询,你可以使用一个元组构造符(tuple constructors):
where not ( cat.name, cat.color ) in (
select cat.name,cat.color from DomesticCat cat
注意在某些数据库中(不包括Oracle与HSQL),你也可以在其他语境中使用元组构造符,比如查询用户类型的组件与组合:
from Person where name = ('Gavin', 'A', 'King')
from Person where name.first = 'Gavin' and name.initial = 'A'and name.last = 'King')
有两个很好的理由使你不应当作这样的事情:首先,它不完全适用于各个数据库平台;其次,查询现在依赖于映射文件中属性的顺序。
select order.id, sum(price.amount), count(item)
andcatalog.effectiveDate < sysdate
andcatalog.effectiveDate >= all (
wherecat.effectiveDate < sysdate
having sum(price.amount) > :minAmount
order by sum(price.amount) desc
这简直是一个怪物!实际上,在现实生活中,我并不热衷于子查询,所以我的查询语句看起来更像这个:
select order.id, sum(price.amount), count(item)
having sum(price.amount) > :minAmount
order by sum(price.amount) desc
select count(payment), status.name
joinpayment.currentStatus as status
joinpayment.statusChanges as statusChange
where payment.status.name <>PaymentStatus.AWAITING_APPROVAL
fromPaymentStatusChange change
andstatusChange.user <> :currentUser
group by status.name, status.sortOrder
如果我把statusChanges实例集映射为一个列表(list)而不是一个集合(set), 书写查询语句将更加简单.
select count(payment), status.name
joinpayment.currentStatus as status
where payment.status.name <>PaymentStatus.AWAITING_APPROVAL
orpayment.statusChanges[ maxIndex(payment.statusChanges) ].user <>:currentUser
group by status.name, status.sortOrder
left outer joinaccount.payments as payment
where :currentUser in elements(account.holder.users)
andPaymentStatus.UNPAID = isNull(payment.currentStatus.name, PaymentStatus.UNPAID)
order by account.type.sortOrder, account.accountNumber,payment.dueDate
join account.holder.usersas user
left outer joinaccount.payments as payment
andPaymentStatus.UNPAID = isNull(payment.currentStatus.name, PaymentStatus.UNPAID)
order by account.type.sortOrder, account.accountNumber,payment.dueDate
( (Integer) session.iterate("select count(*) from....").next() ).intValue()
如果你的数据库支持子选择,你可以在你的查询的where子句中为选择的大小(selectionsize)指定一个条件:
from User usr where size(usr.messages) >= 1
因为内连接(inner join)的原因,这个解决方案不能返回含有零个信息的User类的实例, 所以这种情况下使用下面的格式将是有帮助的:
JavaBean的属性可以被绑定到一个命名查询(named query)的参数上:
Query q = s.createQuery("from foo Foo as foo wherefoo.name=:name and foo.size=:size");
q.setProperties(fooBean); // fooBean包含方法getName()与getSize()
通过将接口Query与一个过滤器(filter)一起使用,集合(Collections)是可以分页的:
Query q = s.createFilter( collection, "" ); // 一个简单的过滤器
q.setFirstResult(PAGE_SIZE * pageNumber);
通过使用查询过滤器(query filter)可以将集合(Collection)的原素分组或排序:
Collection orderedCollection = s.filter( collection, "orderby this.amount" );
Collection counts = s.filter( collection, "selectthis.type, count(this) group by this.type" );
不用通过初始化,你就可以知道一个集合(Collection)的大小:
( (Integer) session.iterate("select count(*) from....").next() ).intValue();
具有一个直观的、可扩展的条件查询API是Hibernate的特色。
org.hibernate.Criteria接口表示特定持久类的一个查询。Session是Criteria实例的工厂。
Criteria crit = sess.createCriteria(Cat.class);
List cats = sess.createCriteria(Cat.class)
.add(Restrictions.like("name", "Fritz%") )
.add(Restrictions.between("weight", minWeight, maxWeight) )
List cats = sess.createCriteria(Cat.class)
.add(Restrictions.like("name", "Fritz%") )
Restrictions.eq("age", new Integer(0) ),
List cats = sess.createCriteria(Cat.class)
.add( Restrictions.in("name", new String[] { "Fritz", "Izi","Pk" } ) )
.add(Restrictions.disjunction()
.add(Restrictions.isNull("age") )
.add( Restrictions.eq("age", newInteger(0) ) )
.add(Restrictions.eq("age", new Integer(1) ) )
.add( Restrictions.eq("age", newInteger(2) ) )
Hibernate提供了相当多的内置criterion类型(Restrictions子类), 但是尤其有用的是可以允许你直接使用SQL。
List cats = sess.createCriteria(Cat.class)
.add(Restrictions.sqlRestriction("lower({alias}.name) like lower(?)","Fritz%", Hibernate.STRING) )
Property实例是获得一个条件的另外一种途径。你可以通过调用Property.forName()创建一个Property。
Property age = Property.forName("age");
List cats = sess.createCriteria(Cat.class)
.add(Restrictions.disjunction()
.add( age.eq( new Integer(0) ) )
.add( age.eq( new Integer(1) ) )
.add( age.eq( new Integer(2) ) )
.add(Property.forName("name").in( new String[] { "Fritz","Izi", "Pk" } ) )
你可以使用org.hibernate.criterion.Order来为查询结果排序。
List cats = sess.createCriteria(Cat.class)
.add(Restrictions.like("name", "F%")
List cats = sess.createCriteria(Cat.class)
.add(Property.forName("name").like("F%") )
.addOrder(Property.forName("name").asc() )
.addOrder(Property.forName("age").desc() )
你可以使用createCriteria()非常容易的在互相关联的实体间建立约束。
List cats = sess.createCriteria(Cat.class)
.add(Restrictions.like("name", "F%") )
.add(Restrictions.like("name", "F%") )
注意第二个createCriteria()返回一个新的Criteria实例,该实例引用kittens集合中的元素。
List cats = sess.createCriteria(Cat.class)
.add(Restrictions.eqProperty("kt.name", "mt.name") )
(createAlias()并不创建一个新的Criteria实例。)
Cat实例所保存的之前两次查询所返回的kittens集合是没有被条件预过滤的。如果你希望只获得符合条件的kittens,你必须使用ResultTransformer。
List cats = sess.createCriteria(Cat.class)
.createCriteria("kittens", "kt")
.add(Restrictions.eq("name", "F%") )
.setResultTransformer(Criteria.ALIAS_TO_ENTITY_MAP)
Iterator iter = cats.iterator();
Cat cat = (Cat)map.get(Criteria.ROOT_ALIAS);
Cat kitten = (Cat)map.get("kt");
你可以使用setFetchMode()在运行时定义动态关联抓取的语义。
List cats = sess.createCriteria(Cat.class)
.add(Restrictions.like("name", "Fritz%") )
.setFetchMode("mate", FetchMode.EAGER)
.setFetchMode("kittens", FetchMode.EAGER)
这个查询可以通过外连接抓取mate和kittens。查看第19.1节“抓取策略(Fetching strategies) ”可以获得更多信息。
org.hibernate.criterion.Example类允许你通过一个给定实例构建一个条件查询。
List results = session.createCriteria(Cat.class)
版本属性、标识符和关联被忽略。默认情况下值为null的属性将被排除。
Example example = Example.create(cat)
.excludeZeroes() //exclude zero valued properties
.excludeProperty("color") //exclude the property named "color"
.ignoreCase() //perform case insensitive stringcomparisons
.enableLike(); //use like for string comparisons
List results = session.createCriteria(Cat.class)
List results = session.createCriteria(Cat.class)
.add(Example.create( cat.getMate() ) )
15.7.投影(Projections)、聚合(aggregation)和分组(grouping)
org.hibernate.criterion.Projections是Projection的实例工厂。我们通过调用setProjection()应用投影到一个查询。
List results = session.createCriteria(Cat.class)
.setProjection(Projections.rowCount() )
.add(Restrictions.eq("color", Color.BLACK) )
List results = session.createCriteria(Cat.class)
.setProjection(Projections.projectionList()
.add(Projections.avg("weight") )
.add(Projections.max("weight") )
.add(Projections.groupProperty("color") )
在一个条件查询中没有必要显式的使用 "group by" 。某些投影类型就是被定义为分组投影,他们也出现在SQL的groupby子句中。
你可以选择把一个别名指派给一个投影,这样可以使投影值被约束或排序所引用。下面是两种不同的实现方式:
List results = session.createCriteria(Cat.class)
.setProjection(Projections.alias( Projections.groupProperty("color"),"colr" ) )
List results = session.createCriteria(Cat.class)
.setProjection(Projections.groupProperty("color").as("colr") )
alias()和as()方法简便的将一个投影实例包装到另外一个别名的Projection实例中。简而言之,当你添加一个投影到一个投影列表中时你可以为它指定一个别名:
List results = session.createCriteria(Cat.class)
.setProjection(Projections.projectionList()
.add(Projections.rowCount(), "catCountByColor" )
.add(Projections.avg("weight"), "avgWeight" )
.add( Projections.max("weight"),"maxWeight" )
.add(Projections.groupProperty("color"), "color" )
.addOrder(Order.desc("catCountByColor") )
.addOrder(Order.desc("avgWeight") )
List results = session.createCriteria(Domestic.class,"cat")
.createAlias("kittens", "kit")
.setProjection(Projections.projectionList()
.add(Projections.property("cat.name"), "catName" )
.add(Projections.property("kit.name"), "kitName" )
.addOrder( Order.asc("catName"))
.addOrder(Order.asc("kitName") )
你也可以使用Property.forName()来表示投影:
List results = session.createCriteria(Cat.class)
.setProjection(Property.forName("name") )
.add(Property.forName("color").eq(Color.BLACK) )
List results = session.createCriteria(Cat.class)
.setProjection(Projections.projectionList()
.add(Projections.rowCount().as("catCountByColor") )
.add(Property.forName("weight").avg().as("avgWeight") )
.add( Property.forName("weight").max().as("maxWeight"))
.add(Property.forName("color").group().as("color" )
.addOrder(Order.desc("catCountByColor") )
.addOrder(Order.desc("avgWeight") )
DetachedCriteria类使你在一个session范围之外创建一个查询,并且可以使用任意的Session来执行它。
DetachedCriteria query = DetachedCriteria.forClass(Cat.class)
.add(Property.forName("sex").eq('F') );
Transaction txn = session.beginTransaction();
List results =query.getExecutableCriteria(session).setMaxResults(100).list();
DetachedCriteria也可以用以表示子查询。条件实例包含子查询可以通过Subqueries或者Property获得。
DetachedCriteria avgWeight =DetachedCriteria.forClass(Cat.class)
.setProjection(Property.forName("weight").avg() );
session.createCriteria(Cat.class)
.add(Property.forName("weight).gt(avgWeight) )
DetachedCriteria weights = DetachedCriteria.forClass(Cat.class)
.setProjection(Property.forName("weight") );
session.createCriteria(Cat.class)
.add(Subqueries.geAll("weight", weights) )
DetachedCriteria avgWeightForSex =DetachedCriteria.forClass(Cat.class, "cat2")
.setProjection(Property.forName("weight").avg() )
.add( Property.forName("cat2.sex").eqProperty("cat.sex"));
session.createCriteria(Cat.class, "cat")
.add(Property.forName("weight).gt(avgWeightForSex) )
15.9.根据自然标识查询(Queries by natural identifier)
首先,你应该对你的entity使用<natural-id>来映射自然键,然后打开第二级缓存。
注意,此功能对具有mutable自然键的entity并不适用。
现在,我们可以用Restrictions.naturalId()来使用更加高效的缓存算法。
session.createCriteria(User.class)
Hibernate3允许你使用手写的sql来完成所有的create,update,delete,和load操作(包括存储过程)
对原生SQL查询执行的控制是通过SQLQuery接口进行的,通过执行Session.createSQLQuery()获取这个接口。最简单的情况下,我们可以采用以下形式:
List cats = sess.createSQLQuery("select * from cats")
这里,结果集字段名被假设为与映射文件中指明的字段名相同。对于连接了多个表的查询,这就可能造成问题,因为可能在多个表中出现同样名字的字段。下面的方法就可以避免字段名重复的问题:
List cats = sess.createSQLQuery("select {cat.*} from cats cat")
addEntity()方法将SQL表的别名和实体类联系起来,并且确定查询结果集的形态。
addJoin()方法可以被用于载入其他的实体和集合的关联.
List cats = sess.createSQLQuery(
"select{cat.*}, {kitten.*} from cats cat, cats kitten where kitten.mother =cat.id"
.addJoin("kitten", "cat.kittens")
原生的SQL查询可能返回一个简单的标量值或者一个标量和实体的结合体。
Double max = (Double) sess.createSQLQuery("selectmax(cat.weight) as maxWeight from cats cat")
.addScalar("maxWeight", Hibernate.DOUBLE);
除此之外,你还可以在你的hbm文件中描述结果集映射信息,在查询中使用。
List cats = sess.createSQLQuery(
"select{cat.*}, {kitten.*} from cats cat, cats kitten where kitten.mother =cat.id"
.setResultSetMapping("catAndKitten")
String sql = "select cat.originalId as {cat.id}, " +
"cat.mateid as{cat.mate}, cat.sex as {cat.sex}, " +
"cat.weight*10 as{cat.weight}, cat.name as {cat.name} " +
"from cat_log catwhere {cat.mate} = :catId"
List loggedCats = sess.createSQLQuery(sql)
注意:如果你明确地列出了每个属性,你必须包含这个类和它的子类的属性!
下表列出了使用别名注射参数的不同可能性。注意:下面结果中的别名只是示例,实用时每个别名需要唯一并且不同的名字。
表16.1.别名注射(alias injection names)
描述 |
语法 |
示例 |
|
简单属性 |
{[aliasname].[propertyname] |
A_NAME as {item.name} |
|
复合属性 |
{[aliasname].[componentname].[propertyname]} |
CURRENCY as {item.amount.currency}, VALUE as {item.amount.value} |
|
实体辨别器(Discriminator of an entity) |
{[aliasname].class} |
DISC as {item.class} |
|
实体的所有属性 |
{[aliasname].*} |
{item.*} |
|
集合键(collection key) |
{[aliasname].key} |
ORGID as {coll.key} |
|
集合id |
{[aliasname].id} |
EMPID as {coll.id} |
|
集合元素 |
{[aliasname].element} |
XID as {coll.element} |
|
集合元素的属性 |
{[aliasname].element.[propertyname]} |
NAME as {coll.element.name} |
|
集合元素的所有属性 |
{[aliasname].element.*} |
{coll.element.*} |
|
集合的所有属性 |
{[aliasname].*} |
{coll.*} |
可以在映射文档中定义查询的名字,然后就可以象调用一个命名的HQL查询一样直接调用命名SQL查询.在这种情况下,我们不需要调用addEntity()方法.
<returnalias="person" class="eg.Person"/>
SELECT person.NAME AS{person.name},
WHERE person.NAME LIKE:namePattern
List people = sess.getNamedQuery("persons")
.setString("namePattern",namePattern)
<return-join>和<load-collection>元素是用来连接关联以及将查询定义为预先初始化各个集合的。
<sql-query name="personsWith">
<returnalias="person" class="eg.Person"/>
<return-joinalias="address" property="person.mailingAddress"/>
SELECT person.NAME AS{person.name},
adddress.STREETAS {address.street},
adddress.CITYAS {address.city},
adddress.STATEAS {address.state},
ON person.ID =address.PERSON_ID AND address.TYPE='MAILING'
WHERE person.NAME LIKE:namePattern
一个命名查询可能会返回一个标量值.你必须使用<return-scalar>元素来指定字段的别名和 Hibernate类型
<return-scalarcolumn="name" type="string"/>
<return-scalarcolumn="age" type="long"/>
FROM PERSON p WHEREp.NAME LIKE 'Hiber%'
<resultset name="personAddress">
<returnalias="person" class="eg.Person"/>
<return-joinalias="address" property="person.mailingAddress"/>
<sql-query name="personsWith" resultset-ref="personAddress">
SELECT person.NAME AS{person.name},
adddress.STREETAS {address.street},
adddress.CITYAS {address.city},
adddress.STATEAS {address.state},
ON person.ID =address.PERSON_ID AND address.TYPE='MAILING'
WHERE person.NAME LIKE:namePattern
16.3.1.使用return-property来明确地指定字段/别名
使用<return-property>你可以明确的告诉Hibernate使用哪些字段别名,这取代了使用{}-语法来让Hibernate注入它自己的别名.
<returnalias="person" class="eg.Person">
<return-propertyname="name" column="myName"/>
<return-propertyname="age" column="myAge"/>
<return-propertyname="sex" column="mySex"/>
FROM PERSON personWHERE person.NAME LIKE :name
<return-property>也可用于多个字段,它解决了使用{}-语法不能细粒度控制多个字段的限制
<sql-queryname="organizationCurrentEmployments">
<returnalias="emp" class="Employment">
<return-property name="salary">
<return-column name="CURRENCY"/>
<return-property name="endDate"column="myEndDate"/>
SELECTEMPLOYEE AS {emp.employee}, EMPLOYER AS {emp.employer},
STARTDATE AS{emp.startDate}, ENDDATE AS {emp.endDate},
REGIONCODE as{emp.regionCode}, EID AS {emp.id}, VALUE, CURRENCY
WHERE EMPLOYER = :id AND ENDDATE IS NULL
注意在这个例子中,我们使用了<return-property>结合{}的注入语法. 允许用户来选择如何引用字段以及属性.
如果你映射一个识别器(discriminator),你必须使用<return-discriminator>来指定识别器字段
CREATE OR REPLACE FUNCTION selectAllEmployments
REGIONCODE, EID, VALUE,CURRENCY
在Hibernate里要要使用这个查询,你需要通过命名查询来映射它.
<sql-query name="selectAllEmployees_SP"callable="true">
<return alias="emp"class="Employment">
<return-property name="employee"column="EMPLOYEE"/>
<return-property name="employer"column="EMPLOYER"/>
<return-property name="startDate"column="STARTDATE"/>
<return-propertyname="endDate" column="ENDDATE"/>
<return-property name="regionCode"column="REGIONCODE"/>
<return-property name="id" column="EID"/>
<return-property name="salary">
<return-column name="CURRENCY"/>
{ ? = callselectAllEmployments() }
注意存储过程当前仅仅返回标量和实体.现在不支持<return-join>和<load-collection>
对存储过程进行的查询无法使用setFirstResult()/setMaxResults()进行分页。
- 存储过程必须返回一个结果集。.注意这些servers可能返回多个结果集以及更新的数目.Hibernate将取出第一条结果集作为它的返回值, 其他将被丢弃。
- 如果你能够在存储过程里设定SET NOCOUNT ON,这可能会效率更高,但这不是必需的。
16.4.定制SQL用来create,update和delete
<propertyname="name" not-null="true"/>
<sql-insert>INSERTINTO PERSON (NAME, ID) VALUES ( UPPER(?), ? )</sql-insert>
<sql-update>UPDATE PERSON SET NAME=UPPER(?) WHEREID=?</sql-update>
<sql-delete>DELETE FROM PERSON WHERE ID=?</sql-delete>
这些SQL直接在你的数据库里执行,所以你可以自由的使用你喜欢的任意语法。但如果你使用数据库特定的语法,这当然会降低你映射的可移植性。
<propertyname="name" not-null="true"/>
<sql-insertcallable="true">{call createPerson (?, ?)}</sql-insert>
<sql-deletecallable="true">{? = call deletePerson (?)}</sql-delete>
<sql-updatecallable="true">{? = call updatePerson (?, ?)}</sql-update>
参数的位置顺序是非常重要的,他们必须和Hibernate所期待的顺序相同。
CREATE OR REPLACE FUNCTION updatePerson (uid IN NUMBER, uname INVARCHAR2)
<returnalias="pers" class="Person"lock-mode="upgrade"/>
SELECT NAME AS{pers.name}, ID AS {pers.id}
这只是一个前面讨论过的命名查询声明,你可以在类映射里引用这个命名查询。
<propertyname="name" not-null="true"/>
<set name="employments"inverse="true">
<one-to-manyclass="Employment"/>
<loaderquery-ref="employments"/>
<sql-query name="employments">
<load-collectionalias="emp" role="Person.employments"/>
ORDER BY STARTDATEASC, EMPLOYEE ASC
你甚至还可以定义一个实体装载器,它通过连接抓取装载一个集合:
<returnalias="pers" class="Person"/>
<return-joinalias="emp" property="pers.employments"/>
SELECT NAME AS{pers.*}, {emp.*}
要使用过滤器,必须首先在相应的映射节点中定义。而定义一个过滤器,要用到位于<hibernate-mapping/>节点之内的<filter-def/>节点:
<filter-paramname="myFilterParam" type="string"/>
<filtername="myFilter" condition=":myFilterParam =MY_FILTERED_COLUMN"/>
<filtername="myFilter" condition=":myFilterParam =MY_FILTERED_COLUMN"/>
可以在多个类或集合中使用某个过滤器;某个类或者集合中也可以使用多个过滤器。
session.enableFilter("myFilter").setParameter("myFilterParam","some-value");
注意,org.hibernate.Filter的方法允许链式方法调用。(类似上面例子中启用Filter之后设定Filter参数这个“方法链”) Hibernate的其他部分也大多有这个特性。
下面是一个比较完整的例子,使用了记录生效日期模式过滤有时效的数据:
<filter-def name="effectiveDate">
<filter-paramname="asOfDate" type="date"/>
<many-to-onename="department" column="dept_id"class="Department"/>
<propertyname="effectiveStartDate" type="date"column="eff_start_dt"/>
<propertyname="effectiveEndDate" type="date"column="eff_end_dt"/>
Note that thisassumes non-terminal records have an eff_end_dt set to
a max db date forsimplicity-sake
注意,为了简单起见,此处假设雇用关系生效期尚未结束的记录的eff_end_dt字段的值等于数据库最大的日期
condition=":asOfDate BETWEEN eff_start_dt and eff_end_dt"/>
<setname="employees" lazy="true">
<one-to-manyclass="Employee"/>
condition=":asOfDate BETWEEN eff_start_dt and eff_end_dt"/>
定义好后,如果想要保证取回的都是目前处于生效期的记录,只需在获取雇员数据的操作之前先开启过滤器即可:
session.enabledFilter("effectiveDate").setParameter("asOfDate",new Date());
List results = session.createQuery("from Employee as ewhere e.salary > :targetSalary")
.setLong("targetSalary", new Long(1000000))
在上面的HQL中,虽然我们仅仅显式的使用了一个薪水条件,但因为启用了过滤器,查询将仅返回那些目前雇用关系处于生效期的,并且薪水高于一百万美刀的雇员的数据。
注意这是Hibernate 3.0的一个实验性的特性。这一特性仍在积极开发中。
Hibernate使得你可以用XML数据来进行工作,恰如你用持久化的POJO进行工作那样。解析过的XML树可以被认为是代替POJO的另外一种在对象层面上表示关系型数据的途径.
这一特性可以应用在很多场合,包括数据导入导出,通过JMS或SOAP具体化实体数据以及基于XSLT的报表。
一个单一的映射就可以将类的属性和XML文档的节点同时映射到数据库。如果不需要映射类,它也可以用来只映射XML文档。
这个映射使得你既可以把数据作为一棵dom4j树那样访问,又可以作为由属性键值对(javaMaps) 组成的图那样访问。属性名字纯粹是逻辑上的结构,你可以在HQL查询中引用它。
许多Hibernate映射元素具有node属性。这使你可以指定用来保存属性或实体数据的XML属性或元素。node属性必须是下列格式之一:
- "element-name" - 映射为指定的XML元素
- "@attribute-name" - 映射为指定的XML属性
- "." - 映射为父元素
- "element-name/@attribute-name" - 映射为指定元素的指定属性
你应该小心,不要让太多关联的embed-xml属性为真(embed-xml="true"),因为XML不能很好地处理循环引用!
<one-to-manyentity-name="Account"
在这个例子中,我们决定嵌入帐目号码(account id)的集合,但不嵌入实际的帐目数据。下面的HQL查询:
from Customer c left join fetch c.accounts where c.lastName like:lastName
<accountid="987632567" short-desc="Savings"/>
<accountid="985612323" short-desc="Credit Card"/>
<first-name>Gavin</first-name>
如果你把一对多映射<one-to-many>的embed-xml属性置为真(embed-xml="true"),则数据看上去就像这样:
<accountid="987632567" short-desc="Savings">
<accountid="985612323" short-desc="Credit Card">
<first-name>Gavin</first-name>
让我们来读入和更新应用程序中的XML文档。通过获取一个dom4j会话可以做到这一点:
Session session = factory.openSession();
Session dom4jSession = session.getSession(EntityMode.DOM4J);
Transaction tx = session.beginTransaction();
.createQuery("from Customer c left join fetch c.accounts wherec.lastName like :lastName")
for ( int i=0; i<results.size(); i++ ) {
//add the customerdata to the XML document
Element customer = (Element) results.get(i);
Session session = factory.openSession();
Session dom4jSession = session.getSession(EntityMode.DOM4J);
Transaction tx = session.beginTransaction();
Element cust = (Element) dom4jSession.get("Customer",customerId);
for ( int i=0; i<results.size(); i++ ) {
Element customer =(Element) results.get(i);
//change the customername in the XML and database
Element name =customer.element("name");
name.element("first-name").setText(firstName);
name.element("initial").setText(initial);
name.element("last-name").setText(lastName);
将这一特色与Hibernate的replicate()操作结合起来对于实现的基于XML的数据导入/导出将非常有用.
19.1. 抓取策略(Fetching strategies)
- 连接抓取(Join fetching) - Hibernate通过 在SELECT语句使用OUTER JOIN(外连接)来 获得对象的关联实例或者关联集合。
- 查询抓取(Select fetching) - 另外发送一条 SELECT 语句抓取当前对象的关联实体或集合。除非你显式的指定lazy="false"禁止 延迟抓取(lazy fetching),否则只有当你真正访问关联关系的时候,才会执行第二条select语句。
- 子查询抓取(Subselect fetching) - 另外发送一条SELECT 语句抓取在前面查询到(或者抓取到)的所有实体对象的关联集合。除非你显式的指定lazy="false" 禁止延迟抓取(lazy fetching),否则只有当你真正访问关联关系的时候,才会执行第二条select语句。
- 批量抓取(Batch fetching) - 对查询抓取的优化方案, 通过指定一个主键或外键列表,Hibernate使用单条SELECT语句获取一批对象实例或集合。
- Immediate fetching,立即抓取 - 当宿主被加载时,关联、集合或属性被立即抓取。
- Lazy collection fetching,延迟集合抓取- 直到应用程序对集合进行了一次操作时,集合才被抓取。(对集合而言这是默认行为。)
- "Extra-lazy" collection fetching,"Extra-lazy"集合抓取 -对集合类中的每个元素而言,都是直到需要时才去访问数据库。除非绝对必要,Hibernate不会试图去把整个集合都抓取到内存里来(适用于非常大的集合)。
- Proxy fetching,代理抓取 - 对返回单值的关联而言,当其某个方法被调用,而非对其关键字进行get操作时才抓取。
- "No-proxy" fetching,非代理抓取 - 对返回单值的关联而言,当实例变量被访问的时候进行抓取。与上面的代理抓取相比,这种方法没有那么“延迟”得厉害(就算只访问标识符,也会导致关联抓取)但是更加透明,因为对应用程序来说,不再看到proxy。这种方法需要在编译期间进行字节码增强操作,因此很少需要用到。
- Lazy attribute fetching,属性延迟加载 - 对属性或返回单值的关联而言,当其实例变量被访问的时候进行抓取。需要编译期字节码强化,因此这一方法很少是必要的。
默认情况下,Hibernate 3对集合使用延迟select抓取,对返回单值的关联使用延迟代理抓取。对几乎是所有的应用而言,其绝大多数的关联,这种策略都是有效的。
注意:假若你设置了hibernate.default_batch_fetch_size,Hibernate会对延迟加载采取批量抓取优化措施(这种优化也可能会在更细化的级别打开)。
然而,你必须了解延迟抓取带来的一个问题。在一个打开的Hibernate session上下文之外调用延迟集合会导致一次意外。比如:
Transaction tx = s.beginTransaction();
User u = (User) s.createQuery("from User u whereu.name=:userName")
.setString("userName",userName).uniqueResult();
Map permissions = u.getPermissions();
Integer accessLevel = (Integer)permissions.get("accounts"); // Error!
19.1.2. 调整抓取策略(Tuning fetch strategies)
查询抓取(默认的)在N+1查询的情况下是极其脆弱的,因此我们可能会要求在映射文档中定义使用连接抓取:
<one-to-manyclass="Permission"/>
<many-to-one name="mother" class="Cat"fetch="join"/>
不管你使用哪种抓取策略,定义为非延迟的类图会被保证一定装载入内存。注意这可能意味着在一条HQL查询后紧跟着一系列的查询。
也许你喜欢仅仅通过条件查询,就可以改变get()或load()语句中的数据抓取策略。例如:
User user = (User) session.createCriteria(User.class)
.setFetchMode("permissions",FetchMode.JOIN)
.add( Restrictions.idEq(userId) )
(这就是其他ORM解决方案的“抓取计划(fetchplan)”在Hibernate中的等价物。)
19.1.3.单端关联代理(Single-ended association proxies)
默认的,Hibernate3将会为所有的持久对象产生代理(在启动阶段),然后使用他们实现多对一(many-to-one)关联和一对一(one-to-one)关联的延迟抓取。
在如此方式定义一个多态类的时候,有许多值得注意的常见性的问题,例如:
<class name="Cat" proxy="Cat">
首先,Cat实例永远不可以被强制转换为DomesticCat, 即使它本身就是DomesticCat实例。
Cat cat = (Cat) session.load(Cat.class, id); // instantiate a proxy (does not hit the db)
if ( cat.isDomesticCat() ) { // hit the db to initializethe proxy
DomesticCat dc =(DomesticCat) cat; // Error!
Cat cat = (Cat) session.load(Cat.class, id); // instantiate a Cat proxy
(DomesticCat)session.load(DomesticCat.class, id); //acquire new DomesticCat proxy!
System.out.println(cat==dc); // false
虽然如此,但实际情况并没有看上去那么糟糕。虽然我们现在有两个不同的引用,分别指向这两个不同的代理对象,但实际上,其底层应该是同一个实例对象:
cat.setWeight(11.0); //hit the db to initialize the proxy
System.out.println( dc.getWeight() ); // 11.0
第三,你不能对“final类”或“具有final方法的类”使用CGLIB代理。
最后,如果你的持久化对象在实例化时需要某些资源(例如,在实例化方法、默认构造方法中),那么代理对象也同样需要使用这些资源。实际上,代理类是持久化类的子类。
这些问题都源于Java的单根继承模型的天生限制。如果你希望避免这些问题,那么你的每个持久化类必须实现一个接口,在此接口中已经声明了其业务方法。然后,你需要在映射文档中再指定这些接口。例如:
<class name="CatImpl" proxy="Cat">
<subclassname="DomesticCatImpl" proxy="DomesticCat">
Cat cat = (Cat) session.load(CatImpl.class, catid);
Iterator iter = session.iterate("from CatImpl as cat wherecat.name='fritz'");
Cat fritz = (Cat) iter.next();
这里,对象之间的关系也将被延迟载入。这就意味着,你应该将属性声明为Cat,而不是CatImpl。
Hibernate将会识别出那些重载了equals()、或hashCode()方法的持久化类。
若选择lazy="no-proxy"而非默认的lazy="proxy",我们可以避免类型转换带来的问题。然而,这样我们就需要编译期字节码增强,并且所有的操作都会导致立刻进行代理初始化。
19.1.4.实例化集合和代理(Initializing collections and proxies)
- 在一个基于Web的应用中,可以利用servlet过滤器(filter),在用户请求(request)结束、页面生成 结束时关闭Session(这里使用了在展示层保持打开Session模式(Open Session in View)), 当然,这将依赖于应用框架中异常需要被正确的处理。在返回界面给用户之前,乃至在生成界面过程中发生异常的情况下, 正确关闭Session和结束事务将是非常重要的, 请参见Hibernate wiki上的"Open Session in View"模式,你可以找到示例。
- 在一个拥有单独业务层的应用中,业务层必须在返回之前,为web层“准备”好其所需的数据集合。这就意味着 业务层应该载入所有表现层/web层所需的数据,并将这些已实例化完毕的数据返回。通常,应用程序应该 为web层所需的每个集合调用Hibernate.initialize()(这个调用必须发生咱session关闭之前); 或者使用带有FETCH从句,或FetchMode.JOIN的Hibernate查询, 事先取得所有的数据集合。如果你在应用中使用了Command模式,代替Session Facade , 那么这项任务将会变得简单的多。
- 你也可以通过merge()或lock()方法,在访问未实例化的集合(或代理)之前, 为先前载入的对象绑定一个新的Session。 显然,Hibernate将不会,也不应该自动完成这些任务,因为这将引入一个特殊的事务语义。
有时候,你并不需要完全实例化整个大的集合,仅需要了解它的部分信息(例如其大小)、或者集合的部分内容。
你可以使用集合过滤器得到其集合的大小,而不必实例化整个集合:
( (Integer) s.createFilter( collection, "selectcount(*)" ).list().get(0) ).intValue()
这里的createFilter()方法也可以被用来有效的抓取集合的部分内容,而无需实例化整个集合:
s.createFilter( lazyCollection, "").setFirstResult(0).setMaxResults(10).list();
19.1.5.使用批量抓取(Using batch fetching)
<class name="Person"batch-size="10">...</class>
随之,Hibernate将只需要执行三次查询,分别为10、10、 5。
<setname="cats" batch-size="3">
19.1.6.使用子查询抓取(Using subselect fetching)
假若一个延迟集合或单值代理需要抓取,Hibernate会使用一个subselect重新运行原来的查询,一次性读入所有的实例。这和批量抓取的实现方法是一样的,不会有破碎的加载。
19.1.7.使用延迟属性抓取(Using lazy property fetching)
可以在映射文件中对特定的属性设置lazy,定义该属性为延迟载入。
<propertyname="name" not-null="true" length="50"/>
<propertyname="summary" not-null="true" length="200"lazy="true"/>
<propertyname="text" not-null="true" length="2000"lazy="true"/>
你可以在Ant的Task中,进行如下定义,对持久类代码加入“二进制指令。”
<target name="instrument"depends="compile">
<taskdefname="instrument"classname="org.hibernate.tool.instrument.InstrumentTask">
<classpathpath="${jar.path}"/>
<classpathpath="${classes.dir}"/>
<classpathrefid="lib.class.path"/>
<filesetdir="${testclasses.dir}/org/hibernate/auction/model">
19.2.二级缓存(The Second Level Cache)
表19.1. 缓存策略提供商(Cache Providers)
Cache |
Provider class |
Type |
Cluster Safe |
Query Cache Supported |
Hashtable (not intended for production use) |
org.hibernate.cache.HashtableCacheProvider |
memory |
yes |
|
EHCache |
org.hibernate.cache.EhCacheProvider |
memory, disk |
yes |
|
OSCache |
org.hibernate.cache.OSCacheProvider |
memory, disk |
yes |
|
SwarmCache |
org.hibernate.cache.SwarmCacheProvider |
clustered (ip multicast) |
yes (clustered invalidation) |
|
JBoss TreeCache |
org.hibernate.cache.TreeCacheProvider |
clustered (ip multicast), transactional |
yes (replication) |
yes (clock sync req.) |
usage="transactional|read-write|nonstrict-read-write|read-only" (1)
(1) |
usage(必须)说明了缓存的策略: transactional、 read-write、 nonstrict-read-write或 read-only。 |
(2) |
region (可选, 默认为类或者集合的名字(class or collection role name)) 指定第二级缓存的区域名(name of the second level cache region) |
(3) |
include (可选,默认为 all) non-lazy 当属性级延迟抓取打开时, 标记为lazy="true"的实体的属性可能无法被缓存 |
另外(首选?), 你可以在hibernate.cfg.xml中指定<class-cache>和<collection-cache>元素。
这里的usage属性指明了缓存并发策略(cache concurrency strategy)。
aname="performance-cache-readonly">19.2.2.策略:只读缓存(Strategy: read only)
如果你的应用程序只需读取一个持久化类的实例,而无需对其修改,那么就可以对其进行只读缓存。这是最简单,也是实用性最好的方法。甚至在集群中,它也能完美地运作。
<class name="eg.Immutable"mutable="false">
<cacheusage="read-only"/>
....
</class>
19.2.3. 策略:读/写缓存(Strategy: read/write)
19.2.4. 策略:非严格读/写缓存(Strategy: nonstrict read/write)
19.2.5. 策略:事务缓存(transactional)
没有一种缓存提供商能够支持上列的所有缓存并发策略。下表中列出了各种提供器、及其各自适用的并发策略。
表19.2. 各种缓存提供商对缓存并发策略的支持情况(Cache Concurrency Strategy Support)
Cache |
read-only |
nonstrict-read-write |
read-write |
transactional |
Hashtable (not intended for production use) |
yes |
yes |
yes |
|
EHCache |
yes |
yes |
yes |
|
OSCache |
yes |
yes |
yes |
|
SwarmCache |
yes |
yes |
||
JBoss TreeCache |
yes |
yes |
19.3. 管理缓存(Managing the caches)
当随后flush()方法被调用时,对象的状态会和数据库取得同步。如果你不希望此同步操作发生,或者你正处理大量对象、需要对有效管理内存时,你可以调用evict()方法,从一级缓存中去掉这些对象及其集合。
ScrollableResult cats = sess.createQuery("from Cat ascat").scroll(); //a huge result set
Session还提供了一个contains()方法,用来判断某个实例是否处于当前session的缓存中。
如若要把所有的对象从session缓存中彻底清除,则需要调用Session.clear()。
对于二级缓存来说,在SessionFactory中定义了许多方法,清除缓存中实例、整个类、集合实例或者整个集合。
sessionFactory.evict(Cat.class, catId); //evict a particular Cat
sessionFactory.evict(Cat.class); //evict all Cats
sessionFactory.evictCollection("Cat.kittens", catId);//evict a particular collection of kittens
sessionFactory.evictCollection("Cat.kittens"); //evictall kitten collections
CacheMode参数用于控制具体的Session如何与二级缓存进行交互。
- CacheMode.NORMAL - 从二级缓存中读、写数据。
- CacheMode.GET - 从二级缓存中读取数据,仅在数据更新时对二级缓存写数据。
- CacheMode.PUT - 仅向二级缓存写数据,但不从二级缓存中读数据。
- CacheMode.REFRESH - 仅向二级缓存写数据,但不从二级缓存中读数据。通过hibernate.cache.use_minimal_puts的设置,强制二级缓存从数据库中读取数据,刷新缓存内容。
如若需要查看二级缓存或查询缓存区域的内容,你可以使用统计(Statistics)API。
Map cacheEntries = sessionFactory.getStatistics()
.getSecondLevelCacheStatistics(regionName)
此时,你必须手工打开统计选项。可选的,你可以让Hibernate更人工可读的方式维护缓存内容。
hibernate.generate_statistics true
hibernate.cache.use_structured_entries true
查询的结果集也可以被缓存。只有当经常使用同样的参数进行查询时,这才会有些用处。要使用查询缓存,首先你必须打开它:
hibernate.cache.use_query_cache true
如果你要对查询缓存的失效政策进行精确的控制,你必须调用Query.setCacheRegion()方法,为每个查询指定其命名的缓存区域。
List blogs = sess.createQuery("from Blog blog whereblog.blogger = :blogger")
.setEntity("blogger", blogger)
19.5. 理解集合性能(Understanding Collection performance)
前面我们已经对集合进行了足够的讨论。本段中,我们将着重讲述集合在运行时的事宜。
<idbag>映射定义了代理键,因此它总是可以很高效的被更新。事实上,<idbag>拥有着最好的性能表现。
请注意:对于一对多关联来说,“主键”很可能并不是数据库表的物理主键。但就算在此情况下,上面的分类仍然是有用的。(它仍然反映了Hibernate在集合的各数据行中是如何进行“定位”的。)
19.5.2. Lists, maps 和sets用于更新效率最高
根据我们上面的讨论,显然有序集合类型和大多数set都可以在增加、删除、修改元素中拥有最好的性能。
Parent p = (Parent) sess.load(Parent.class, id);
p.getChildren().add(c); //no needto fetch the collection!
19.5.4. 一次性删除(One shot delete)
偶尔的,逐个删除集合类中的元素是相当低效的。Hibernate并没那么笨,如果你想要把整个集合都删除(比如说调用list.clear()),Hibernate只需要一个DELETE就搞定了。
假设我们在一个长度为20的集合类中新增加了一个元素,然后再删除两个。 Hibernate会安排一条INSERT语句和两条DELETE语句(除非集合类是一个bag)。这当然是显而易见的。
但是,假设我们删除了18个数据,只剩下2个,然后新增3个。则有两种处理方式:
Hibernate还没那么聪明,知道第二种选择可能会比较快。(也许让Hibernate不这么聪明也是好事,否则可能会引发意外的“数据库触发器”之类的问题。)
幸运的是,你可以强制使用第二种策略。你需要取消原来的整个集合类(解除其引用),然后再返回一个新的实例化的集合类,只包含需要的元素&112290;有些时候这是非常有用的。
显然,一次性删除并不适用于被映射为inverse="true"的集合。
19.6. 监测性能(Monitoring performance)
没有监测和性能参数而进行优化是毫无意义的。Hibernate为其内部操作提供了一系列的示意图,因此可以从每个SessionFactory抓取其统计数据。
你可以有两种方式访问SessionFactory的数据记录,第一种就是自己直接调用sessionFactory.getStatistics()方法读取、显示统计数据。
// MBean service registration for a specific SessionFactory
Hashtable tb = new Hashtable();
tb.put("sessionFactory", "myFinancialApp");
ObjectName on = new ObjectName("hibernate", tb); //MBean object name
StatisticsService stats = new StatisticsService(); // MBeanimplementation
stats.setSessionFactory(sessionFactory); // Bind the stats to aSessionFactory
server.registerMBean(stats, on); // Register the Mbean on theserver
// MBean service registration for all SessionFactory's
Hashtable tb = new Hashtable();
tb.put("sessionFactory", "all");
ObjectName on = new ObjectName("hibernate", tb); //MBean object name
StatisticsService stats = new StatisticsService(); // MBeanimplementation
server.registerMBean(stats, on); // Register the MBean on theserver
你可以通过以下方法打开或关闭SessionFactory的监测功能:
你也可以在程序中调用clear()方法重置统计数据,调用logSummary()在日志中记录(info级别)其总结。
Hibernate提供了一系列数据记录,其记录的内容包括从最基本的信息到与具体场景的特殊信息。所有的测量值都可以由Statistics接口进行访问,主要分为三类:
Statistics stats = HibernateUtil.sessionFactory.getStatistics();
double queryCacheHitCount = stats.getQueryCacheHitCount();
double queryCacheMissCount = stats.getQueryCacheMissCount();
queryCacheHitCount /(queryCacheHitCount + queryCacheMissCount);
log.info("Query Hit ratio:" + queryCacheHitRatio);
EntityStatistics entityStats =
stats.getEntityStatistics( Cat.class.getName() );
+entityStats.getDeleteCount();
log.info(Cat.class.getName() + " changed " + changes +"times" );
可以通过一系列Eclipse插件、命令行工具和Ant任务来进行与Hibernate关联的转换。
除了Ant任务外,当前的Hibernate Tools也包含了Eclipse IDE的插件,用于与现存数据库的逆向工程。
- Mapping Editor: Hibernate XML映射文件的编辑器,支持自动完成和语法高亮。它也支持对类名和属性/字段名的语义自动完成,比通常的XML编辑器方便得多。
- Console: Console是Eclipse的一个新视图。除了对你的console配置的树状概览,你还可以获得对你持久化类及其关联的交互式视图。Console允许你对数据库执行HQL查询,并直接在Eclipse中浏览结果。
- Development Wizards: 在Hibernate Eclipse tools中还提供了几个向导;你可以用向导快速生成Hibernate 配置文件(cfg.xml),你甚至还可以同现存的数据库schema中反向工程出POJO源代码与Hibernate 映射文件。反向工程支持可定制的模版。
- Ant Tasks:
要得到更多信息,请查阅Hibernate Tools包及其文档。
同时,Hibernate主发行包还附带了一个集成的工具(它甚至可以在Hibernate“内部”快速运行)SchemaExport,也就是hbm2ddl。
20.1. Schema自动生成(Automatic schema generation)
可以从你的映射文件使用一个Hibernate工具生成DDL。生成的schema包含有对实体和集合类表的完整性引用约束(主键和外键)。涉及到的标示符生成器所需的表和sequence也会同时生成。
在使用这个工具的时候,你必须通过hibernate.dialet属性指定一个SQL方言(Dialet),因为DDL是与供应商高度相关的。
20.1.1.对schema定制化(Customizingthe schema)
很多Hibernate映射元素定义了可选的length、precision或者scale属性。你可以通过这个属性设置字段的长度、精度、小数点位数。
<property name="zip" length="5"/>
<property name="balance" precision="12"scale="2"/>
有些tag还接受not-null属性(用来在表字段上生成NOT NULL约束)和unique属性(用来在表字段上生成UNIQUE约束)。
<many-to-one name="bar" column="barId" not-null="true"/>
<element column="serialNumber"type="long" not-null="true" unique="true"/>
<many-to-one name="org" column="orgId"unique-key="OrgEmployeeId"/>
<property name="employeeId"unique-key="OrgEmployee"/>
index属性会用对应的字段(一个或多个)生成一个index,它指出了这个index的名字。如果多个字段对应的index名字相同,就会生成包含这些字段的index。
<property name="lastName"index="CustName"/>
<property name="firstName"index="CustName"/>
foreign-key属性可以用来覆盖任何生成的外键约束的名字。
<many-to-one name="bar" column="barId"foreign-key="FKFooBar"/>
很多映射元素还接受<column>子元素。这在定义跨越多字段的类型时特别有用。
<property name="name"type="my.customtypes.Name"/>
<columnname="last" not-null="true" index="bar_idx"length="30"/>
<columnname="first" not-null="true" index="bar_idx"length="20"/>
default属性为字段指定一个默认值 (在保存被映射的类的新实例之前,你应该将同样的值赋于对应的属性)。
<property name="credits" type="integer"insert="false">
<columnname="credits" default="10"/>
<version name="version" type="integer"insert="false">
<columnname="version" default="0"/>
sql-type属性允许用户覆盖默认的Hibernate类型到SQL数据类型的映射。
<property name="balance" type="float">
<column name="balance"sql-type="decimal(13,3)"/>
<property name="foo" type="integer">
<columnname="foo" check="foo > 10"/>
<class name="Foo" table="foos"check="bar < 100.0">
<propertyname="bar" type="float"/>
表20.1. Summary
属性(Attribute) |
值(Values) |
解释(Interpretation) |
length |
数字 |
字段长度 |
precision |
数字 |
精度(decimal precision) |
scale |
数字 |
小数点位数(decimal scale) |
not-null |
true|false |
指明字段是否应该是非空的 |
unique |
true|false |
指明是否该字段具有惟一约束 |
index |
index_name |
指明一个(多字段)的索引(index)的名字 |
unique-key |
unique_key_name |
指明多字段惟一约束的名字(参见上面的说明) |
foreign-key |
foreign_key_name |
specifies the name of the foreign key constraint generated for an association, for a <one-to-one>, <many-to-one>, <key>, or <many-to-many> mapping element. Note that inverse="true" sides will not be considered by SchemaExport. 指明一个外键的名字,它是为关联生成的,或者<one-to-one>,<many-to-one>, <key>, 或者<many-to-many>映射元素。注意inverse="true"在SchemaExport时会被忽略。 |
sql-type |
SQL 字段类型 |
覆盖默认的字段类型(只能用于<column>属性) |
default |
SQL表达式 |
为字段指定默认值 |
check |
SQL 表达式 |
对字段或表加入SQL约束检查 |
<comment>元素可以让你在生成的schema中加入注释。
<class name="Customer"table="CurCust">
<comment>Currentcustomers only</comment>
...
</class>
<property name="balance">
<columnname="bal">
<comment>Balance in USD</comment>
</column>
</property>
结果是在生成的DDL中包含commenton table或者comment on column语句(假若支持的话)。
SchemaExport工具把DDL脚本写到标准输出,同时/或者执行DDL语句。
java -cphibernate_classpathsorg.hibernate.tool.hbm2ddl.SchemaExportoptions mapping_files
表20.2.SchemaExport命令行选项
选项 |
说明 |
--quiet |
不要把脚本输出到stdout |
--drop |
只进行drop tables的步骤 |
--create |
只创建表 |
--text |
不执行在数据库中运行的步骤 |
--output=my_schema.ddl |
把输出的ddl脚本输出到一个文件 |
--naming=eg.MyNamingStrategy |
选择一个命名策略(NamingStrategy) |
--config=hibernate.cfg.xml |
从XML文件读入Hibernate配置 |
--properties=hibernate.properties |
从文件读入数据库属性 |
--format |
把脚本中的SQL语句对齐和美化 |
--delimiter=; |
为脚本设置行结束符 |
你甚至可以在你的应用程序中嵌入SchemaExport工具:
Configuration cfg = ....;
new SchemaExport(cfg).create(false, true);
表20.3. SchemaExport 连接属性
属性名 |
说明 |
hibernate.connection.driver_class |
jdbc driver class |
hibernate.connection.url |
jdbc url |
hibernate.connection.username |
database user |
hibernate.connection.password |
user password |
hibernate.dialect |
方言(dialect) |
你可以在你的Ant build脚本中调用SchemaExport:
classname="org.hibernate.tool.hbm2ddl.SchemaExportTask"
properties="hibernate.properties"
20.1.5.对schema的增量更新(Incrementalschema updates)
SchemaUpdate工具对已存在的schema采用"增量"方式进行更新。注意SchemaUpdate严重依赖于JDBC metadata API,所以它并非对所有JDBC驱动都有效。
java -cphibernate_classpathsorg.hibernate.tool.hbm2ddl.SchemaUpdateoptions mapping_files
表20.4.SchemaUpdate命令行选项
选项 |
说明 |
--quiet |
不要把脚本输出到stdout |
--text |
不把脚本输出到数据库 |
--naming=eg.MyNamingStrategy |
选择一个命名策略 (NamingStrategy) |
--properties=hibernate.properties |
从指定文件读入数据库属性 |
--config=hibernate.cfg.xml |
指定一个 .cfg.xml文件 |
你可以在你的应用程序中嵌入SchemaUpdate工具:
Configuration cfg = ....;
new SchemaUpdate(cfg).execute(false);
20.1.6.用Ant来增量更新schema(UsingAnt for incremental schema updates)
classname="org.hibernate.tool.hbm2ddl.SchemaUpdateTask"
properties="hibernate.properties"
java -cphibernate_classpathsorg.hibernate.tool.hbm2ddl.SchemaValidatoroptions mapping_files
表20.5.SchemaValidator命令行参数
选项 |
描述 |
--naming=eg.MyNamingStrategy |
选择一个命名策略 (NamingStrategy) |
--properties=hibernate.properties |
从文件中读取数据库属性 |
--config=hibernate.cfg.xml |
指定一个.cfg.xml文件 |
你可以在你的应用程序中嵌入SchemaValidator:
Configuration cfg = ....;
new SchemaValidator(cfg).validate();
<target name="schemavalidate">
<taskdefname="schemavalidator"
classname="org.hibernate.tool.hbm2ddl.SchemaValidatorTask"
properties="hibernate.properties">
第21章示例:父子关系(ParentChild Relationships)
Hibernate collections被当作其所属实体而不是其包含实体的一个逻辑部分。这非常重要!它主要体现为以下几点:
- 当删除或增加collection中对象的时候,collection所属者的版本值会递增。
- 如果一个从collection中移除的对象是一个值类型(value type)的实例,比如composite element,那么这个对象的持久化状态将会终止,其在数据库中对应的记录会被删除。同样的,向collection增加一个value type的实例将会使之立即被持久化。
- 另一方面,如果从一对多或多对多关联的collection中移除一个实体,在缺省情况下这个对象并不会被删除。这个行为是完全合乎逻辑的--改变一个实体的内部状态不应该使与它关联的实体消失掉!同样的,向collection增加一个实体不会使之被持久化。
21.2.双向的一对多关系(Bidirectional one-to-many)
假设我们要实现一个简单的从Parent到Child的<one-to-many>关联。
这样做不仅效率低,而且违反了列parent_id非空的限制。我们可以通过在集合类映射上指定not-null="true"来解决违反非空约束的问题:
<keycolumn="parent_id" not-null="true"/>
这种现象的根本原因是从p到c的连接(外键parent_id)没有被当作Child对象状态的一部分,因而没有在INSERT语句中被创建。因此解决的办法就是把这个连接添加到Child的映射中。
<many-to-one name="parent"column="parent_id" not-null="true"/>
现在实体Child在管理连接的状态,为了使collection不更新连接,我们使用inverse属性。
<set name="children" inverse="true">
Parent p = (Parent) session.load(Parent.class, pid);
为了让事情变得井井有条,可以为Parent加一个addChild()方法。
public void addChild(Child c) {
Parent p = (Parent) session.load(Parent.class, pid);
21.3.级联生命周期(Cascading lifecycle)
需要显式调用save()仍然很麻烦,我们可以用级联来解决这个问题。
<set name="children" inverse="true"cascade="all">
Parent p = (Parent) session.load(Parent.class, pid);
同样的,保存或删除Parent对象的时候并不需要遍历其子对象。下面的代码会删除对象p及其所有子对象对应的数据库记录。
Parent p = (Parent) session.load(Parent.class, pid);
Parent p = (Parent) session.load(Parent.class, pid);
Child c = (Child) p.getChildren().iterator().next();
不会从数据库删除c;它只会删除与p之间的连接(并且会导致违反NOT NULL约束,在这个例子中)。你需要显式调用delete()来删除Child。
Parent p = (Parent) session.load(Parent.class, pid);
Child c = (Child) p.getChildren().iterator().next();
在我们的例子中,如果没有父对象,子对象就不应该存在,如果将子对象从collection中移除,实际上我们是想删除它。要实现这种要求,就必须使用cascade="all-delete-orphan"。
<set name="children" inverse="true"cascade="all-delete-orphan">
21.4.级联与未保存值(Cascadesandunsaved-value)
下面的代码会更新parent和child对象,并且插入newChild对象。
//parent and child were both loaded in a previous session
这里有不少东西需要融会贯通,可能会让新手感到迷惑。但是在实践中它们都工作地非常好。大部分Hibernate应用程序都会经常用到父子对象模式。
下面的持久化类表示一个weblog和在其中张贴的一个贴子。他们是标准的父/子关系模型,但是我们会用一个有序包(ordered bag)而非集合(set)。
public void setId(Longlong1) {
public voidsetItems(List list) {
public voidsetName(String string) {
public CalendargetDatetime() {
public voidsetBlog(Blog blog) {
public voidsetDatetime(Calendar calendar) {
public void setId(Longlong1) {
public voidsetText(String string) {
public voidsetTitle(String string) {
<!DOCTYPE hibernate-mapping PUBLIC
"-//Hibernate/Hibernate Mapping DTD 3.0//EN"
"http://hibernate.sourceforge.net/hibernate-mapping-3.0.dtd">
<hibernate-mapping package="eg">
<one-to-many class="BlogItem"/>
<!DOCTYPE hibernate-mapping PUBLIC
"-//Hibernate/Hibernate Mapping DTD 3.0//EN"
"http://hibernate.sourceforge.net/hibernate-mapping-3.0.dtd">
<hibernate-mapping package="eg">
下面的类演示了我们可以使用Hibernate对这些类进行的一些操作。
import org.hibernate.HibernateException;
import org.hibernate.SessionFactory;
import org.hibernate.Transaction;
import org.hibernate.cfg.Configuration;
import org.hibernate.tool.hbm2ddl.SchemaExport;
private SessionFactory_sessions;
public voidconfigure() throws HibernateException {
_sessions = newConfiguration()
public voidexportTables() throws HibernateException {
Configuration cfg= new Configuration()
newSchemaExport(cfg).create(true, true);
public BlogcreateBlog(String name) throws HibernateException {
blog.setItems( newArrayList() );
Session session =_sessions.openSession();
tx =session.beginTransaction();
catch(HibernateException he) {
public BlogItemcreateBlogItem(Blog blog, String title, String text)
BlogItem item =new BlogItem();
item.setDatetime(Calendar.getInstance() );
Session session =_sessions.openSession();
tx =session.beginTransaction();
catch(HibernateException he) {
public BlogItemcreateBlogItem(Long blogid, String title, String text)
BlogItem item =new BlogItem();
item.setDatetime(Calendar.getInstance() );
Session session =_sessions.openSession();
tx =session.beginTransaction();
Blog blog =(Blog) session.load(Blog.class, blogid);
catch(HibernateException he) {
public voidupdateBlogItem(BlogItem item, String text)
Session session =_sessions.openSession();
tx =session.beginTransaction();
catch(HibernateException he) {
public voidupdateBlogItem(Long itemid, String text)
Session session =_sessions.openSession();
tx =session.beginTransaction();
BlogItem item= (BlogItem) session.load(BlogItem.class, itemid);
catch(HibernateException he) {
public ListlistAllBlogNamesAndItemCounts(int max)
Session session = _sessions.openSession();
tx =session.beginTransaction();
"select blog.id, blog.name, count(blogItem) " +
"leftouter join blog.items as blogItem " +
"group by blog.name, blog.id " +
"order by max(blogItem.datetime)"
catch(HibernateException he) {
public BloggetBlogAndAllItems(Long blogid)
Session session =_sessions.openSession();
tx =session.beginTransaction();
"leftouter join fetch blog.items " +
q.setParameter("blogid", blogid);
blog = (Blog) q.uniqueResult();
catch(HibernateException he) {
public ListlistBlogsAndRecentItems() throws HibernateException {
Session session =_sessions.openSession();
tx =session.beginTransaction();
"inner join blog.items as blogItem " +
"where blogItem.datetime > :minDate"
Calendar cal =Calendar.getInstance();
cal.roll(Calendar.MONTH, false);
q.setCalendar("minDate", cal);
catch(HibernateException he) {
23.1. Employer(雇主)/Employee(雇员)
<classname="Employer" table="employers">
<paramname="sequence">employer_id_seq</param>
<classname="Employment" table="employment_periods">
<paramname="sequence">employment_id_seq</param>
<propertyname="startDate" column="start_date"/>
<propertyname="endDate" column="end_date"/>
<componentname="hourlyRate" class="MonetaryAmount">
<columnname="hourly_rate" sql-type="NUMERIC(12, 2)"/>
<propertyname="currency" length="12"/>
<many-to-onename="employer" column="employer_id"not-null="true"/>
<many-to-onename="employee" column="employee_id"not-null="true"/>
<classname="Employee" table="employees">
<paramname="sequence">employee_id_seq</param>
<propertyname="taxfileNumber"/>
<componentname="name" class="Name">
create table employment_periods (
alter table employment_periods
add constraintemployment_periodsFK0 foreign key (employer_id) references employers
alter table employment_periods
add constraintemployment_periodsFK1 foreign key (employee_id) references employees
create sequence employee_id_seq
create sequence employment_id_seq
create sequence employer_id_seq
考虑下面的Work,Author和Person模型的关系。我们用多对多关系来描述Work和Author,用一对一关系来描述Author和Person,另一种可能性是Author继承Person。
<classname="Work" table="works"discriminator-value="W">
<discriminatorcolumn="type" type="character"/>
<setname="authors" table="author_work">
<many-to-many class="Author" columnname="author_id"/>
<subclassname="Book" discriminator-value="B">
<subclassname="Song" discriminator-value="S">
<classname="Author" table="authors">
<!-- The Author must have the sameidentifier as the Person -->
<one-to-onename="person" constrained="true"/>
<setname="works" table="author_work"inverse="true">
<many-to-many class="Work" column="work_id"/>
<classname="Person" table="persons">
id BIGINT not nullgenerated by default as identity,
primary key (work_id,author_id)
id BIGINT not nullgenerated by default as identity,
id BIGINT not nullgenerated by default as identity,
add constraintauthorsFK0 foreign key (id) references persons
add constraintauthor_workFK0 foreign key (author_id) references authors
add constraintauthor_workFK1 foreign key (work_id) references works
23.3. Customer(客户)/Order(订单)/Product(产品)
<classname="Customer" table="customers">
<setname="orders" inverse="true">
<classname="Order" table="orders">
<many-to-onename="customer" column="customer_id"/>
<listname="lineItems" table="line_items">
<list-indexcolumn="line_number"/>
<composite-elementclass="LineItem">
<many-to-one name="product"column="product_id"/>
<classname="Product" table="products">
<propertyname="serialNumber"/>
id BIGINT not nullgenerated by default as identity,
id BIGINT not nullgenerated by default as identity,
primary key (order_id,line_number)
id BIGINT not nullgenerated by default as identity,
add constraintordersFK0 foreign key (customer_id) references customers
add constraintline_itemsFK0 foreign key (product_id) references products
add constraintline_itemsFK1 foreign key (order_id) references orders
这些例子全部来自于Hibernate的testsuite,同时你也可以找到其他有用的例子。可以参考Hibernate的test目录。
TODO: put words around this stuff
23.4.1. "Typed" one-to-one association
<one-to-onename="mailingAddress"
<class name="Address" batch-size="2"
check="addressType in ('MAILING', 'HOME', 'BUSINESS')">
<key-many-to-one name="person"
<property name="street"type="text"/>
<propertyname="name" not-null="true" length="100"/>
<propertyname="address" not-null="true" length="200"/>
<class name="Order" table="CustomerOrder"lazy="true">
<synchronizetable="LineItem"/>
<key-propertyname="customerId" length="10"/>
<key-propertyname="orderNumber"/>
( selectsum(li.quantity*p.price)
whereli.productId = p.productId
andli.orderNumber = orderNumber )
<one-to-manyclass="LineItem"/>
<key-propertyname="customerId" length="10"/>
<key-propertyname="orderNumber"/>
<key-propertyname="productId" length="10"/>
<synchronizetable="LineItem"/>
<propertyname="price" length="3"/>
<propertyname="numberAvailable"/>
<propertyname="numberOrdered">
whereli.productId = productId )
23.4.3.共有组合键属性的多对多(Many-to-many with shared composite key attribute)
<class name="User" table="`User`">
<setname="groups" table="UserGroup">
<class name="Group" table="`Group`">
<setname="users" table="UserGroup" inverse="true">
23.4.4. Content based discrimination
when titleis not null then 'E'
whensalesperson is not null then 'C'
<many-to-one name="salesperson"/>
23.4.5. Associations on alternate keys
<propertyname="name" length="100"/>
<propertyname="userId" length="8"/>
<propertyname="address" length="300"/>
<propertyname="zip" length="5"/>
<propertyname="country" length="25"/>
<many-to-onename="person" unique="true" not-null="true"/>
<idname="accountId" length="32">
<propertyname="type" not-null="true"/>
设计细颗粒度的持久类并且使用<component>来实现映射。
使用一个Address持久类来封装street,suburb,state,postcode. 这将有利于代码重用和简化代码重构(refactoring)的工作。
对持久类声明标识符属性( identifier properties)。
Hibernate中标识符属性是可选的,不过有很多原因来说明你应该使用标识符属性。我们建议标识符应该是“人造”的(自动生成,不涉及业务含义)。
对所有的实体都标识出自然键,用<natural-id>进行映射。实现equals()和hashCode(),在其中用组成自然键的属性进行比较。
不要把所有的持久类映射都写到一个大文件中。把com.eg.Foo映射到com/eg/Foo.hbm.xml中,在团队开发环境中,这一点显得特别有意义。
如果你的查询中调用了非ANSI标准的SQL函数,那么这条实践经验对你适用。把查询字符串放在映射文件中可以让程序具有更好的可移植性。
就像在JDBC编程中一样,应该总是用占位符"?"来替换非常量值,不要在查询中用字符串值来构造非常量值!更好的办法是在查询中使用命名参数。
在三层结构中,考虑使用托管对象(detached object)
在两层结构中,考虑使用长持久上下文(long persistence contexts).
使用open session in view模式,或者执行严格的装配期(assembly phase)策略来避免再次抓取数据带来的问题
单向关联更加难于查询。在大型应用中,几乎所有的关联必须在查询中可以双向导航。
HIBERNATE - 符合Java习惯的关系数据库持久化 Hibernate参考文档相关推荐
- hibernate参考文档
http://docs.jboss.org/hibernate/annotations/3.4/reference/zh_cn/html_single/#d0e224 Hibernate Annota ...
- dita文档_使用DITADoclet和DITA API专业化生成DITA Java™API参考文档
dita文档 2009年12月11日修订说明:在" 目标"和" 安装org.dita.dost插件 "标题下添加了两个指向可下载资源的链接. 2014年3月7日 ...
- java hibernate详细_Java事务管理学习之Hibernate详细介绍
hibernate是jdbc轻量级的封装,本身不具备事务管理的能力,在事物管理层面,一般是委托于底层的jdbc和jta来完成调度的.下面这篇文章主要给大家介绍了Java事务管理学习之Hibernate ...
- Java程序员从笨鸟到菜鸟之(五十一)细谈Hibernate(二)开发第一个hibernate基本详解...
在上篇博客中,我们介绍了<hibernate基本概念和体系结构>,也对hibernate框架有了一个初步的了解,本文我将向大家简单介绍Hibernate的核心API调用库,并讲解一下它的基 ...
- (转)Hibernate框架基础——在Hibernate中java对象的状态
http://blog.csdn.net/yerenyuan_pku/article/details/52760627 在Hibernate中java对象的状态 Hibernate把对象分为4种状态: ...
- Java大对象类型的Hibernate映射
在 Java 中, java.lang.String 可用于表示长字符串(长度超过 255 ),字节数组 byte[] 可以用于存放图片户或文件二进制数据.此外,在 JDBC API 中还提供了 ja ...
- 5 Hibernate:Java Persistence API (JPA) 入门
Java Persistence API (JPA),Java 持久层 API,是 JCP 组织发布的 Java EE 标准规范,通过注解或 XML 描述实体对象和数据库表的映射关系. Hiberna ...
- java中一级缓存_JavaWeb_(Hibernate框架)Hibernate中一级缓存
Hibernate中一级缓存 Hibernate 中的缓存分为一级缓存和二级缓存,这两个级别的缓存都位于持久化层,并且存储的都是数据库数据的备份.其中一级缓存是 Hibernate 的内置缓存,在前面 ...
- java hibernate oracle,Java笔记8:Hibernate连接Oracle
1下载hibernate-3.6.0 Final.zip到任意目录,解压缩后得到hibernate目录 2下载slf4j-1.7.13.zip到任意目录,解压缩后得到slf4j-1.7.13 3 ...
最新文章
- linux c 各头文件作用总结
- Python进阶09 动态类型
- Todolist总结
- 计算机考研英语什么时候考试,计算机考研:早期复习三大注意事项
- 大工19春《计算机组成原理》,大工19春《计算机组成原理》在线作业3.doc
- Shell脚本编程之(一)Shell脚本简介
- Ubuntu20.04更新源步骤
- 关于回归中国、反垄断等问题,Google CEO 亲口回应了
- 闪电html编辑器,闪电pdf编辑器
- 16位华人获“诺奖风向标”斯隆奖,4人来自北大数院
- AndroidStudio 之Safe Delete 安全删除
- 定制交友盲盒软件 交友盲盒软件开发 交友软件系统开发
- 如何做好项目规划?以及项目规划常用的管理软件盘点
- c# 正则表达式 Group
- python etl工具 sqoop hive_python脚本 用sqoop把mysql数据导入hive
- SAI绘制月下狼嚎图
- Java基于springboot+vue的房屋出租租房系统 前后端分离
- webview 清除缓存的方式
- DNS中的正向解析与反向解析 及 nslookup命令使用
- Android手机通过USB线共享电脑的网络上网