zoukankan      html  css  js  c++  java
  • NHibernate快速指南(二)

    第三步:写映射文件

    现在我们有数据表和需要去映射它的.Net类。我们需要一种方式去让NHibernate知道如何从一个映射到另一个。这个任务依赖于映射文件来完成。最易于管理的办法是为每一个类写一个映射文件,如果你命名它是YourObject.hbm.xml 并且把它放在和类的同一个目录里,NHiberante将会使得事情简单起来。下面是一个User.hbm.xml的例子:

                     
    <?xml version="1.0" encoding="utf-8" ?>
    <hibernate-mapping xmlns="urn:nhibernate-mapping-2.0">
              <class name="NHibernate.Examples.QuickStart.User, NHibernate.Examples" table="users">
                     <id name="Id" column="LogonId" type="String" length="20"> 
                             <generator class="assigned" /> 
                     </id> 
                     <property name="UserName" column= "Name" type="String" length="40"/> 
                     <property name="Password" type="String" length="20"/> 
                     <property name="EmailAddress" type="String" length="40"/>
                     <property name="LastLogon" type="DateTime"/>
              </class>
     
    </hibernate-mapping>
                     

    让我们来看看这个文件中让我们感兴趣的某些行。第一个有趣的标签是class。这里我们将映射类型名称(类名和装配件)到我们数据库中的User表,这里和Hibernate有一点点的不同。你将不得不告诉NHibernate从何处提取对象。在这个例子里我们从装配件NHibernate.Examples装载类NHibernate.Examples.QuickStart.User NHibernate 遵循和.Net Framework同样的规则来加载类型。因此如果你在如何指定类型的方面有些混淆,请参看.Net Framework SDK

    让我们先跳过id标签,来讨论property标签。简要看一下,你将发现NHibernate所要做的工作。name属性的值正是我们.Net 类的属性,column属性值将是我们数据库里的字段。type属性是可选的(如果你不标明,NHibernate将利用反射进行最佳的推测)。

    好了,让我们回到标签id, 你可以猜测到这个标签将是映射数据库表的主键,的确如此,id标签的组成和我们刚才看的property标签是相似的。我们映射属性到目标数据库的字段。

    内嵌的generator 标签告诉NHibernate 如何生成主键(它将恰当的为你生成主键,不管你指定何种类型,但你必须告诉它)。在我们的例子里,我们设定为assigned,意味着我们对象将自己生成主键(毕竟User对象常常需要一个UserID)。如果你执意要NHiberante为你生成主键,你感兴趣于设定uuid.hexuuid.string(从文档中获取更多信息)

    提示:如果你使用Visual Studio.Net 去编译的话,请将user.hbm.xmlBuild Action属性设置为Embedded Resource。映射文件将成为装配件的一部分。更详细的细节重点将在后面展示。

    提示:如果你仅仅是改变映射文件,你不能使用build 而应该Rebuild项目。Visual Studio.Net 不会重新编译有改变的映射文件。

    第四步:为你的数据库产生一个配置文件

    我们至今还没有告诉NHibernate 去哪里连接数据库。最直接的办法是在你的应用程序的配置文件里设置一个NHibernate配置节。这和在Hibernate里使用属性文件是等价的。如下配置:

                     
    <?xml version="1.0" encoding="utf-8" ?>
    <configuration>
                <configSections>
                       <section name="nhibernate" type="System.Configuration.NameValueSectionHandler, System, Version=1.0.3300.0,Culture=neutral, PublicKeyToken=b77a5c561934e089" />
              </configSections>
              
              <nhibernate>
                     <add 
                             key="hibernate.connection.provider"            
                             value="NHibernate.Connection.DriverConnectionProvider" 
                     />
                     <add 
                             key="hibernate.dialect"                        
                             value="NHibernate.Dialect.MsSql2000Dialect" 
                     />
                     <add 
                             key="hibernate.connection.driver_class"            
                             value="NHibernate.Driver.SqlClientDriver" 
                     />
                     <add 
                             key="hibernate.connection.connection_string" 
                             value="Server=localhost;initial catalog=nhibernate;Integrated Security=SSPI" 
                     />
              </nhibernate>
    </configuration>
                     

    上面的例子里用了SqlClient 驱动,在本地连接名称为NHibernate 的数据库,提供用户名和密码。那里有一堆属性你需要调整来确定如何让NHibernate来访问数据库。再次说明,你可以在文档里获取更多信息。

    请注意以上的配置里并没有涉及到log4net的配置信息。NHibernate使用log4net来记录内部发生的一切。在一个应用程序产品里,在你特定环境里,我推荐配置log4net,并为NHibernate设置一定的日志级别。

    第五步:开始展现NHibernate的魔力

    所有艰苦的工作已经完成。你将有以下内容

    User.cs ----你需要持久化的C#

    User.hbm.xml ----你的NHibernate映射文件

    App.config ---ADO.NET连接的配置信息(如果你愿意,你可以在代码中实现)。

    你的数据库里有一张User表。

    现在可以在你的代码中恰当简洁的使用NHibernate。简化的版本如下

    1. 创建一个Configuration对象
    2. Configuration知道你将存储何种类型的对象
    3. 为你选择的数据库创建一个Session对象
    4. LoadSaveQuery你的对象
    5. 通过SessionFlush()方法将对象提交给数据库。

    为了让你更清晰,我们来看一些代码。

    首先,创建一个Configuration对象

    Configuration对象能够解析所有.Net对象和后台数据库中的映射关系。

                     
              Configuration cfg = new Configuration();
              cfg.AddAssembly("NHibernate.Examples");
                     

    Configuration对象会搜索装配件里的任何以hbm.xml 结尾的文件。还有其他方法加载映射文件,但这种方式是最简单的。

    下一步,创建一个Session对象

    ISession对象提供一个到后台数据库的连接,ITransaction对象提供一个可以被NHibernate管理的事务。

                     
              ISessionFactory factory = cfg.BuildSessionFactory();
              ISession session = factory.OpenSession();
              ITransaction transaction = session.BeginTransaction();
                     

    接着来Load, SaveQuery你的对象

    现在你可以用使用传统的.Net方法来操纵对象。你想保存一个新对象到数据库吗?尝试下面的方法:

                     
              User newUser = new User();
              newUser.Id = "joe_cool";
              newUser.UserName = "Joseph Cool";
              newUser.Password = "abc123";
              newUser.EmailAddress = "joe@cool.com";
              newUser.LastLogon = DateTime.Now;
                             
              // Tell NHibernate that this object should be saved
              session.Save(newUser);
     
              // commit all of the changes to the DB and close the ISession
              transaction.Commit();
              session.Close();

    正如你所看到的,关于NHiberante重要的事情是如此简单。继续并且查询你的数据库,验证一下User表里的新记录。现在重要的事情就是你去操心业务对象并在进行处理的时候告诉NHibernate就可以了。

    让我们来告诉你,当你有一个UserID的时候如何获取对象(举例说,登陆你的网站的时候)。仅仅一句话就可以打开Session,传入key就可以了

                     
              // open another session to retrieve the just inserted user
              session = factory.OpenSession();
     
              User joeCool = (User)session.Load(typeof(User), "joe_cool");
                     

    你所获取的User对象还在生存周期内!改变它的属性,并通过Flush()持久化到数据库。

                     
              // set Joe Cool's Last Login property
              joeCool.LastLogon = DateTime.Now;
     
              // flush the changes from the Session to the Database
              session.Flush();
                     

    你所要做的就是通过NHibernate来进行你需要的改变,并调用SessionFlush()方法提交。验证一下数据库,查查用户ID”joe_cool”的记录中”LastLogon”的更改。

    还有更好的,你可以以System.Collections.IList的方式来获取从表中的对象。如下

                     
              IList userList = session.CreateCriteria(typeof(User)).List();
              foreach(User user in userList)
              {
                     System.Diagnostics.Debug.WriteLine(user.Id + " last logged in at " + user.LastLogon);
              }
     
    这个查询将会返回所有表记录。往往你需要做更多的控制,比如说获取从March 14, 2004 10:00 PM 以后登陆的用户,如下:
                     
              IList recentUsers = session.CreateCriteria(typeof(User))
                                            .Add(Expression.Expression.Gt("LastLogon", new DateTime(2004, 03, 14, 20, 0, 0)))
                                            .List();
     
              foreach(User user in recentUsers)
              {
                     System.Diagnostics.Debug.WriteLine(user.Id + " last logged in at " + user.LastLogon);
              }
                     
     
    文档里还有一堆健壮的查询方式让你调用,这里仅仅让你对NHibernate所提供的强有力的工具有一定的了解。
              
    最后调用Session对象的Close()方法,释放NHibernate所使用的ADO.Net连接资源
     
                     
              // tell NHibernate to close this Session
              session.Close();
                     
     

    更确切地说

    你已经完成创建对象,持久化并通过条件查询或键值查询来返回它。相信你已经从中获得快乐。

    现在你对NHibernate有了大致的了解,如果你能仔细阅读大量来自Hibernate 2.0.3文档,你将获得帮助(NHibernate文档还在早期阶段,现在还仅仅是对Hibernate的拷贝)。

  • 相关阅读:
    图解HTTPS
    JQuery 控件
    sql server 中某个字段值合并【转】
    ASP.NET时间函数及其格式转换
    数据库 'tempdb' 的日志已满
    @@ERROR 和 @@ROWCOUNT
    SQL Server中行列转换 Pivot UnPivot 【转】
    Global.asax详解
    SQL Server 2008时提示评估期已过的解决办法
    C# IO读取文件问题:正由另一进程使用
  • 原文地址:https://www.cnblogs.com/aaa6818162/p/1538333.html
Copyright © 2011-2022 走看看