[原创]Fluent NHibernate之旅二--Entity Mapping

简介: 接着上一篇,今天我们说说ORM中的Mapping。如果你要体验NHibernate的强大,首先你就要学会配置,包括SessionFactory和Mapping的配置。今天跟上一篇一样,会使用传统方式和 NHibernate 进行讲解。

接着上一篇,今天我们说说ORM中的Mapping。如果你要体验NHibernate的强大,首先你就要学会配置,包括SessionFactory和Mapping的配置。今天跟上一篇一样,会使用传统方式和 NHibernate 进行讲解。如果你要亲手试验一下,可以先看一下“Fluent NHibernate之旅一”,进行一下数据库和SessionFactory的准备。

本节内容:

  • 简单实体映射
  • 使用自定义类型映射实体属性

NHibernate的实体映射(Entity Mapping)做的非常好,虽然不是完美,但一些我们经常使用的,基本上已经都支持了,而且配置也相对比较简单。好了,开始我们的体验之旅吧。

一、简单实体映射

为了配合今后的教程,我们以一个简单的电子商务平台说起。一个B2C的电子商务,我们一定需要产品和订单,因为是示例,所以尽可能的简单,我们先设计两张表:Order 和 Product

image

我们先写Entity Model,无论传统方式还是Fluent,都需要这个Model。

public class Product
{
    public virtual int ProductID { get; set; }

    public virtual string Name { get; set; }

    public virtual decimal Price { get; set; }

    public virtual DateTime CreateTime { get; set; }
}

public class Order
{
    public virtual int OrderID { get; set; }

    public virtual decimal Price { get; set; }

    public virtual OrderState State { get; set; }

    public virtual DateTime CreateTime { get; set; }
}

public enum OrderState
{
    Created,
    Paied,
    Consignment,
    Complete,
}

稍微简单介绍下,订单有订单号、总价、订单状态、创建时间等属性,状态现在是int类型,过后我演示一下如何使用枚举型。产品有产品ID,产品名,价格,创建时间。今天的内容不涉及关联关系,所以我们今天暂且不说Order。

好了,接下来开始我们的代码演示阶段。

传统方式:传统方式使用xml文件进行映射,配置文件如下:

<hibernate-mapping xmlns="urn:nhibernate-mapping-2.2" namespace="EntityModel" assembly="EntityModel">
  <class name="Product" table="Product">
    <id name="ProductID">
      <generator class="native" />
    </id>
    <property name="Name">
      <column name="Name" length="50" sql-type="varchar(50)" not-null="true" />
    </property>
    <property name="Price">
      <column name="Price" sql-type="real" not-null="true" />
    </property>
    <property name="CreateTime">
      <column name="CreateTime" sql-type="datetime" not-null="true" />
    </property>
  </class>
</hibernate-mapping>

Order的映射大体与Product相似。

Fluent方式:或许你会觉得我们用了配置文件进行映射,相当的简单,想怎么配就可以了,但实际用下来,我还是更喜欢Fluent的映射方式,映射代码如下:

public class ProductMap : ClassMap<Product>
{
    public ProductMap()
    {
        Id(m => m.ProductID);
        Map(m => m.Name);
        Map(m => m.Price).ColumnName("Price");
        Map(m => m.CreateTime);
    }
}

我们只需要继承Fluent的ClassMap<T>类,然后在构造方法中完成映射方法,就能完成传统方式的映射了。映射的方式很简单吧,相信大家都能看懂吧,为什么会如此方便呢?这其实就是完全靠了Lambda表达式,大家可以看看老赵的“从.NET框架中委托写法的演变谈开去”,就非常清楚了。我们来看看Id和Map

Id(Expression<Func<T, object>> expression):一看就很明白了,主键嘛,因为有了VS,因为有了泛型,因为有了委托,因为……,我们只需要简单的 m => m.ProductID,可能你会说主键的类型,主键还有很多特性,难道不需要配置吗?回答是当然需要,因为我们这里的属性名与表中的主键名是相同的,所以没有进行设置,如果你数据库的主键名是ID,这里我们只需要Id(m => m.ProductID).ColumnName(“ID”),你可以看到上述映射中的Price,我用了一下,其实不用也是没有关系的,只是做演示。当然还有很多,因为有了智能感知,我们只要.一下就能看到很多方法,但有一点你要注意,.ColumnName()后就不能再进行配置了,所以其他一些配置,你要放在ColumName之前。

