NHibernate的灵活配置

using System.Reflection;
using NHibernate.Cfg;
using NUnit.Framework;

namespace DDLLY.MyDoc.NHibernateTest.ConfigurationTest.Test
{
    /**//// <summary>
    /// 测试ConfigurationTest.Configure()方法的测试类
    /// </summary>
    [TestFixture]
    public class ConfigureFixture
    {
        测试方法#region 测试方法

        /**//// <summary>
        /// 测试ConfigurationTest.Configure()方法 
        /// 加载和应用程序同目录的hibernate.cfg.xml
        /// 将加载"bin/Debug或Release下的hibernate.cfg.xml"
        /// </summary>
        [Test]
        public void TestConfigure1()
        {
            Configuration cfg = new Configuration().Configure();
            Assert.AreEqual("true 1, false 0, yes 'Y', no 'N'", cfg.Properties[Environment.QuerySubstitutions]);
            Assert.AreEqual("server=.;database=user;uid=sa;pwd=App1234;", cfg.Properties[Environment.ConnectionString]);
        }

        /**//// <summary>
        /// 测试Configure(Assembly,string)方法，加载嵌入在程序集中的hibernate.cfg.xml
        /// </summary>
        [Test]
        public void TestConfigure2()
        {
            Configuration cfg = new Configuration().Configure(
                Assembly.GetExecutingAssembly(), //当前代码正从中运行的程序集。
                TestHelper.NAMEPLACENAME + ".hibernate.cfg.xml");
            Assert.AreEqual("true 1, false 0, yes 'Y', no 'N'", cfg.Properties[Environment.QuerySubstitutions]);
            Assert.AreEqual("server=.;database=user;uid=sa;pwd=App1234;", cfg.Properties[Environment.ConnectionString]);
        }

        /**//// <summary>
        /// 测试Configure(string)方法，加载指定路径的文件
        /// </summary>
        [Test]
        public void TestConfigure3()
        {
            Configuration cfg = new Configuration().Configure("hibernate.cfg.xml");
            Assert.AreEqual("true 1, false 0, yes 'Y', no 'N'", cfg.Properties[Environment.QuerySubstitutions]);
            Assert.AreEqual("server=.;database=user;uid=sa;pwd=App1234;", cfg.Properties[Environment.ConnectionString]);
        }

        #endregion
    }
}

 让我们来看看配置文件，配置文件中主要配置的是各种属性和映射类的信息（还有缓存配置方面的信息，将在后面的章节讲到）。

在NHibernate.Cfg.Environment类中可以看到的可用属性信息。
例如Environment中public const string ConnectionString = "hibernate.connection.connection_string";

关于属性的说明可以查看NHibernate的文档。

映射文件的配置有以下几种方法

a.使用程序集中的所有资源文件

<!--程序将加载DDLLY.MyDoc.NHibernateTest.Configuration命名空间所有的映射文件(*.hbm.xml)-->
<mapping assembly="DDLLY.MyDoc.NHibernateTest.ConfigurationTest" />

b.使用指定文件

<!-- 映射文件 -->
<!--程序将加载指定的文件-->
<!--这种写法将加载和可执行程序的路径中的User.hbm.xml文件-->
<!--在Visual Studio把生成的可执行文件放在bin\Debug和bin\Release中-->
<!--所以此文件也要放在这两个目录中-->
<mapping file="User.hbm.xml" />

c.使用程序集中的指定资源文件

<!-- 映射文件 -->
<!--程序将加载指定的文件-->
<!--这种写法将加载加载资源文件-->
<mapping resource="DDLLY.MyDoc.NHibernateTest.ConfigurationTest.User.hbm.xml" assembly="DDLLY.MyDoc.NHibernateTest.ConfigurationTest" />

 

我们也可以使用代码来配置这些内容。

AddAssembly

添加程序集中所有以"hbm.xml"为结尾的文件作为映射文件。

示例：cfg.AddAssembly(Assembly.GetExecutingAssembly());

AddClass

使用协定从应用程序资源读取一个映射。类 Foo.Bar.Foo被映射为名为Foo.Bar.Foo.hbm.xml的嵌入在类所在的程序集中的资源文件。

示例：cfg.AddClass(typeof (User));

AddFile

从一个特别的XML文件读取映射。这个方法和AddXmlFile作用一样。

