NHibernate 基本值类型

基本值类型(Basic value types)

基本的值类型大致可以粗糙的分为三组:System.ValueType类型,System.Object类型和支持大对象的System.Object类型.和.NET类型一样,System.ValueType对应的列不能存储null值,而System.Object可以.

表4.3 System.ValueType 映射类型

NHibernate 类型.NET 类型Database 类型备注BooleanSystem.BooleanDbType.Boolean在没有指定类型(type) 属性时的默认值ByteSystem.ByteDbType.Byte在没有指定类型(type) 属性时的默认值CharSystem.CharDbType.StringFixedLength - 1 char在没有指定类型(type) 属性时的默认值DateTimeSystem.DateTimeDbType.DateTime -忽略毫秒在没有指定类型(type) 属性时的默认值DecimalSystem.DecimalDbType.Decimal在没有指定类型(type) 属性时的默认值DoubleSystem.DoubleDbType.Double在没有指定类型(type) 属性时的默认值GuidSystem.GuidDbType.Guid在没有指定类型(type) 属性时的默认值Int16System.Int16DbType.Int16在没有指定类型(type) 属性时的默认值Int32System.Int32DbType.Int32在没有指定类型(type) 属性时的默认值Int64System.Int64DbType.Int64在没有指定类型(type) 属性时的默认值PersistentEnum一个System.Enum潜在类型对应的DbType

不用在映射文件指定type="PersistentEnum".而是提供枚举的程序集全名,让NHibernate用反射来猜测类型。枚举使用的潜在类型决定适当的DbType。

SingleSystem.SingleDbType.Single在没有指定类型(type) 属性时的默认值TicksSystem.DateTimeDbType.Int64type="Ticks"必须被指定TimeSpanSystem.TimeSpanDbType.Int64在没有指定类型(type) 属性时的默认值TimestampSystem.DateTimeDbType.DateTime - 取决于数据库支持type="Timestamp"必须被指定TrueFalseSystem.Boolean

DbType.AnsiStringFixedLength - 一个字符,'T' 或者'F'

type="TrueFalse" 必须被指定YesNoSystem.BooleanDbType.AnsiStringFixedLength - 一个字符,'Y' 或者'N'type="YesNo"必须被指定

表4.4 System.Object 映射类型

NHibernate 类型.NET 类型Database 类型备注AnsiStringSystem.StringDbType.AnsiStringtype="AnsiString"必须被指定CultureInfoSystem.Globalization.CultureInfoDbType.String - 表明文化(culture)的5个字符在没有指定类型(type) 属性时的默认值BinarySystem.Byte[]DbType.Binary在没有指定类型(type) 属性时的默认值TypeSystem.TypeDbType.String 容纳程序集全名在没有指定类型(type) 属性时的默认值StringSystem.StringDbType.String在没有指定类型(type) 属性时的默认值

表4.5 Large Object 映射类型

NHibernate 类型.NET 类型Database 类型备注StringClobSystem.StringDbType.Stringtype="StringClob" 必须被指定.整个字段被读入内存BinaryBlobSystem.Byte[]DbType.Binarytype="BinaryBlob" 必须被指定. 整个字段被读入内存Serializable

任何被标记了可序列化属性(SerializableAttribute)的System.Object.

DbType.Binarytype="Serializable" 应该被指定. 如果不能为属性找到NHibernate类型，这是最后可依靠的类型。

要掌握NHibernate或者使用某种工具生成NHibernate的hbm.xml文件，应该了解这是一个NHibernate类型名的完整的层。type="integer"被映射为Int32NHibernateType,type="short"被映射为Int16NHibernateType.查看所有的转换你可以查看NHibernate.Type.TypeFactory类的静态构造函数.

自定义值类型(Custom value types)

开发者创建属于他们自己的值类型也是很容易的。比如说，你可能希望持久化Int64类型的属性，持久化成为VARCHAR字段。NHibernate没有内置这样一种类型。自定义类型能够映射一个属性（或集合元素）到不止一个数据库表字段。比如说，你可能有这样的属性：Name {get; set;} ，这是String类型的，对应的持久化到三个字段：FIRST_NAME,INITIAL, SURNAME。

要实现一个自定义类型，可以实现NHibernate.IUserType或NHibernate.ICompositeUserType中的任一个，并且使用类型的全限定类名来声明属性。请查看NHibernate.DomainModel.DoubleStringType这个例子，看看它是怎么做的。

<property name="TwoStrings" type="NHibernate.DomainModel.DoubleStringType, NHibernate.DomainModel"><column name="first_string"/><column name="second_string"/></property>

注意使用<column>标签来把一个属性映射到多个字段的做法。

虽然NHibernate内置的丰富类型和对component的支持意味着你可能很少需要使用自定义类型，至少对于你程序中经常出现的自定义类（并非实体）来说，这是一种好方法。比如说，MonetoryAmount(价格总额)对比使用ICompositeUserType来说更好,虽然它可以很容易的使用一个component实现。这样做的动机之一是抽象。通过自定义类型，以后假若你改变表示金额值的方法时，你的映射文件不需要更改，这就得到了保护。

映射到"任意"(any)类型

TODO

SQL中引号包围的标识符

你可强制NHibernate在生成的SQL中把标识符用引号前后包围起来，这需要在映射文档中使用反向引号(`)把表名或者字段名包围（可能比较拗口，请看下面的例子）。NHibernate会使用相应的SQLDialect（方言）来使用正确的引号风格（通常是双引号，但是在SQL Server中是括号，MySQL中是反向引号）。

<class name="LineItem" table="`Line Item`"><id name="id" column="`Item Id`"><generator class="assigned"/></id><property name="itemNumber" column="`Item #`"/>...</class>

映射文件的模块化（Modular mapping files）

允许在独立的映射文档中定义subclass和joined-subclass，直接位于hibernate-mapping下。这就可以让你每次扩展你的类层次的时候，加入新的映射文件就行了。在子类的映射中你必须指定一个extends属性，指明先前已经映射过的超类。如果你使用嵌入的资源(Embedded Resources)配置NHibernate, hbm.xml文件会自动配置为正确的顺序.如果手动添加或者在cfg.xml文件中指定它们,映射文件的排序是非常重要的!

<hibernate-mapping><subclass name="Eg.Subclass.DomesticCat, Eg" extends="Eg.Cat, Eg" discriminator-value="D"><property name="Name" type="String"/></subclass></hibernate-mapping>