Map(Expression<Func<T, object>> expression):与Id类似,对应NHibernate中的property,我这里只是简单的映射,还有很多特性,在今后的教程中会慢慢使用。

两者之间的对比,只有用了以后你才能懂得,只能意传不能言语。对于我这种新手来说,Fluent更适合我,因为我可以用它来进行学习NHibernate。

映射做好了,接下来我们在NHibernate中把映射加到配置中。

传统方式:

<mapping assembly="MyNHibernate"/>

Fluent:

private static ISessionFactory CreateSessionFactory()
{
    return Fluently.Configure()
       .Database(MsSqlConfiguration.MsSql2005
            .ConnectionString(s => s.Server(".")
                .Database("MyNHibernate")
                .TrustedConnection()))
        .
        .BuildSessionFactory();
}

Fluent的方式比上一篇中多了Mappings方法,Mappings的配置方式有很多,我这里用了最简单的FluentMappings.AddFromAssembly,只要添加Entity Mapping所在的程序集就可以了。当然还有更多的方法,如果大家想了解的话,可以看一下Fluent NHibernate API Document

在这里顺带介绍一下,MappingConfiguration.ExportTo(string path) 方法,它能把你的Entity Mapping自动生成hbm.xml文件到你指定的path中,我们可以生成好hbm.xml文件,自己再看一篇,看看NHibernate的映射方式,所以是非常好的一个方法,我有时候做映射的时候,遇到问题都会生成出来,随时查看问题所在,所以说是非常有用的一个方法,而且你可以把你的映射文件直接用到NHibernate项目中去。

Product我们映射好了,我们试着测试一下吧,这一次,我们用传统方式插入数据,用Fluent方式获取数据,测试代码如下:

[TestMethod]
public void NHibernateFactory()
{
    var factory = TradSessionFactory.GetCurrentFactory();
    using (ISession session = factory.OpenSession())
    {
        Product product = new Product();
        product.CreateTime = DateTime.Now;
        product.Name = "First Product";
        product.Price = 15;

        session.Save(product);
    }
}

[TestMethod]
public void FluentFactory()
{
    var factory = FluentSessionFactory.GetCurrentFactory();
    using (var session = factory.OpenSession())
    {
        Product product = session.Load<Product>(1);
        Assert.AreEqual("First Product", product.Name);
    }
}

如果我们的映射都正确,这2个单元测应该会都通过,接下来我们看下测试结果:

image

正如我们预料的一样,测试通过,说明我们的映射没有出现错误。

二、使用自定义类型映射实体属性

NHibernate支持我们用自定义的类型来映射属性,但因为我是初学,我真的不会,当然我在网上找到了相关的资料,在此也不多说,就说说Fluent的方式吧,在我映射自定义属性的时候,也就是Map()的时候,我想看看Map还有哪些方法,结果就看到了CustomTypeIs() 和 CustomTypeIs<T>() 两个方法,一个使用反射,一个用泛型,强类型,我当然会选择后者咯。为了接下来的方便,我把Fluent的Mapping都生成到我传统方式的Mapping目录中,加入到项目,设置成嵌入的资源,一切都为了以后的教程,换句话说以后的教程中,我一般都会使用Fluent来进行映射,而传统方式作为学习之用。

在Order实体中,我们看到了订单状态我用了OrderState枚举类型,数据库存储类型为tinyint,对于它的映射,我们只需要:

public class OrderMap : ClassMap<Order>
{
    public OrderMap()
    {
        Id(p => p.OrderID);
        Map(p => p.Price);
        Map(p => p.State).CustomTypeIs<OrderState>();
        Map(p => p.CreateTime);
    }
}

是啊是啊,就这么简单,懂了吧,不需要解释了吧,连我英文这么差都能看得那么明白,我相信博客园的朋友一定比我更明白了吧。传统方式的映射,我是看了生成文件,也不是很复杂,而且我觉得生成的文件比我自己写的还要标准,呵呵。顺便贴一下吧。