示例：cfg.AddFile("User.hbm.xml");

AddProperties

添加一个IDictionary类型的属性集合。Key是属性名，Value是属性的值。

示例：

//添加连接字符串属性
Hashtable properties = new Hashtable();
properties.Add(Environment.ConnectionString, //NHibernate.Cfg.Environment类中有所有的可属性信息
"server=.;database=user;uid=sa;pwd=App1234;");
cfg.AddProperties(properties);

我比较喜欢使用配置文件里面配置程序集的做法，因为这种做法最简单直接。

我们也可以把两种方式结合起来使用，例如我们可以在配置文件中配置好除连接字符串外的其它信息，然后在代码中添加连接字符串。

不管是映射信息还是属性信息最终都回被设置到Configuration里，我们可以查看Configuration的ClassMappings和Properties来查看这些信息。

同样我也写了两个类，前一个用来测试配置映射类。后一个用来测试配置属性。

测试配置映射

using System.Reflection;
using NHibernate.Cfg;
using NUnit.Framework;

namespace DDLLY.MyDoc.NHibernateTest.ConfigurationTest.Test
{
    /**//// <summary>
    /// 测试加载映射文件的类
    /// </summary>
    [TestFixture]
    public class ConfigMappingFixture
    {
        SetUp和TearDown#region SetUp和TearDown

        [SetUp]
        public void SetUp()
        {
            //添加名为LLY，密码为123456的用户，因为这是数据库的第一条记录，所以数据库标识为1
            string SetUpSql = "INSERT INTO users([UserName],[Password]) VALUES('LLY','123456')";
            TestHelper.SqlExecuteNonQuery(SetUpSql);
        }

        [TearDown]
        public void TearDown()
        {
            //清空users表，并把标识(identity)清零
            string TearDownSql = "TRUNCATE TABLE users";
            TestHelper.SqlExecuteNonQuery(TearDownSql);
        }

        #endregion

        使用配置文件配置映射的测试#region 使用配置文件配置映射的测试

        /**//// <summary>
        /// 测试使用配置文件中配置的程序集加载映射文件
        /// 
        /// <!-- 映射文件 -->
        ///<!-- 程序将加载DDLLY.MyDoc.NHibernateTest.Configuration命名空间所有的映射文件(*.hbm.xml)-->
        ///<mapping assembly="DDLLY.MyDoc.NHibernateTest.ConfigurationTest" />
        /// 
        /// </summary>
        [Test]
        public void TestConfigMappingUseFile1()
        {
            //配置Configuration
            Configuration cfg = new Configuration().Configure(
                Assembly.GetExecutingAssembly(), //当前代码正从中运行的程序集。
                TestHelper.NAMEPLACENAME + ".hibernate.cfg.xml");

            //测试
            TestHelper.CheckConfiguration(cfg);
        }

        /**//// <summary>
        /// 测试以文件形式加载映射文件,使用配置文件中的配置
        /// 
        ///<!-- 映射文件 -->
        ///<!--程序将加载指定的文件-->
        ///<!--这种写法将加载和可执行程序的路径中的User.hbm.xml文件-->
        ///<!--在Visual Studio把生成的可执行文件放在bin\Debug和bin\Release中-->
        ///<!--所以此文件也要放在这两个目录中-->
        ///<mapping file="User.hbm.xml" />
        /// 
        /// </summary>
        [Test]
        public void TestConfigMappingUseFile2()
        {
            //配置Configuration
            Configuration cfg = new Configuration().Configure(
                Assembly.GetExecutingAssembly(), //当前代码正从中运行的程序集。
                TestHelper.NAMEPLACENAME + ".hibernate1.cfg.xml");

            //测试
            TestHelper.CheckConfiguration(cfg);
        }

        /**//// <summary>
        /// 测试加载资源文件作为映射文件,使用配置文件中的配置
        /// 
        ///<!-- 映射文件 -->
        ///<!--程序将加载指定的文件-->
        ///<!--这种写法将加载加载资源文件-->
        ///<mapping resource="DDLLY.MyDoc.NHibernateTest.ConfigurationTest.User.hbm.xml" assembly="DDLLY.MyDoc.NHibernateTest.ConfigurationTest" />
        /// 
        /// </summary>
        [Test]
        public void TestConfigMappingUseFile3()
        {
            //配置Configuration
            Configuration cfg = new Configuration().Configure(
                Assembly.GetExecutingAssembly(), //当前代码正从中运行的程序集。
                TestHelper.NAMEPLACENAME + ".hibernate2.cfg.xml");

            //测试
            TestHelper.CheckConfiguration(cfg);
        }

