NHibernate学习笔记（二）：one-to-one关系映射

上一篇：NHibernate学习笔记（一）：初识NHibernate

本文的内容：
１．介绍NH如何处理对象间one-to-ont的映射关系；

经验教训：
１．操作一对一关联关系中的一个对象时，得在程序中指定如何与另一个对象关联，如在Student类中写this.NativePlace.Student = this；
２．在为类写映射文件时，必须指定类的具体的名称空间，若则运行时会出现＂找不到＊＊＊映射文件＂的问题；
　　这两点都困扰了我好长一段时间，应该要引起注意．

点击下载本文相关代码（可在上篇代码的基础上做修改）
one-to-one：
NH中处理一对一关联的方式有两种：
１．主键关联
２．惟一外键关联

本文使用主键关联处理一对一的关系。

　　主键关联不需要额外的表字段；两行是通过这种一对一关系相关联的，那么这两行就共享同样的主关键字值。所以如果你希望两个对象通过主键一对一关联，你必须确认它们被赋予同样的标识值！

　　持久化对象之间一对一的关联关系是通过one-to-one元素定义的。

<one-to-one
    name="propertyName"(1)
    class="ClassName"(2)
    cascade="all|none|save-update|delete"(3)
    constrained="true|false"(4)
    outer-join="true|false|auto"(5)
    property-ref="propertyNameFromAssociatedClass" (6)
    access="field|property|ClassName"(7)
/>

　　以下是对one-to-one元素各属性的说明：
　　１．name：属性的名字
　　２．class：(可选 - 默认是通过反射得到的属性类型): 被关联的类的名字
　　３．cascade：(可选) 表明操作是否从父对象级联到被关联的对象
　　４．constrained：(可选) 表明该类对应的表对应的数据库表，和被关联的对象所对应的数据库表之间，通过一个外键引用对主键进行约束。这个选项影响Save()和Delete()在级联执行时的先后顺序（也在schema export tool中被使用）
　　５．outer-join：(可选 - 默认为 auto):当设置hibernate.use_outer_join的时候，对这个关联允许外连接抓取
　　６．property-ref：(可选): 指定关联类的一个属性，这个属性将会和本外键相对应。如果没有指定，会使用对方关联类的主键
　　７．access：(可选 - defaults to property): NHibernate 用来访问属性的策略

本文所涉及的类说明：
其中BizObject、User、ObjectBroker、Sessions等四个类就是NHibernate学习笔记（一）：初识NHibernate这篇文章定义的。
Student类和NativePlace类是一对一的双向关联关系：类Student通过属性NativePlace关联类NativePlace;类NativePlace通过属性Student关联类Student。

类Student的代码如下：

using System;
using System.Collections.Generic;
using System.Text;

namespace NHibernateTest
{
    public class Student : User
    {
        fields#region fields
        private NativePlace objNativePlace;
        #endregion

        constructors#region constructors
        public Student()
        {
            objNativePlace = new NativePlace();
        }

        public Student(int StudentID) : base(StudentID) { }
        #endregion

        properties#region properties
        public NativePlace NativePlace
        {
            get
            {
                return objNativePlace;
            }
            set
            {
                objNativePlace = value;
            }
        }
        #endregion

        methors#region methors
        public bool addNewStudent()
        {
            try
            {
                this.NativePlace.Student = this;
                this.Create();
                return true;
            }
            catch (Exception e)
            {
                return false;
            }
        }

        public bool deleteStudent()
        {
            try
            {
                this.NativePlace.Student = this;
                this.Delete();
                return true;
            }
            catch (Exception e)
            {
                return false;
            }
        }

        public bool updateStudent()
        {
            try
            {
                this.NativePlace.Student = this;
                this.Update();
                return true;
            }
            catch (Exception e)
            {
                return false;
            }
        }
        #endregion
    }
}

　　在每次操作Student对象时，都得指定NativePlace.Student，如：this.NativePlace.Student = this;如果没写这一行运行时会出现“could not find class:NativePlace”（我就在写卡了好久）

类NativePlace的代码如下：

using System;
using System.Collections.Generic;
using System.Text;

