BlogJava-thinking-随笔分类-Hibernate

unsaved-value

lau — Fri, 10 Jul 2009 09:38:00 GMT

当你显式的使用session.save()或者session.update()操作一个对象的时候，实际上是用不到unsaved-value的。某些情况下(父子表关联保存)，当你在程序中并没有显式的使用save或者update一个持久对象，那么Hibernate需要判断被操作的对象究竟是一个已经持久化过的持久对象，是一个尚未被持久化过的内存临时对象。例如：

Java代码

Session session = ...;
Transaction tx = ...;
Parent parent = (Parent); session.load(Parent.class, id);;
Child child = new Child();;
child.setParent(parent);;
child.setName("sun");;
parent.addChild(child);;
s.update(parent);;
s.flush();;
tx.commit();;
s.close();;

Session session = ...;
Transaction tx = ...;
Parent parent = (Parent); session.load(Parent.class, id);;
Child child = new Child();;
child.setParent(parent);;
child.setName("sun");;
parent.addChild(child);;
s.update(parent);;
s.flush();;
tx.commit();;
s.close();;

在上例中，程序并没有显式的session.save(child); 那么Hibernate需要知道child究竟是一个临时对象，还是已经在数据库中有的持久对象。如果child是一个新创建的临时对象(本例中就是这种情况)，那么Hibernate应该自动产生session.save(child)这样的操作，如果child是已经在数据库中有的持久对象，那么 Hibernate应该自动产生session.update(child)这样的操作。

因此我们需要暗示一下Hibernate，究竟child对象应该对它自动save还是update。在上例中，显然我们应该暗示 Hibernate对child自动save，而不是自动update。那么Hibernate如何判断究竟对child是save还是update呢？它会取一下child的主键属性 child.getId() ，这里假设id是 java.lang.Integer类型的。如果取到的Id值和hbm映射文件中指定的unsave-value相等，那么Hibernate认为 child是新的内存临时对象，发送save，如果不相等，那么Hibernate认为child是已经持久过的对象，发送update。

unsaved-value="null" (默认情况，适用于大多数对象类型主键 Integer/Long/String/...)

当Hibernate取一下child的Id，取出来的是null(在上例中肯定取出来的是null)，和unsaved-value设定值相等，发送save(child)

当Hibernate取一下child的id，取出来的不是null，那么和unsaved-value设定值不相等，发送update(child)

例如下面的情况：

Java代码

Session session = ...;
Transaction tx = ...;
Parent parent = (Parent); session.load(Parent.class, id);;
Child child = (Child); session.load(Child.class, childId);;
child.setParent(parent);;
child.setName("sun");;
parent.addChild(child);;
s.update(parent);;
s.flush();;
tx.commit();;
s.close();;

Session session = ...;
Transaction tx = ...;
Parent parent = (Parent); session.load(Parent.class, id);;
Child child = (Child); session.load(Child.class, childId);;
child.setParent(parent);;
child.setName("sun");;
parent.addChild(child);;
s.update(parent);;
s.flush();;
tx.commit();;
s.close();;

child已经在数据库中有了，是一个持久化的对象，不是新创建的，因此我们希望Hibernate发送update(child)，在该例中，Hibernate取一下child.getId()，和unsave-value指定的null比对一下，发现不相等，那么发送 update(child)。

BTW: parent对象不需要操心，因为程序显式的对parent有load操作和update的操作，不需要Hibernate自己来判断究竟是save还是update了。我们要注意的只是child对象的操作。另外unsaved-value是定义在Child类的主键属性中的。

Java代码

<class name="Child" table="child">
"id" name="id" type="integer" unsaved-value="null">
class="identity"/>
...
class>


unsaved-value="null">


...

如果主键属性不是对象型，而是基本类型，如int/long/double/...，那么你需要指定一个数值型的unsaved-value，例如：

Java代码

unsaved-null="0"

unsaved-null="0"

在此提醒大家，很多人以为对主键属性定义为int/long，比定义为Integer/Long运行效率来得高，认为基本类型不需要进行对象的封装和解构操作，因此喜欢把主键定义为int/long的。但实际上，Hibernate内部总是把主键转换为对象型进行操作的，就算你定义为int /long型的，Hibernate内部也要进行一次对象构造操作，返回给你的时候，还要进行解构操作，效率可能反而低也说不定。因此大家一定要扭转一个观点，在Hibernate中，主键属性定义为基本类型，并不能够比定义为对象型效率来的高，而且也多了很多麻烦，因此建议大家使用对象型的 Integer/Long定义主键。