        #endregion

        使用程序代码配置映射的测试#region 使用程序代码配置映射的测试

        /**//// <summary>
        /// 测试在代码中加载映射文件,使用程序集
        /// hibernate3.cfg.xml中未设置映射类信息使用代码添加
        /// </summary>
        [Test]
        public void TestConfigMappingUseCode1()
        {
            //配置Configuration
            Configuration cfg = new Configuration().Configure(
                Assembly.GetExecutingAssembly(), //当前代码正从中运行的程序集。
                TestHelper.NAMEPLACENAME + ".hibernate3.cfg.xml");

            //加载程序集中所有映射文件
            cfg.AddAssembly(Assembly.GetExecutingAssembly());

            //测试
            TestHelper.CheckConfiguration(cfg);
        }

        /**//// <summary>
        /// 测试在代码中加载映射文件，使用类
        /// hibernate3.cfg.xml中未设置映射类信息使用代码添加
        /// </summary>
        [Test]
        public void TestConfigMappingUseCode2()
        {
            //配置Configuration
            Configuration cfg = new Configuration().Configure(
                Assembly.GetExecutingAssembly(), //当前代码正从中运行的程序集。
                TestHelper.NAMEPLACENAME + ".hibernate3.cfg.xml");

            //加载和类对应的映射文件
            cfg.AddClass(typeof (User));

            //测试
            TestHelper.CheckConfiguration(cfg);
        }

        /**//// <summary>
        /// 测试在代码中加载映射文件，使用文件
        /// hibernate3.cfg.xml中未设置映射类信息使用代码添加
        /// </summary>
        [Test]
        public void TestConfigMappingUseCode3()
        {
            //配置Configuration
            Configuration cfg = new Configuration().Configure(
                Assembly.GetExecutingAssembly(), //当前代码正从中运行的程序集。
                TestHelper.NAMEPLACENAME + ".hibernate3.cfg.xml");

            //加载和类对应的映射文件
            cfg.AddFile("User.hbm.xml");

            //测试
            TestHelper.CheckConfiguration(cfg);
        }

        #endregion
    }
}

测试配置属性

using System.Collections;
using System.Reflection;
using NHibernate.Cfg;
using NUnit.Framework;

namespace DDLLY.MyDoc.NHibernateTest.ConfigurationTest.Test
{
    /**//// <summary>
    /// 测试配置属性的类
    /// </summary>
    [TestFixture]
    public class ConfigPropertyFixture
    {
        SetUp和TearDown#region SetUp和TearDown

        [SetUp]
        public void SetUp()
        {
            //添加名为LLY，密码为123456的用户，因为这是数据库的第一条记录，所以数据库标识为1
            string SetUpSql = "INSERT INTO users([UserName],[Password]) VALUES('LLY','123456')";
            TestHelper.SqlExecuteNonQuery(SetUpSql);
        }

        [TearDown]
        public void TearDown()
        {
            //清空users表，并把标识(identity)清零
            string TearDownSql = "TRUNCATE TABLE users";
            TestHelper.SqlExecuteNonQuery(TearDownSql);
        }

        #endregion

        测试方法#region 测试方法

        /**//// <summary>
        /// 测试在代码中配置属性
        /// </summary>
        [Test]
        public void TestConfigProperty()
        {
            //配置Configuration
            Configuration cfg = new Configuration().Configure(
                Assembly.GetExecutingAssembly(), //当前代码正从中运行的程序集。
                TestHelper.NAMEPLACENAME + ".hibernate4.cfg.xml");

            //hibernate4.cfg.xml未配置连接字符串属性，使用代码添加连接字符串属性
            Hashtable properties = new Hashtable();
            properties.Add(Environment.ConnectionString, //NHibernate.Cfg.Environment类中有所有的可属性信息
                           "server=.;database=user;uid=sa;pwd=App1234;");
            cfg.AddProperties(properties);

            //测试
            TestHelper.CheckConfiguration(cfg);
        }

        #endregion
    }
}

Trackback: http://tb.blog.csdn.net/TrackBack.aspx?PostId=1801514