<hibernate-mapping xmlns="urn:nhibernate-mapping-2.2" default-access="">
  <class name="EntityModel.Order, EntityModel, Version=1.0.0.0, Culture=neutral, PublicKeyToken=null" table="`Order`" xmlns="urn:nhibernate-mapping-2.2">
    <id name="OrderID" type="Int32" column="OrderID">
      <generator class="identity" />
    </id>
    <property name="Price" type="Decimal">
      <column name="Price" />
    </property>
    <property name="State" type="EntityModel.OrderState, EntityModel, Version=1.0.0.0, Culture=neutral, PublicKeyToken=null">
      <column name="State" />
    </property>
    <property name="CreateTime" type="DateTime">
      <column name="CreateTime" />
    </property>
  </class>
</hibernate-mapping>

接下来还是测试,这次换Fluent方式来新增Order,传统方式来获取这个Order,代码如下:

[TestMethod]
public void NHibernateFactory()
{
    var factory = TradSessionFactory.GetCurrentFactory();
    using (var session = factory.OpenSession())
    {
        Order order = session.Load<Order>(1);
        Assert.AreEqual(OrderState.Created, order.State);
        Assert.AreEqual(200, order.Price);
    }
}

[TestMethod]
public void FluentFactory()
{
    var factory = FluentSessionFactory.GetCurrentFactory();
    using (var session = factory.OpenSession())
    {
        Order order = new Order()
        {
            Price = 200,
            State = OrderState.Created,
            CreateTime = DateTime.Now
        };

        session.Save(order);
    }
}

老规矩,翠花,上测试结果:

image

不错不错,测试一切正常,今天的代码就到这里。

总结

今天介绍了如何映射简单的实体,但很多时候这都是理想的数据设计,还有更多复杂,不可预计的数据设计,这时候我们Fluent能做到吗?这个答案我也不知道,至少我在解决的问题的时候,觉得Fluent方式比传统方式要方便一些,至少我们测试的时候,我不需要把映射文件,配置文件等重新到复制到测试项目中了,呵呵。NHibernate是个强大的ORM框架,对他的了解我还太浅,还需要一定的时间去掌握。

前几天的开篇“Fluent NHibernate之旅一”,反响不是很好,或许大家用NHibernate的真的很少,或许我写的不够好,或许。。。。不过这不影响我需要完成这个系列的愿望,因为真的遇到了太多难以解决的问题,确实在解决中学到了很多,我很希望能把这一切与大家一起分享,至于好与坏,待大家来评价吧。

PS:终于可以上网了,憋了好久啊,哈哈

相关文章
|
SQL 开发框架 Oracle
Entity Framework简介
Entity Framework简介
194 0
一起谈.NET技术,NHibernate3剖析:Mapping篇之ConfORM实战(4):ManyToMany语义
  ConfORM概述   如果你不熟悉ConfORM请查看前几篇文章,你可以到http://code.google.com/p/codeconform/获取ConfORM最新版本。   在Domain设计中经常使用集合,在.
1202 0
一起谈.NET技术,NHibernate3剖析:Mapping篇之ConfORM实战(5):Component语义
  Component语义   使用ConfORM“映射”组件,我们无需特别设置,ConfORM内部会根据Domain定义来判定组件,一般而言,没有主键的类就是组件。 [Test]public void ComponentMappingDemo(){//show how work with comp...
978 0
一起谈.NET技术,NHibernate3剖析:Mapping篇之ConfORM实战(2):原理
  ConfORM概述   在上一节中,我用一个简单的例子描述了ConfORM简单使用。留下了很多疑问,大家不解为何使用ConfORM以及怎么使用ConfORM,其内部原理是什么。这节,我们先注重了解一些ConfORM的原理。
1054 0
|
XML 数据库 数据格式
一起谈.NET技术,NHibernate3剖析:Mapping篇之ConfORM实战(1):概览
  ORuM思想浮出   对于ORM(Object Relational Mapping)我们太熟悉了,但是我们从另一个角度可以想象出ORuM(Object Relational un-Mapping)的思想理念。
958 0
|
测试技术
一起谈.NET技术,NHibernate3剖析:Mapping篇之ConfORM实战(3):OneToOne语义
  ConfORM概述   在ConfORM实战(1):概览中,描述了ConfORM简单使用。在ConfORM实战(2):原理中介绍了ConfORM的基本实现原理。如果你不熟悉ConfORM请查看前几篇文章,你也可以到http://code.google.com/p/codeconform/获取ConfORM。
1297 0
|
Java 数据库连接 数据库