Fluent NHibernate

Id(p => p.Ticketcode).GeneratedBy.Assigned().UnsavedValue(null);//指定策略主键传进来

为什么要取代XML文件呢？
a.XML不是实时编译的。当你的XML配置文件有错误时，你只有在运行时才能看到哪里出错。
b.XML是非常繁琐的。的确在NHibernate中的配置文件，xml节点非常简单，但是仍然掩盖不了XML文件本身的繁琐性。
c.映射文件中重复的属性设置。比如在xml中我们需要设置每个string类型的字段都不允许为空，长度大于1000，int型都得有个默认值为-1,这样最终的xml配置文件你会发现有很多的重复工作。
Fluent NHibernate如何克服这些缺陷呢？
Fluent NHibernate把这些配置为文件都转化为了C#代码，这样可以让你的mapping直接在编译时就完成。

下面是传统的HBM XML mapping文件和Fluent NHibernate的对比。

Fluent NHibernate 的下载地址： http://github.com/jagregory/fluent-nhibernate

实战一常用情况

建立的map映射
public UserMap()
        {
            Table( " LoginUser " );
            Id(p => p.LoginId).Unique();

            References(p => p.LoginUserRank)
            .LazyLoad()
            .Not.Insert()
            .Not.Update()
            .NotFound.Ignore()
            .Column( " RankId " );

            HasMany(p => p.LoginUserAddressList)
            .AsSet()
            .LazyLoad()
            .Cascade.Delete().Inverse()
            .NotFound.Ignore()
            .KeyColumn( " LoginId " );

            HasManyToMany(p => p.DepartmentList)
           .AsSet()
           .LazyLoad()
           .Cascade.Delete().Inverse()
           .NotFound.Ignore().ParentKeyColumn( " LoginId " ).ChildKeyColumn( " DepartmentId " )
           .Table( " LoginUser_Department " );
        }



实战二关系表中字段名不同

public UserMap()
        {
            Table( " LoginUser " );
            Id(p => p.LoginId).UnsavedValue( " any " );

            References(p => p.LoginUserRank)
            .LazyLoad()
            .Not.Insert()
            .Not.Update()
            .NotFound.Ignore()
            .Column( " RankCode " ); // 当前表中的那个字段跟 LoginUserRank表的主键关联
                                 // 如果LoginUserRank表中的RankId非主键加上PropertyRef设置

            HasMany(p => p.LoginUserAddressList)
                .AsSet()
                .LazyLoad()
                .Cascade.Delete().Inverse() // 由当前表维护关系
                .NotFound.Ignore()
                .KeyColumn( " LoginCode " ); // 当前表的主键跟LoginUserAddressList中的那个键相关联
                                          // 如果不是当前表的主键跟LoginUserAddressList关联  加上PropertyRef设置

            HasManyToMany(p => p.DepartmentList)
               .AsSet()
               .LazyLoad()
               .Cascade.Delete().Inverse()
               .NotFound.Ignore()
               .ParentKeyColumn( " LoginCode " ) // 当前表的主键跟LoginUser_Department中的那个键相关联
               .ChildKeyColumn( " DepartmentCode " ) // LoginUser_Department中的那个键跟Department的主键关联
               .Table( " LoginUser_Department " );

        }


实战三关系表中字段名不同并且关联字段非主键

Table( " LoginUser " );
            Id(p => p.LoginId).UnsavedValue( " any " );
            Map(p=>p.LoginCode);

            References(p => p.LoginUserRank)
            .Not.Insert()
            .Not.Update()
            .NotFound.Ignore()
            .Column( " RankCode " ).PropertyRef( " RankCode " );

            HasMany(p => p.LoginUserAddressList)
                .AsSet()
                .LazyLoad()
                .Cascade.Delete().Inverse() // 由当前表维护关系
                .NotFound.Ignore()
                .KeyColumn( " LoginCode " ).PropertyRef( " LoginCode " );

            HasManyToMany(p => p.DepartmentList)
               .AsSet()
               .LazyLoad()
               .Cascade.Delete().Inverse()
               .NotFound.Ignore()
               .ParentKeyColumn( " LoginCode " ).PropertyRef( " LoginCode " )
               .ChildKeyColumn( " DepartmentCode " ).ChildPropertyRef( " DepartmentCode " )
               .Table( " LoginUser_Department " );



子实体(Order)映射定义的东西就是父实体少了：与父实体关联的(多对一、一对多、多对多) 关系，并用一个指针来导航到父实体。
在“子”端通过many-to-one元素定义与“父”端的关联，从“子”端角度看这种关系模型是多对一关联(实际上是对Customer对象的引用)。下面看看many-to-one元素映射属性：

看看这些映射属性具体有什么意义： access(默认property)：可选field、property、nosetter、ClassName值。NHibernate访问属性的策略。 cascade(可选)：指明哪些操作会从父对象级联到关联的对象。可选all、save-update、delete、none值。除none之外其它将使指定的操作延伸到关联的(子)对象。 class(默认通过反射得到属性类型)：关联类的名字。 column(默认属性名)：列名。 fetch(默认select)：可选select和join值，select：用单独的查询抓取关联；join：总是用外连接抓取关联。 foreign-key：外键名称，使用SchemaExport工具生成的名称。 index：...... update，insert(默认true)：指定对应的字段是否包含在用于UPDATE或INSERT 的SQL语句中。如果二者都是false，则这是一个纯粹的 “外源性(derived)”关联，它的值是通过映射到同一个(或多个)字段的某些其他特性得到或者通过触发器其他程序得到。 lazy：可选false和proxy值。是否延迟，不延迟还是使用代理延迟。 name：属性名称propertyName。 not-found：可选ignore和exception值。找不到忽略或者抛出异常。 not-null：可选true和false值。 outer-join：可选auto、true、false值。 property-ref(可选)：指定关联类的一个属性名称，这个属性会和外键相对应。如果没有指定，会使用对方关联类的主键。这个属性通常在遗留的数据库系统使用，可能有外键指向对方关联表的某个非主键字段（但是应该是一个唯一关键字）的情况下，是非常不好的关系模型。比如说，假设Customer类有唯一的CustomerId，它并不是主键。这一点在NHibernate源码中有了充分的体验。 unique：可选true和false值。控制NHibernate通过SchemaExport工具生成DDL的过程。 unique-key(可选)：使用DDL为外键字段生成一个唯一约束。
我们来建立“子”端到“父”端的映射，新建Order.hbm.xml文件，编写代码如下：

<?xml version="1.0" encoding="utf-8" ?>
<hibernate-mapping xmlns="urn:nhibernate-mapping-2.2" 
                   assembly="DomainModel" namespace="DomainModel">
  
  <class name="DomainModel.Entities.Order,DomainModel" table="`Order`" >
    <id name="OrderId" column="OrderId" type="Int32" unsaved-value="0">
      <generator class="native" />
    </id>
    <property name="OrderDate" column="OrderDate" type="DateTime"
              not-null="true" />
    <!--多对一关系：Orders属于一个Customer-->
    <many-to-one name="Customer" column="Customer" not-null="true"
                 class="DomainModel.Entities.Customer,DomainModel"
                 foreign-key="FK_CustomerOrders" />
  </class>
</hibernate-mapping>

Fluent NHibernate

推荐阅读