Nhibernate入门 - dinghao - 博客园

Nhibernate入门 对大部分Nhibernte操作，都写了一个Demo，映射文件全部手写（手疼），看完后会对Nhibernte有个全面的了解。不想看文字的，可以看看附件中的代码。什么是NhibernateNhibernate会把数据库中的表用对象图的形式表现出来，对开发人员来说，他们面对的不是底层的ADO，DateSet等结构，而是包含业务逻辑的对象。Nhibernate足够聪明，它能做到自动、透明的持久化对象图，这节省了大量的开发时间，也弥补了对象设计和数据库设计间的不对称性。Nhibernte主要用来解决复杂的业务逻辑，而不适合简单逻辑或以数据为中心的系统。Nhibernte中的几个重要对象下面介绍Nhibernate中常用的几个对象，首先是ConfigurationConfigurationConfiguration负责管理Nhibernate的配置信息以及类与数据库之间的映射文件（*.hbm.xm），负责创建ISessionFactory。Nhibernate可以通过下面两种方式进行初始化：一、配置文件配置文件是最常用的方式，灵活简单 NHibernate.Dialect.MsSql2000Dialect NHibernate.Connection.DriverConnectionProvider NHibernate.Driver.SqlClientDriver Data Source=DD-10980FA277D7;Database=sampledb;User ID=sa;Password=sa; ReadCommitted sampledb.dbo true 下面的代码会调用默认的hibernat.cfg.xml配置文件：Configuration cfg = new Configuration().Configure();如果要用非默认文件初始化可以用下面代码：Configuration cfg = new Configuration().Configure(specificConfigName);二、通过代码设置Configuration属性，这种方式不推荐使用。通过配置文件名 Configuration cfg = new Configuration().AddFile("Item.hbm.xml").AddFile("Bid.hbm.xml");通过内嵌资源 Configuration cfg = new Configuration().AddClass(typeof(NHibernate.Auction.Item)).AddClass(typeof(NHibernate.Auction.Bid));这种方式自动加载对应类名称的hbm.xml文件。通过程序集Configuration cfg = new Configuration().AddAssembly( "NHibernate.Auction" );这种方式会加载指定程序集中所有的hbm.xml文件。注意：Nhibernate需要的只是hbm.xml文件，而不需要每个文件对应的类，类信息有Nhibernte通过反射与动态代理得到。ISessionFactoryISessionFactory管理数据库的映射关系、二级缓存和Sql语句池，负责创建Session，重量级对象，一个数据库对应一个，不能频繁创建，一般采用单例模式。下面语句创建了ISessionFactoryISessionFactory sessions = cfg.BuildSessionFactory();ISessionISession作为Nhibernate的一级缓存，是最常用的对象，ISession的操作比较复杂，涉及到的内容很多，后面会详细介绍。下面语句创建ISessionISession session=sessions.OpenSession();持久化类与映射文件下面的例子实现最简单的持久化操作。假定我们已经抽象出了某个业务领域的域模型：包含客户、订单。客户有客户名，订单包含订单号，并且要求根据订单能找到对应的客户信息。首先创建持久化类持久化类作为域对象使用，可以是标准的C#类，也可以是POCO类型，如果持久化类遵循POCO模型，Nhibernate可以工作的更好。在最新的Nhibernate中，默认了属性的延迟加载，为了能够让动态代理创建持久化的代理对象，必须把熟悉设置为Virtual，否则通过lazy=false关闭延迟加载。不要混淆持久化类与持久化状态，持久化类没有状态概念，它可以处于任何状态。用C#实现上面的域模型定义Customer：public class Customer { public Customer() { } public Customer(string name) { _name = name; } private int _id; public virtual int Id { get { return _id; } set { _id = value; } } private string _name; public virtual string Name { get { return _name; } set { _name = value; } }}定义Order，并建立到Customer的单向关联：public class Order { public Order(string orderno,Customer c) { _orderNumber = orderno; _customer = c; } public Order() { } private int _id; public virtual int Id { get { return _id; } set { _id = value; } } private string _orderNumber; public virtual string OrderNumber { get { return _orderNumber; } set { _orderNumber = value; } } private Customer _customer; public virtual Customer Customer { get { return _customer; } set { _customer = value; } }}到此持久化类以及定义完，下面要做的是把它映射到表。在Nhibernate中通过配置文件实现映射，这保证了域模型的可移植性。映射文件以nbm.xml作为后缀名，映射文件名称可以任意，但是最好和持久化类同名。其次创建映射文件Customer的映射文件Customer.hbm.xml Order.hbm.xml 配置文件完成下面的几类映射一、首先通过OID建立对象引用和数据表主键间的映射在.net中，通过引用来唯一标识一个对象，而在数据库中用主键唯一标识一条记录，因此必须建立对象与数据库表记录之间的一一对应关系。这种关系在Nhibernate中通过OID建立。如Customer.hbm.xml OID通过id元素映射，通常对应表的主键（ID），但这也不是强制性的，OID的目的是为了建立一一映射关系。二、建立类和表之间的关系要建立下面几种映射：通过class元素建立类名称与表名称的映射：通过property元素建立类属性和表字段的映射 Type可以为Nhibernate类型、.net类型自定义类型，此处用的是Nhibernate类型。建立对象间关系和表关系的映射，如把对象单向多对一关联映射为外健关系 建立一些辅助功能，这些能让nhibernate把持久化做的更好，如：延迟加载，抓取策略以及为更好生成数据库schema而设置的特性（column 特性）等。下面的配置为数据库架构生成器提供了更详细信息： 到此，已经建立了持久化类和数据表的关系，以后就可以透明持久化数据，Nhibernate会把我们对持久化类的操作通过Sql映射到数据库。这时我们也从烦人的ADO中解脱出来，可以把精力放到业务关系上，着力解决实际问题，而不是技术问题。 最后要做的是通过Session把业务数据存储到数据库。简单的CRUD操作，其中Session是Sessin接口的实例，例子中省去了Session管理。 [Test] public void Insert() { Customer c1 = new Customer("ding"); Session.Save(c1); } [Test] public void Select() { Customer c1 = Session.Load(1); } [Test] public void Update() { Customer c1 = Session.Load(1); c1.Name = "dinghao"; Session.Save(c1); } [Test] public void Delete() { Customer c1 = Session.Load(1); Session.Delete(c1); }代码是不是很简单？Nhibernate就是如此简便。因为涉及到Session，稍做些解释，这些有利于后面其他概念的理解和优化Nhibernate。Session作为一级缓存，维护着内存中的对象图，每当加载对象时Session就保存对象的一份引用，使之不被回收，作为缓存待用。如：Customer c1 = Session.Load(1);会创建Customer实例的两份引用，一份保存在c1，另一份保存在Session，这样即使c1不在引用Customer，只要Session不被情空，Customer对象仍然存活。这样查询时如果缓存命中，就不会再读取数据库，提高了效率。Customer c1 = new Customer("1");Session.Save(c1);执行insertCustomer c2 = Session.Get(c1.Id); //缓存中有数据，不会执行select。Session还可以提供更优化的Sql，因为只有在清理缓存时才执行sql，这也就提供了一个优化sql的时机，这时可以通过一些策略来使Nhibernate生产更高效的sql语句，优化后面有更详细说明。但是Session的缺点也很明显，它必须维护缓存于数据库的一致性，这造成没有办法实现高效的更新和删除操作，每次更新删除时必须通过执行查询，来保证Session不存在脏数据。如下面的删除操作 [Test] public void Delete() { Customer c1 = Session.Load(1); Session.Delete(c1); } 首先执行Load，然后删除。这是Nhibernate不能解决的问题，是Session模型本身的缺陷，一些优化只能缓解这种性能损失，所以批量操作最好通过NativeSql。Nhibernte1.2的文档说，通过把batch-size设置为0，SqlServer会执行批量更新、删除。没有经过测试。或许后续版本会提供无状态的Session和bulk更新删除（Hibernate3）。状态对象分三种状态，理解状态是理解Session管理的基础临时状态对象位于内存，但没有被Session管理，不对应数据库记录。持久状态已经加入到Session中，由Session管理，Nhibernate负责持久化，有对应记录。游离状态没有被Session管理，但可能对应一条纪律，也可能没有。简单的说这条记录有主键值，Nh会把它作为游离态，否则作为临时态。对象转换图实体和值对象Nhibernate中对象分两种，一种是值一种是实体，这是非常重要的概念。两者的本质区别是值没有OID，这就意味着值是个残缺的实体，他不能单独持久化，不能建立到实体的关联。抓取策略新版种通过lazy和fetch定义抓取策略，其中lazy定义什么时候检索数据，fetch定义如何检索数据。两种结合使用，lazy默认为true，fetch默认是select。由于默认采用延迟加载，如果Session关闭后，访问没有被加载对象会抛异常，可以调用NhibernteUtil.Initialize();使其被加载。或者Session关闭前对数据做初始化。Fetch默认采用select，这通常导致N＋1问题，其中的一种解决方式是，把fetch设置为join，以采用左外链接检索。批量检索，通过batch-size可以缩减生成的Select语句数量查询方式HqlHql是面向对象的查询语言，虽然看起来类似于sql，这只是为了让熟悉sql的用户更容易使用，Hql用到的是持久化类。几个例子： [Test] public void AgrigateFunction() { IList customers = Session.CreateQuery("select max(c.Age),sum(c.Age) from Customer c").List(); Console.Write(customers.Count); } [Test] public void InnerJoin() { IList customers = Session.CreateQuery("select c from Customer c inner join c.Orders o where c.Name like 'T%'").List (); Console.Write(customers.Count); } [Test] public void FetchLeftJoin() { IList customers = Session.CreateQuery("from Customer c left join fetch c.Orders o where c.Name like 'T%'").List (); Console.Write(customers.Count); }QBC提供面向对象的查询语法，不需要了解Sql，就可以使用。如： [Test] public void WhereSelect() { IList customers = Session.CreateCriteria(typeof(Customer)).Add(Expression.Eq("Name", "Tom")).List(); IList customers2 = Session.CreateCriteria(typeof(Customer)).Add(Expression.Eq("this.Name", "Tom")).List(); }下面是简单的Hql和QBC操作NativeSql最新的Nhibernte增强了本地sql查询，感觉可以比上Ibatise了，比以前好用很多。如：实体查询，把sql语句查询结果自动映射到类 [Test] public void Entiy() { IList c = Session.CreateSQLQuery("select * from CUstomers").AddEntity(typeof(Customer)).List(); Console.Write(c.Count); }标量查询：把查询结果映射到集合[Test] public void ScaleSelect() { IList c =Session.CreateSQLQuery("select * from CUstomers").AddScalar("Name", NHibernateUtil.String) .AddScalar("Age", NHibernateUtil.Int32).List(); Console.Write(c.Count); } 数据库设计和类设计关系数据库和OO的不对称性，才使得ORM有用武之地，首先是粒度，数据库为了效率一般采用粗粒度模型，而OO为了重用性、简便性多采用细粒度模型。这要求Nhibernte必须能透明的再两者间转换。其次是OO的一些特性，如关联、继承、多态、组合，在数据库中没有对应概念，这时Nhibernte要解决的第二个问题。以关联为例，类有一对一，一对多，多对一，多对多关联，并且这些关系是有方向的。数据库并不存在这些关系，也没有任何方向问题，但是数据库通过SQL可以模拟任意的关联关系。所以只要设置好Nhibernte的映射元数据，就可以把对象关联映射到数据库。后面有这几种映射方式的例子，见代码把OO概念映射到数据库下面的通过例子说明怎么映射OO概念到数据库，虽然分开说明，但他们不是孤立的。映射关联关系类的关联不一定需要映射到数据库，反之也一样。管理分实体间的关联与实体到值对象的关联，其中实体关联最常用。通过两种方式映射下面的关联关系实体间的one2many关联代码： private IList _orders; public virtual IList Orders { get { return _orders; } set { _orders = value; } }建立文件： 如果不希望Order有自觉的生命期，可以建立实体与值对象间的关联，代码：private IList _valueOrders; public virtual IList ValueOrders { get { return _valueOrders; } set { _valueOrders = value; } }映射文件： 测试代码： [Test] public void ComponentSet() { Customer c = new Customer("ding"); IList os = new List(); os.Add(new Domain.Order("dd",3)); c.ValueOrders = os; Session.Save(c); }映射组成关系组件在Nhibernate中用于映射对象间的组成关系组件是值对象（Value），用Componet以及包含Component的其他元素映射。如，映射下面的模型 private Address _homeAddress; public virtual Address HomeAddress { get { return _homeAddress; } set { _homeAddress = value; } } private Address _companyAddress; public virtual Address CompanyAddress { get { return _companyAddress; } set { _companyAddress = value; } }测试代码[TestFixture] [Category("Composite")] public class Composite:NhSession { [Test] public void SaveAll() { Customer c = new Customer("ding"); Address ha = new Address("ha", "bj", "hb", "0000"); Address ca = new Address("ha", "bj", "hb", "0000"); Session.Save(c); } [Test] public void SaveWithoutComponent() { Customer c = new Customer("ding"); Session.Save(c); } [Test] public void NullSemantic() { Customer c = new Customer("ding"); Session.Save(c); Customer c2 = Session.Load(c.Id); Assert.IsNull(c2.HomeAddress); } }映射继承关系以及多态映射继承有下面三种方式：http://www.martinfowler.com/eaaCatalog/singleTableInheritance.htmlhttp://www.martinfowler.com/eaaCatalog/classTableInheritance.htmlhttp://www.martinfowler.com/eaaCatalog/concreteTableInheritance.html现在以例子说明table per class与concrete table inheritance继承方式。假设存在下面的对象关系：如果用为了提高数据库效率，可以通过一个表映射继承，也就是单表继承首先再数据库设置一个标志例，该列说明雇员的类型。程序代码：见附件映射关系： 测试代码： [TestFixture] [Category("PerClassInheritence")] public class PerClassInheritence:NhSession { [Test] public void SaveSubClass() { IEmployee se = new SalariedEmployee("ding",3); Session.Save(se); } /**////

