Hibernate.orgCommunity Documentation

HIBERNATE - Relational Persistence for Idiomatic Java

Hibernate Reference Documentation

由 Gavin King、Christian Bauer、Max Rydahl Andersen、Emmanuel Bernard和Steve Ebersole
and thanks to James Cobb (Graphic Design)、Cheyenne Weaver (Graphic Design)和Cao RedSaga Xiaogang

3.5.6-Final

版权 © 2004 Red Hat, Inc.

Legal Notice

September 15, 2010

前言
1. 教程
1.1. 第一部分 － 第一个 Hibernate 应用程序
1.1.1. 设置
1.1.2. 第一个 class
1.1.3. 映射文件
1.1.4. Hibernate 配置
1.1.5. 用 Maven 构建
1.1.6. 启动和辅助类
1.1.7. 加载并存储对象
1.2. 第二部分 － 关联映射
1.2.1. 映射 Person 类
1.2.2. 单向 Set-based 的关联
1.2.3. 使关联工作
1.2.4. 值类型的集合
1.2.5. 双向关联
1.2.6. 使双向连起来
1.3. 第三部分 - EventManager web 应用程序
1.3.1. 编写基本的 servlet
1.3.2. 处理与渲染
1.3.3. 部署与测试
1.4. 总结
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. 外连接抓取（Outer Join 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. 持久化类（Persistent Classes）
4.1. 一个简单的 POJO 例子
4.1.1. 实现一个默认的（即无参数的）构造方法（constructor）
4.1.2. 提供一个标识属性（identifier property）（可选）
4.1.3. 使用非final的类（可选）
4.1.4. 为持久化字段声明访问器（accessors）和是否可变的标志（mutators）（可选）
4.2. 实现继承（Inheritance）
4.3. 实现 equals() 和 hashCode() 方法：
4.4. 动态模型（Dynamic models）
4.5. 元组片断映射（Tuplizers）
4.6. EntityNameResolvers
5. 对象/关系数据库映射基础（Basic O/R Mapping）
5.1. 映射定义（Mapping declaration）
5.1.1. Doctype
5.1.2. Hibernate-mapping
5.1.3. 类
5.1.4. id
5.1.5. 增强的标识符生成器
5.1.6. 标识符生成器的优化
5.1.7. composite-id
5.1.8. 鉴别器（discriminator）
5.1.9. 版本（version）（可选）
5.1.10. timestamp（可选)
5.1.11. Property
5.1.12. 多对一（many-to-one）
5.1.13. 一对一
5.1.14. 自然 ID（natural-id）
5.1.15. 组件（component）和动态组件（dynamic-component）
5.1.16. 属性（Properties）
5.1.17. 子类（subclass）
5.1.18. 连接的子类（joined-subclass）
5.1.19. 联合子类（union-subclass）
5.1.20. 连接（join）
5.1.21. Key
5.1.22. 字段和规则元素（column and formula elements）
5.1.23. 引用（import）
5.1.24. 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. 字段的读写表达式
5.8. 辅助数据库对象（Auxiliary Database Objects）
6. 集合映射（Collection mappings）
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 and many-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. Using an <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 join tables）
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 join tables）
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 的索引（Components as Map indices ）
8.4. 组件作为联合标识符（Components as composite identifiers）
8.5. 动态组件（Dynamic components）
9. 继承映射（Inheritance Mapping）
9.1. 三种策略
9.1.1. 每个类分层结构一张表（Table per class hierarchy）
9.1.2. 每个子类一张表（Table per subclass）
9.1.3. 每个子类一张表（Table per subclass），使用辨别标志（Discriminator）
9.1.4. 混合使用“每个类分层结构一张表”和“每个子类一张表”
9.1.5. 每个具体类一张表（Table per concrete class）
9.1.6. 每个具体类一张表，使用隐式多态
9.1.7. 隐式多态和其他继承映射混合使用
9.2. 限制
10. 与对象共事
10.1. Hibernate 对象状态（object states）
10.2. 使对象持久化
10.3. 装载对象
10.4. 查询
10.4.1. 执行查询
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. Read-only entities
11.1. Making persistent entities read-only
11.1.1. Entities of immutable classes
11.1.2. Loading persistent entities as read-only
11.1.3. Loading read-only entities from an HQL query/criteria
11.1.4. Making a persistent entity read-only
11.2. Read-only affect on property type
11.2.1. Simple properties
11.2.2. Unidirectional associations
11.2.3. Bidirectional associations
12. 事务和并发
12.1. Session 和事务范围（transaction scope）
12.1.1. 操作单元（Unit of work）
12.1.2. 长对话
12.1.3. 关注对象标识（Considering object identity）
12.1.4. 常见问题
12.2. 数据库事务声明
12.2.1. 非托管环境
12.2.2. 使用 JTA
12.2.3. 异常处理
12.2.4. 事务超时
12.3. 乐观并发控制（Optimistic concurrency control）
12.3.1. 应用程序级别的版本检查（Application version checking）
12.3.2. 扩展周期的 session 和自动版本化
12.3.3. 脱管对象（deatched object）和自动版本化
12.3.4. 定制自动版本化行为
12.4. 悲观锁定（Pessimistic Locking）
12.5. 连接释放模式（Connection Release Modes）
13. 拦截器与事件（Interceptors and events）
13.1. 拦截器（Interceptors）
13.2. 事件系统（Event system）
13.3. Hibernate 的声明式安全机制
14. 批量处理（Batch processing）
14.1. 批量插入（Batch inserts）
14.2. 批量更新（Batch updates）
14.3. StatelessSession（无状态 session）接口
14.4. DML（数据操作语言）风格的操作（DML-style operations）
15. HQL: Hibernate 查询语言
15.1. 大小写敏感性问题
15.2. from 子句
15.3. 关联（Association）与连接（Join）
15.4. join 语法的形式
15.5. 引用 identifier 属性
15.6. select 子句
15.7. 聚集函数
15.8. 多态查询
15.9. where 子句
15.10. 表达式
15.11. order by 子句
15.12. group by 子句
15.13. 子查询
15.14. HQL 示例
15.15. 批量的 UPDATE 和 DELETE
15.16. 小技巧 & 小窍门
15.17. 组件
15.18. Row value 构造函数语法
16. 条件查询（Criteria Queries）
16.1. 创建一个 Criteria 实例
16.2. 限制结果集内容
16.3. 结果集排序
16.4. 关联
16.5. 动态关联抓取
16.6. 查询示例
16.7. 投影（Projections）、聚合（aggregation）和分组（grouping）
16.8. 离线（detached）查询和子查询
16.9. 根据自然标识查询（Queries by natural identifier）
17. Native SQL 查询
17.1. 使用 SQLQuery
17.1.1. 标量查询（Scalar queries）
17.1.2. 实体查询（Entity queries）
17.1.3. 处理关联和集合类（Handling associations and collections）
17.1.4. 返回多个实体（Returning multiple entities）
17.1.5. 返回非受管实体（Returning non-managed entities）
17.1.6. 处理继承（Handling inheritance）
17.1.7. 参数（Parameters）
17.2. 命名 SQL 查询
17.2.1. 使用 return-property 来明确地指定字段／别名
17.2.2. 使用存储过程来查询
17.3. 定制 SQL 用来 create，update 和 delete
17.4. 定制装载 SQL
18. 过滤数据
18.1. Hibernate 过滤器（filters）
19. XML 映射
19.1. 用 XML 数据进行工作
19.1.1. 指定同时映射 XML 和类
19.1.2. 只定义 XML 映射
19.2. XML 映射元数据
19.3. 操作 XML 数据
20. 提升性能
20.1. 抓取策略（Fetching strategies）
20.1.1. 操作延迟加载的关联
20.1.2. 调整抓取策略（Tuning fetch strategies）
20.1.3. 单端关联代理（Single-ended association proxies）
20.1.4. 实例化集合和代理（Initializing collections and proxies）
20.1.5. 使用批量抓取（Using batch fetching）
20.1.6. 使用子查询抓取（Using subselect fetching）
20.1.7. Fetch profile（抓取策略）
20.1.8. 使用延迟属性抓取（Using lazy property fetching）
20.2. 二级缓存（The Second Level Cache）
20.2.1. 缓存映射（Cache mappings）
20.2.2. 策略：只读缓存（Strategy：read only）
20.2.3. 策略：读写/缓存（Strategy：read/write）
20.2.4. 策略：非严格读/写缓存（Strategy：nonstrict read/write）
20.2.5. 策略：事务缓存（transactional）
20.2.6. 各种缓存提供商/缓存并发策略的兼容性
20.3. 管理缓存（Managing the caches）
20.4. 查询缓存（The Query Cache）
20.4.1. 启用查询缓存
20.4.2. 查询缓存区
20.5. 理解集合性能（Understanding Collection performance）
20.5.1. 分类（Taxonomy）
20.5.2. Lists，maps 和 sets 用于更新效率最高
20.5.3. Bag 和 list 是反向集合类中效率最高的
20.5.4. 一次性删除（One shot delete）
20.6. 监测性能（Monitoring performance）
20.6.1. 监测 SessionFactory
20.6.2. 数据记录（Metrics）
21. 工具箱指南
21.1. Schema 自动生成（Automatic schema generation）
21.1.1. 对 schema 定制化（Customizing the schema）
21.1.2. 运行该工具
21.1.3. 属性（Properties）
21.1.4. 使用 Ant（Using Ant）
21.1.5. 对 schema 的增量更新（Incremental schema updates）
21.1.6. 用 Ant 来增量更新 schema（Using Ant for incremental schema updates）
21.1.7. Schema 校验
21.1.8. 使用 Ant 进行 schema 校验
22. 示例：父子关系（Parent/Child）
22.1. 关于 collections 需要注意的一点
22.2. 双向的一对多关系（Bidirectional one-to-many）
22.3. 级联生命周期（Cascading lifecycle）
22.4. 级联与未保存值（unsaved-value）
22.5. 结论
23. 示例：Weblog 应用程序
23.1. 持久化类（Persistent Classes）
23.2. Hibernate 映射
23.3. Hibernate 代码
24. 示例：复杂映射实例
24.1. Employer（雇主）/Employee（雇员）
24.2. Author（作家）/Work（作品）
24.3. Customer（客户）/Order（订单）/Product（产品）
24.4. 杂例
24.4.1. "Typed" 一对一关联
24.4.2. 组合键示例
24.4.3. 共有组合键属性的多对多（Many-to-many with shared composite key attribute）
24.4.4. 基于内容的识别
24.4.5. 备用键的联合
25. 最佳实践（Best Practices）
26. 数据库移植性考量
26.1. 移植性基础
26.2. Dialect
26.3. 方言的使用
26.4. 标识符的生成
26.5. 数据库函数
26.6. 类型映射
参考资料

版权 © 2004 Red Hat, Inc.