<properties> 元素允许定义一个命名的逻辑分组(grouping)包含一个类中的多个属性。 这个元素最重要的用处是允许多个属性的组合作为property-ref的目标(target)。 这也是定义多字段唯一约束的一种方便途径。
<properties name="logicalName" (1) insert="true|false" (2) update="true|false" (3) optimistic-lock="true|false" (4) unique="true|false" (5) > <property ...../> <many-to-one .... /> ........ </properties>
(1) | name: 分组的逻辑名称 - 不是 实际属性的名称. |
(2) | insert: 被映射的字段是否出现在SQL的 INSERT语句中? |
(3) | update: 被映射的字段是否出现在SQL的 UPDATE语句中? |
(4) | optimistic-lock (可选 - 默认是 true):表明更新此组件是否需要获取乐观锁。换句话说,当这个属性变脏时,是否增加版本号(Version) |
(5) | unique (可选 - 默认是 false):表明组件映射的所有字段上都有唯一性约束 |
例如,如果我们有如下的<properties>映射:
<class name="Person"> <id name="personNumber"/> ... <properties name="name" unique="true" update="false"> <property name="firstName"/> <property name="initial"/> <property name="lastName"/> </properties> </class>
然后,我们可能有一些遗留的数据关联,引用 Person表的这个唯一键,而不是主键。
<many-to-one name="person" class="Person" property-ref="name"> <column name="firstName"/> <column name="initial"/> <column name="lastName"/> </many-to-one>
我们并不推荐这样使用,除非在映射遗留数据的情况下。