/// 多态查询 ///

[Test] public void GetBase() { IList es= Session.CreateQuery("from IEmployee").List(); Console.Write(es.Count); } [Test] public void GetSubBase() { int id = SaveHourEmployee(); IEmployee es = Session.Get(id); Console.Write(es.ToString()); } private int SaveHourEmployee() { IEmployee he = new HourlyEmployee("ding", 3); Session.Save(he); return he.Id; } }这种方式至持多态查询。一个具体类一个表，这种方式不能映射基类，所以不支持多态查询。代码省略，见附件集合映射集合映射分两类，一是实体类型集合，如关联的多端，另一类是值类型集合。集合映射有两种语义，一种是.net中集合的概念，另一种是nhibernate中集合的概念，前种在代码文件中体现，后一种体现在映射文件中。如用bag映射IList,ICollection。集合对应数据库中的表，表必须存在外键、做为集合元素的列，如果用含有索引语义的集合做映射，还必须包含能做索引的项。这部分和关联关系密切，可以结合理解。代码种经常会使用到集合，下面看看怎么把集合映射到数据库。假设有下面的代码private ISet _images; public virtual ISet Images { get { return _images; } set { _images = value; } } private IDictionary _mapImages; public virtual IDictionary MapImages { get { return _mapImages; } set { _mapImages = value; } } private IList _valueOrders; public virtual IList ValueOrders { get { return _valueOrders; } set { _valueOrders = value; } }映射Set，set是无序，没有索引，没有重复值的集合 映射Map，map包含键值对映射组件见关联关系集合排序，分两种一种为内存排序，另一种为通过Sql排序。内存排序可以通过实现IComparer接口，实现自定义排序。Sql排序通过order-by特性制定列名及排序机制，如：order－by＝“Filename desc”怎么理解Nhibernte理解NHibernate，应该从对象开始，即总是要考虑如何把对象映射到对应的数据库结构，而不是反过来思考。考虑Nhibernte生成的Sql是否过量，如果是考虑优化。Nhibernate,确实很复杂，我们用到的一般只是他的一部分功能。开发方式开发可以从数据库建模开始，也可以从OO建模开始。如果从数据库开始，就要把数据库表映射为类、hbm.xml文件。反之则把OO映射为表、hbm.xml文件。由于Nhibernte可以可以隔离类和数据库，我认为这种情况下两种方式区别已经不大，主要的问题在于哪知能更好的自动生成，以及在以后修改一方时能更好的自动更正另一方。不过最重要的一点是，不论从哪一方开始设计，最终的对象都不能是表的直接映射，否则采用Nhibernte也就没有什么意义了。好像还可以同时进行，建立抽象模型后，一边设计数据库，一边设计持久化类，最后用hbm.xml映射两者的关系。这种方式好像是最优的，缺点就是没有办法用自动生成工具，工作量较大。辅助工具最常用的是通过书库架构生成类和映射文件，目前支持1.2的工具不多，下面是支持1.2的模版：http://www.codeproject.com/useritems/NHibernate_Templates.asp但是必须要明确的是，生成的类一定要看看是否符合OO的标准，不要把任何表都映射为类。其他工具包括，通过hbm.xml生成数据库，通过特性映射而不用写hbm.xml资料中文：孙卫琴，精通hibernte，java对象持久化技术详解英文：nhibernate referenc,hibernate in action,Nhibernae in action(十月出版) 认真写了好久的例子：http://www.cnblogs.com/files/bluewater/nhiebernatedemo.rar 为什么不选用ActiveRecordhttp://www.cnblogs.com/bluewater/archive/2007/08/14/855557.html