unsaved-value="none"和
unsaved-value="any"

主主要用在主键属性不是通过Hibernate生成，而是程序自己setId()的时候。

在这里多说一句，强烈建议使用Hibernate的id generator，或者你可以自己扩展Hibernate的id generator，特别注意不要使用有实际含义的字段当做主键来用！例如用户类User，很多人喜欢用用户登陆名称做为主键，这是一个很不好的习惯，当用户类和其他实体类有关联关系的时候，万一你需要修改用户登陆名称，一改就需要改好几张表中的数据。偶合性太高，而如果你使用无业务意义的id generator，那么修改用户名称，就只修改user表就行了。

由这个问题引申出来，如果你严格按照这个原则来设计数据库，那么你基本上是用不到手工来setId()的，你用Hibernate的id generator就OK了。因此你也不需要了解当

unsaved-value="none"和
unsaved-value="any"

究竟有什么含义了。如果你非要用assigned不可，那么继续解释一下：

unsaved-value="none" 的时候，由于不论主键属性为任何值，都不可能为none，因此Hibernate总是对child对象发送update(child)

unsaved-value="any" 的时候，由于不论主键属性为任何值，都肯定为any，因此Hibernate总是对child对象发送save(child)

大多数情况下，你可以避免使用assigned，只有当你使用复合主键的时候不得不手工setId()，这时候需要你自己考虑究竟怎么设置unsaved-value了，根据你自己的需要来定。

BTW: Gavin King强烈不建议使用composite-id，强烈建议使用UserType。

因此，如果你在系统设计的时候，遵循如下原则：

1、使用Hibernate的id generator来生成无业务意义的主键，不使用有业务含义的字段做主键，不使用assigned。

2、使用对象类型(String/Integer/Long/...)来做主键，而不使用基础类型(int/long/...)做主键

3、不使用composite-id来处理复合主键的情况，而使用UserType来处理该种情况。

那么你永远用的是unsaved-value="null" ，不可能用到any/none/..了。

lau 2009-07-10 17:38 发表评论

many-to-one/one-to-many/many-to-many关系映射

lau — Thu, 11 Jun 2009 07:51:00 GMT

本文的内容：
介绍NH如何处理对象间many-to-one，one-to-many和many-to-many的双向映射关系（本文主要介绍了映射文件，对于类的生成可以跟据前两篇描述的方法生成）；

经验教训：

相关类图：（下面的类图包含一对一，多对一，一对多和多对多）
many-to-one：描述多对一的一种数据模型，它指定many一方是不能独立存在的，我个人认为many-to-one是NHB中保证数据有效性的最有用的一种映射，通过使用 many-to-one能有效的防治孤儿记录被写入到数据表中。在本文描述的例子中，Student类和Classes类之间是多对一关系．

通过many-to-one元素,可以定义一种常见的与另一个持久化类的关联。这种关系模型是多对一关联。（实际上是一个对象引用。）在映射文件中用many-to-one标签描述此种关系．

