NHibernate和Cuyahoga(一)

在我的所有试图去解释Cuyahoga是怎么样利用NHibernate去持久化对象的文章中,这是第一篇. 在这一系列的文章中提到的NHibernate的版本是0.7, 还有Cuyahoga是0.7.0.1 .

Configuration:
       那么让我们开始NHibernate的配置吧. 对象和数据库之间的映射存在在运行时. 在Cuyahoga中, 配置的过程被封装在Cuyahoga.Core.Service.SessionFactory类中. 这个类主要封装了NHibernate的Configuration和SessionFactory类的功能. 她使用了单件模式(Singleton),因为创建Configuration的代价是非常昂贵的, 并且整个应用程序线程可以安全的使用这个相同的实例. 在创建时,Cuyahoga的核心类的在NHibernate中被注册,而且一个ISessonFactory实例被创建:

Configuration config  =   new  Configuration();
this ._nhibernateConfiguration  =  config.AddAssembly( this .GetType().Assembly);
this ._nhibernateFactory  =   this ._nhibernateConfiguration.BuildSessionFactory();

      既然核心类和SessionFactory处在相同的程序集中,我们可以通过简单的添加程序集的方法(this.GetType().Assembly)一次性将核心类注册到NHibernate中. 
 
          提示:Cuyahoga SessionFactory拥有一个NHibernate Configuration的引用.文档说:这个Configuration是被丢弃的,但是我们在独立的Cuyahoga的Modules中需要用它添加独立Modules的映射(对象关系).

public   void  RegisterPersistentClass(Type type)
{
         if (this._nhibernateConfiguration.GetClassMapping(type) == null)
         {
                   // Class isn't mapped yet, so do it now.
                   this._nhibernateConfiguration.AddClass(type);                  
                   this._classesAdded = true;
         }
}

        提示:NHibernate SessionFactory不会被立即重新创建. Modules在Configuration中可以添加多个映射类, 然而在添加完之后,Modules有责任调用Rebuild()方法重新创建NHibernate的ISessionFactory.

 Session管理方式:
       在Configuration后,在真正需要的地方我们就拥有了一切(NHibernate). 使用GetSession方法,可以获得一个打开的可以用于持久化对象的NHibernate session实例.

       Cuyahoga不会使用”真正”的NHibernate session来持久化核心对象, 但是她拥有一个外观类Cuyahoga.Core.CoreRepository,它隐藏了几乎所有的NHibernate对Cuyahoga特定的操作. 它包含了常用方法:检索, 保存, 更新 ,删除一个指定的类型的对象和一些细节的操作(例如:过滤和排序). 说到低,CoreRepository使用了 从SessionFactory中获得的NHibernate session.

       Session的管理使用了模式, 我们叫她”Session Per Request”. 在Asp.NET的整个页面生命周期中, 在页面的每一个请求开始的时候, 单个NHibernate session的实例被创建. 通常我们将他存储在HttpContext.Current.Items 集合中. Cuyahoga稍微有点不一样, 她是存放CoreRepository类的一个实例, 但是他们在概念上或多或少是差不多的.

       我们有一个专门的HttpModule(Cuyahoga.Web.Util.NHSessionModule.), 来处理在请求时存储CoreRepository. 在开始请求事件的时候,我们创建CoreRepository实例, 并且在结束请求的时候关闭session.

private   void  Context_BeginRequest( object  sender, EventArgs e)
{
         // Create the repository for Core objects and add it to the current HttpContext.
         CoreRepository cr = new CoreRepository(true);
         HttpContext.Current.Items.Add("CoreRepository", cr);
}
private   void  Context_EndRequest( object  sender, EventArgs e)
{
         // Close the NHibernate session.
         if (HttpContext.Current.Items["CoreRepository"] != null)
         {
                   CoreRepository cr = (CoreRepository)HttpContext.Current.Items["CoreRepository"];
                   cr.CloseSession();
         }
}

       你也可以将这些内容放在Global.asax中, 这只和个人爱好有关. 我喜欢使用HttpModules.现在, 在Cuyahoga中的Asp.NET页面和用户控件可以在页面的生命周期的任何时候访问CoreRepository了.

       CoreRepository没有为Modules提供多的功能, 所以他们必须自己管理持久化. 这样的例子,可以在Cuyahoga.Modules.Articles.ArticleModule或者Cuyahoga.Modules.StaticHtml.StaticHtmlModule的父类Cuyahoga.Core.Domain.ModuleBase中找到.

       Modules使用和编译页面的Cuyahoga.Web.UI.PageEngine类相同的session是非常重要的. 他们可以从Context.Items集合中的CoreRepository中获得session. 然而目前,当Modules在需要一个session的时候,产生一个事件, PageEngine会处理这个事件.这是早期Cuyahoga还没有使用Context.Items来存储session的一个小的遗留. 将会重构.

原文:http://www.cuyahoga-project.org/home/developers.aspx