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

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

本节内容:

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

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

一、简单实体映射

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

我们先写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()))
        .Mappings(m => m.FluentMappings.AddFromAssembly(typeof(FluentSessionFactory).Assembly).ExportTo("c:\\path"))
        .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个单元测应该会都通过,接下来我们看下测试结果:

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

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

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);
    }
}

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

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

总结

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

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

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

本文参与腾讯云自媒体分享计划,欢迎正在阅读的你也加入,一起分享。

发表于

我来说两句

0 条评论
登录 后参与评论

相关文章

来自专栏领域驱动设计DDD实战进阶

DDD实战进阶第一波(四):开发一般业务的大健康行业直销系统(搭建支持DDD的轻量级框架三)

上一篇文章我们讲了经典DDD架构对比传统三层架构的优势,以及经典DDD架构每一层的职责后,本篇文章将介绍基础结构层中支持DDD的轻量级框架的主要代码。 这里需要...

5765
来自专栏walterlv - 吕毅的博客

Roslyn 入门:使用 .NET Core 版本的 Roslyn 编译并执行跨平台的静态的源码

发布于 2018-05-25 13:24 更新于 2018-06...

621

当Vert.x符合Reactive eXtensions(Vert.x简介的第5部分)

这篇文章是我介绍Eclipse Vert.x系列的第五篇文章。在上一篇文章中,我们看到了Vert.x如何与数据库交互。我们使用Future对象来驯服Vert.x...

1842
来自专栏NetCore

打造属于自己的支持版本迭代的Asp.Net Web Api Route

    在目前的主流架构中,我们越来越多的看到web Api的存在,小巧,灵活,基于Http协议,使它在越来越多的微服务项目或者移动项目充当很好的service...

23310
来自专栏点滴积累

使用C#将json字符串作为对象存入MongoDB

      今天刚好在工作中碰到一个小问题,并愉快的解决了,权当将其记录下来,供人查阅,首先声明本人是个忠实的微软技术爱好者,主要使用的也是.NET语言。下面进...

4177
来自专栏NetCore

学习BlogEngine.Net解读笔记系列(一)

大家好,第一次认真的去解读一个开源作品,或许有很多不对的地方,请大家及时提醒,以便我及时修改,不要越错越多:) 大家或许很早就研究过BlogEngine.Net...

2129
来自专栏NetCore

微信快速开发框架(二) -- 快速开发微信公众平台框架---简介

年底了,比较忙,大家都在展望未来,对于30+的我来说,发展和稳定是个难以取舍的问题。最近发了些求职信,鸟无音讯,没事做,做点帮助大家的东西吧。 之前做了个微信公...

28010
来自专栏cmazxiaoma的架构师之路

C#学习之路(1)--数据库技术

2084
来自专栏哲学驱动设计

三层的困惑

这个问题困惑我已经很久了,从开始学习。NET到现在…… 写三层的时候,遇到这样的情况怎么办? User{     int UserId,     Strin...

1935
来自专栏debugeeker的专栏

公司内部文档安全软件coredump分析实例

版权声明:本文为博主原创文章,未经博主允许不得转载。 https://blog.csdn.net/xuzhina/article/detai...

1012

扫码关注云+社区

领取腾讯云代金券