１．name：属性名。指出many一方的类用哪个属性和one一方的类关联．
２．column：字段名（可选）．指出many一方的类对应的数据表用哪个列和one一方的类对应的数据表关联（两表之间存在外键关联）；
３．class：关联的类的名字（可选 - 默认是通过反射得到属性类型）；
４．cascade：指明哪些操作会从父对象级联到关联的对象（可选）．cascade属性允许下列值：: all, save-update, delete, none. 设置除了none以外的其它值会传播特定的操作到关联的（子）对象中。
５．outer-join：当设置hibernate.use_outer_join的时候，对这个关联允许外连接抓取（可选 - 默认为 auto）．outer-join参数允许下列三个不同值： auto（使用外连接抓取关联（对象），如果被关联的对象没有代理(proxy) ），true（一直使用外连接来抓取关联），false（永远不使用外连接来抓取关联）；
６．update,insert：指定对应的字段是否在用于UPDATE 和/或 INSERT的SQL语句中包含。如果二者都是false,则这是一个纯粹的“外源性（derived）”关联，它的值是通过映射到同一个（或多个）字段的某些其他属性得到的，或者通过trigger(除法器），或者是其他程序（可选 - 默认为 true）
７．property- ref：指定关联类的一个属性，这个属性将会和本外键相对应。如果没有指定，会使用对方关联类的主键（可选）．property-ref属性只应该用来对付老旧的数据库系统，可能出现外键指向对方关联表的是个非主键字段（但是应该是一个惟一关键字）的情况。这是一种十分丑陋的关系模型。比如说，假设 Product类有一个惟一的序列号，它并不是主键；
８．access：NHibernate 用来访问属性的策略（可选 - 默认为property）
９．unique：允许产生外键列唯一约束的数据库定义语言（DDL）（可选）

那么关于Student的映射可能是：

<many-to-one name="Classes" column="cID" unique ="true"/>

只要在原Student.hbm.xml映射文件中添加many-to-one标签就可以了．

对于Sturent类得添加一个属性Classes:Classes

one-to-many：一对多也是一种常见的数据模型，在按范式设计的数据库中随处可见。在NHB中通过one-to-many可以非常方便的处理这种模型，同时NHB还提供了级联更新和删除的功能，以保证数据完整性。在本文描述的例子中，Classes类和Student类是一对多的关系．

Classes类的映射文件：Classes.hbm.xml

xml version="1.0" encoding="utf-8" ?>
<hibernate-mapping xmlns="urn:nhibernate-mapping-2.0">
  <class name="NHibernateTest.Classes,NHibernateTest" table="Classes">
    <id name="ClassesID" column="ID" type="Int32" unsaved-value="0">
      <generator class="identity"/>
    id>
    <property name="ClassesName" column="ClassName" type="String" length="50"/>

    <bag name="StudentList" cascade="all"  inverse="true">
      <key column="ID" />
      <one-to-many class="NHibernateTest.Student,NHibernateTest" />
    bag>
  class>
hibernate-mapping>

　　如映射文件所示，one-to-many标签必须包含在标签bag中（个人理解：多嘛，就用一个包装起来～）
bag标签的name属性指出Address对象用哪个属性和Student对象关联，inverse属性使collection不更新连接（总之，这个属性提高了性能，具体的情况请参考NHibernate的帮助文档）．
key标签的column属性指出了Address对象对应的数据表用哪个字段和Student对象对应的数据表关联
one-to-many标签的class属性指出了Address和哪个对象关联．

对于Classes类得创建一个StudentList : Student的属性，用来描述与Student对象的关系．

many-to-many：多对多在数据库中也是常见的数据模型，像用户与组，用户与权限等。多对多关系需要通过一个中间表实现，element的就是读取这个中间表中某列的值。在本文的例子中，Student类和Subject类是多对多的关系．

Student的映射可能是：

　　在bag标签中，加入了一个table属性，它指定一个实现多对多的中间表

完整的Student.hbm.xml源码如下：

xml version="1.0" encoding="utf-8" ?>
<hibernate-mapping xmlns="urn:nhibernate-mapping-2.0">
  <class name="NHibernateTest.Student,NHibernateTest" table="Users">
    <id name="UserID" column="ID" type="Int32" unsaved-value="0">
      <generator class="identity"/>
    id>
    <property name="UserName" column="UserName" type="String" length="20"/>
    <property name="Password" column="Password" type="String" length="20"/>


    <one-to-one name="NativePlace" class="NHibernateTest.NativePlace,NHibernateTest" cascade="all" />


    <many-to-one name="Classes" column="cID" unique ="true"/>


    <bag name="AddressList" cascade="all"  inverse="true">
      <key column="ID" />
      <one-to-many class="NHibernateTest.Address,NHibernateTest" />
    bag>


    <bag name="SubjectList" table="r_Student_Subject" inverse="true" cascade="save-update" lazy="false">
      <key column="StudentID" />
      <many-to-many class="NHibernateTest.Subject,NHibernateTest" column="ID" outer-join="auto" />
    bag>
  class>
hibernate-mapping>

Student类得添加类型为IList的属性SubjectList表示与类Subject的关系．

由于Student的映射关系比较复杂，本文就再熬述它的CRUD操作，具体的操作方法请参考本文附带的代码．

lau 2009-06-11 15:51 发表评论