namespace NHibernateTest
{
    public class NativePlace : BizObject
    {
        fields#region fields
        private int intNPID;
        private string strCity;
        private string strProvince;
        private Student objStudent;
        #endregion

        properties#region properties
        public int NPID
        {
            get
            {
                return intNPID;
            }
            set
            {
                intNPID = value;
            }
        }

        public Student Student
        {
            get
            {
                return objStudent;
            }
            set
            {
                objStudent = value;
            }
        }

        public string Province
        {
            get
            {
                return strProvince;
            }
            set
            {
                strProvince = value;
            }
        }

        public string City
        {
            get
            {
                return strCity;
            }
            set
            {
                strCity = value;
            }
        }
        #endregion
    }
}

　　这两个类的定义相对于User类没有什么太大的区别，接下来介绍两个类的配置文件。

　　从ＵＭＬ来看，类NativePlace与类User之间是集合（构成）关系，即类NativePlace属于类Student的一部分，但不能独立存在，也就是说类NativePlace是依赖于类User的。

数据库脚本：

--表Users：用于保存Student对象
Create Table [Users]
(
  [ID] int identity(1,1) constraint PK_UserID1 Primary Key,
  [UserName] varchar(20) not null,
  [Password] varchar(20) not null
)

--表NativePlace：用于保存NativePlace对象
Create Table NativePlace
(
  --表NativePlace与表Users通过主键关联，则需保证两表的主键名一致
  ID int Constraint PK_NativePlaceID Primary Key,    
  Province varchar(50),
  City varchar(50)
)

类Student的映射文件：

<?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" />
  </class>
</hibernate-mapping>

类NativePlace的映射文件：

<?xml version="1.0" encoding="utf-8" ?>
<hibernate-mapping xmlns="urn:nhibernate-mapping-2.0">
  <class name="NHibernateTest.NativePlace,NHibernateTest" table="NativePlace">
    <id name="NPID" column="ID" type="Int32" unsaved-value="0">
      <generator class="foreign">
        <param name="property">Student</param>
      </generator>
    </id>
    <property name="Province" column="Province" type="String" length="50"/>
    <property name="City" column="City" type="String" length="50"/>
    
    <one-to-one name="Student" class="NHibernateTest.Student,NHibernateTest" cascade="all" constrained="true"></one-to-one>
  </class>
</hibernate-mapping>

注意：如果采用<hibernate-mapping xmlns="urn:nhibernate-mapping-2.0">这种声明的话，请在之后指写相关联类的名字时请指出完整的类名（名称空间+类名）和程序集名：如<class name="NHibernateTest.NativePlace,NHibernateTest" table="NativePlace">和<one-to-one name="Student" class="NHibernateTest.Student,NHibernateTest" cascade="all" constrained="true"></one-to-one>

接下来是测试类：

using System;
using System.Collections.Generic;
using System.ComponentModel;
using System.Data;
using System.Drawing;
using System.Text;
using System.Windows.Forms;

namespace NHibernateTest
{
    public partial class frmStudent : Form
    {
        public frmStudent()
        {
            InitializeComponent();
        }

        Student objStudent;

        //Add New Student
        private void button1_Click(object sender, EventArgs e)
        {
            objStudent = new Student();

            objStudent.UserName = "jailu";
            objStudent.Password = "123";
            objStudent.NativePlace.Province = "FuJian";
            objStudent.NativePlace.City = "LongYan";

            if (objStudent.addNewStudent())
            {
                MessageBox.Show("Success");
            }
            else
            {
                MessageBox.Show("UnSuccess");
            }
        }

        //Update
        private void btnUpdate_Click(object sender, EventArgs e)
        {
            objStudent.UserName = "Update UserName";
            objStudent.NativePlace.Province = "Update Province";

            if (objStudent.updateStudent())
            {
                MessageBox.Show("Success");
            }
            else
            {
                MessageBox.Show("UnSuccess");
            }
        }

        //Delete
        private void btnDelete_Click(object sender, EventArgs e)
        {
            if (objStudent.deleteStudent())
            {
                MessageBox.Show("Success");
            }
            else
            {
                MessageBox.Show("UnSuccess");
            }
        }
    }
}

　　所有的类和映射文件都写好了，运行．．．成功．