# 5.1.11\. 一对一
持久化对象之间一对一的关联关系是通过`one-to-one`元素定义的。
```
<one-to-one
name="propertyName"
class="ClassName"
cascade="cascade_style"
constrained="true|false"
fetch="join|select"
property-ref="propertyNameFromAssociatedClass"
access="field|property|ClassName"
formula="any SQL expression"
lazy="proxy|no-proxy|false"
entity-name="EntityName"
node="element-name|@attribute-name|element/@attribute|."
embed-xml="true|false"
foreign-key="foreign_key_name"
/>
```
| ![1](https://box.kancloud.cn/2015-10-12_561bcb76795ae.png) | `name`: 属性的名字。 |
|:--- |:--- |
| ![2](https://box.kancloud.cn/2015-10-12_561bcb768596e.png) | `class` (可选 - 默认是通过反射得到的属性类型):被关联的类的名字。 |
| ![3](https://box.kancloud.cn/2015-10-12_561bcb94ee26f.png) | `cascade(级联)` (可选) 表明操作是否从父对象级联到被关联的对象。 |
| ![4](https://box.kancloud.cn/2015-10-12_561bcb9508b82.png) | `constrained(约束)` (可选) 表明该类对应的表对应的数据库表,和被关联的对象所对应的数据库表之间,通过一个外键引用对主键进行约束。 这个选项影响`save()`和`delete()`在级联执行时的先后顺序以及 决定该关联能否被委托(也在schema export tool中被使用). |
| ![5](https://box.kancloud.cn/2015-10-12_561bcb95133e7.png) | `fetch` (可选 - 默认设置为`选择`): 在外连接抓取或者序列选择抓取选择其一. |
| ![6](https://box.kancloud.cn/2016-01-06_568cdb4f32753.png) | `property-ref`: (可选) 指定关联类的属性名,这个属性将会和本类的主键相对应。如果没有指定,会使用对方关联类的主键。 |
| ![7](https://box.kancloud.cn/2016-01-06_568cdb4f41fcc.png) | `access` (可选 - 默认是 `property`): Hibernate用来访问属性的策略。 |
| ![8](https://box.kancloud.cn/2016-01-06_568cdb4f5948a.png) | `formula` (可选):绝大多数一对一的关联都指向其实体的主键。在一些少见的情况中, 你可能会指向其他的一个或多个字段,或者是一个表达式,这些情况下,你可以用一个SQL公式来表示。 (可以在org.hibernate.test.onetooneformula找到例子) |
| ![9](https://box.kancloud.cn/2016-01-06_568cdb4f68749.png) | `lazy` (可选 - 默认为 `proxy`): 默认情况下,单点关联是经过代理的。`lazy="no-proxy"`指定此属性应该在实例变量第一次被访问时应该延迟抓取(fetche lazily)(需要运行时字节码的增强)。 `lazy="false"`指定此关联总是被预先抓取。_注意,如果`constrained="false"`, 不可能使用代理,Hibernate会采取预先抓取!_ |
| ![10](https://box.kancloud.cn/2016-01-06_568cdb4f83cf0.png) | `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">
<id name="id" column="PERSON_ID">
<generator class="foreign">
<param name="property">employee</param>
</generator>
</id>
...
<one-to-one name="employee"
class="Employee"
constrained="true"/>
</class>
```
一个刚刚保存的`Person`实例被赋予和该`Person`的`employee`属性所指向的`Employee`实例同样的关键字值。
另一种方式是一个外键和一个惟一关键字对应,上面的`Employee`和`Person`的例子,如果使用这种关联方式,可以表达成:
```
<many-to-one name="person" class="Person" column="PERSON_ID" unique="true"/>
```
如果在`Person`的映射加入下面几句,这种关联就是双向的:
```
<one-to-one name"employee" class="Employee" property-ref="person"/>
```
- 前言
- 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. 外连接抓取(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)
- 第 5 章 对象/关系数据库映射基础(Basic O/R Mapping)
- 5.1. 映射定义(Mapping declaration)
- 5.1.1. Doctype
- 5.1.1.1. EntityResolver
- 5.1.2. hibernate-mapping
- 5.1.3. class
- 5.1.4. id
- 5.1.4.1. Generator
- 5.1.4.2. 高/低位算法(Hi/Lo Algorithm)
- 5.1.4.3. UUID算法(UUID Algorithm )
- 5.1.4.4. 标识字段和序列(Identity columns and Sequences)
- 5.1.4.5. 程序分配的标识符(Assigned Identifiers)
- 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 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. 使用<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 Mappings)
- 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. 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. 迭代式获取结果(Iterating results)
- 10.4.1.2. 返回元组(tuples)的查询
- 10.4.1.3. 标量(Scalar)结果
- 10.4.1.4. 绑定参数
- 10.4.1.5. 分页
- 10.4.1.6. 可滚动遍历(Scrollable iteration)
- 10.4.1.7. 外置命名查询(Externalizing named 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. 应用程序级别的版本检查(Application version checking)
- 11.3.2. 扩展周期的session和自动版本化
- 11.3.3. 脱管对象(deatched object)和自动版本化
- 11.3.4. 定制自动版本化行为
- 11.4. 悲观锁定(Pessimistic Locking)
- 11.5. 连接释放模式(Connection Release 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-style operations)
- 第 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.1.1. 标量查询(Scalar queries)
- 16.1.2. 实体查询(Entity queries)
- 16.1.3. 处理关联和集合类(Handling associations and collections)
- 16.1.4. 返回多个实体(Returning multiple entities)
- 16.1.4.1. 别名和属性引用(Alias and property references)
- 16.1.5. 返回非受管实体(Returning non-managed entities)
- 16.1.6. 处理继承(Handling inheritance)
- 16.1.7. 参数(Parameters)
- 16.2. 命名SQL查询
- 16.2.1. 使用return-property来明确地指定字段/别名
- 16.2.2. 使用存储过程来查询
- 16.2.2.1. 使用存储过程的规则和限制
- 16.3. 定制SQL用来create,update和delete
- 16.4. 定制装载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. 实例化集合和代理(Initializing collections and proxies)
- 19.1.5. 使用批量抓取(Using batch fetching)
- 19.1.6. 使用子查询抓取(Using subselect fetching)
- 19.1.7. 使用延迟属性抓取(Using lazy 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. 一次性删除(One shot delete)
- 19.6. 监测性能(Monitoring performance)
- 19.6.1. 监测SessionFactory
- 19.6.2. 数据记录(Metrics)
- 第 20 章 工具箱指南
- 20.1. Schema自动生成(Automatic schema generation)
- 20.1.1. 对schema定制化(Customizing the schema)
- 20.1.2. 运行该工具
- 20.1.3. 属性(Properties)
- 20.1.4. 使用Ant(Using Ant)
- 20.1.5. 对schema的增量更新(Incremental schema updates)
- 20.1.6. 用Ant来增量更新schema(Using Ant for incremental schema updates)
- 20.1.7. Schema 校验
- 20.1.8. 使用Ant进行schema校验
- 第 21 章 示例:父子关系(Parent Child 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-many with shared composite key attribute)
- 23.4.4. Content based discrimination
- 23.4.5. Associations on alternate keys
- 第 24 章 最佳实践(Best Practices)