NHibernate入门教程系列第一篇：搭建基础环境是怎样的？

本文共计2482个文字，预计阅读时间需要10分钟。

链接：https://files.cnblogs.com/RicCC/nhibernate_1.2_example.rar

内容：介绍NHibernate的一些主要特性，确保理解NHibernate的使用和基于NHibernate的设计方案。涉及以下方面：

- 简单映射- many-to-many 关系

files.cnblogs.com/RicCC/nhibernate_1.2_example.rar

目的
考察NHibernate的一些主要特性，确定NHibernate的使用和基于NHibernate的设计方案。大致会包括以下一些方面：简单映射； many-to-many、many-to-one、one-to-many；枚举类型；自定义类型（简单类型和组合类型）；条件式查询 （Criteria）、HQL、Native SQL、NamedQuery；继承，其中会包括对lasy、cascade等一些特性的考察。

基础环境
VS 2005、framework 2.0、SQL Server 2000、NHibernate-1.2.0.CR1。
另外关于实体类和配置文件的自动生成，可以使用的一些工具有CodeSmith、ERStudio、Rational Rose等，本系列文章将采用手工编写的方式。
实体的定义属于概念模型，数据库结构属于物理模型，映射文件是概念模型到物理模型之间的映射。网上一些文章讲述用CodeSmith根据数据库结构生成实 体类和映射文件，即完全的通过物理模型得到概念模型以及映射关系，这个做法是不完善的，可能是Data Driven设计方式。Java的Hibernate extension根据配置文件生成实体类和数据库脚本，因为基于配置文件的映射关系可以比较充分的了解概念模型和物理模型，所以这种做法比较恰当，是 Domain Driven设计倾向。使用CodeSmith从配置文件生成实体类和数据库脚本也是可以的。
ERStudio的Logical Model可以看作轻量级的概念模型，它有到Physical Model的映射，因此可以考虑用它做Logical Model、Physical Model的设计，使用宏生成实体、配置文件和数据库。但因为它的长处只是在物理模型上，概念模型上的弱点可能会带来不小的限制。Rose在概念模型设计 上的优点是无疑的，也支持物理模型的设计，但不了解它对概念模型和物理模型之间映射的支持程度怎样，以及如何使用它的宏或者是COM做自定义生成，因此也 无法对这些方面进行评论。
项目不大的情况下，手工完成这些工作也不会有多少工作量；使用简单的方式生成实体类和配置文件的基础部分，映射关系等复杂、特殊的地方手工更改，看来这是最适用的方法了。如果想完美的自动生成，估计得自己写Desiner，这样做没有太多必要。

数据模型
这一个系列使用的数据模型暂定如下图，有些结构方面用NHibernate是否可以实现、怎样实现是待考察项目。

整个数据模型中的主键值，全部使用assigned的方式，即在程序中指定主键值，而不是使用NHibernate提供的自动主键生成方式。我希望尽量使 用业务上有意义的建作为主键，例如USER_ID值可能类似RicCC、COMPANY_ID值可能类似MS等。
TBLPURCHASEORDER、TBLPURCHASEORDERLINE分别为采购订单的主档、明细（行项目），是one-to-many的关系。 主档中COMPANY_ID、VENDOR_ID分别关联到公司（TBLCOMPANY）、供应商（TBLVENDOR）表，表名这个采购订单是哪个公 司、向哪个供应商进行采购，另外包含创建日期、币别、总金额、付款条件、签核状态、签核人、签核日期和时间等；明细中的PLANT_ID、ITEM_ID 分别关联到工厂（TBLPLANT）、物料（TBLITEM）表，表名这个明细项目是哪个工厂、采购什么材料，另外包含采购单位、单价、数量、交货日期、 明细项目状态等。
一个公司下面包含多个工厂，由TBLCOMPANY、TBLPLANT间的关系可以看出来。
采购订单主档中的APPROVED_DATE、APPROVED_TIME故意将签核时间拆分成两个整数类型的字段保存，希望在对象模型中通过一个 DateTimeWrapperType自定义组件类型来实现。APPROVE_STATE、LINE_STATE分别表示签核状态、明细项目状态，在对 象模型中都使用枚举类型表示，数据库中一个字段是整型，保存枚举的整型值，另一个是字符串类型，保存枚举类型的字符串描述，用这种方式分别对枚举类型的支 持进行测试。
有两个表：TBLPURCHASEORDERLINE、TBLPLANTITEM都是使用组合键作为主键（PO_NO+PO_LINE、PLANT_ID +ITEM_ID），NHibernate只支持单字段做主键，这两个地方用于考察是否可以使用自定义组合类型实现。
在TBLPURCHASEORDER中的CURRENT_PO_LINE用于控制TBLPURCHASEORDERLINE表中PO_LINE的生成。创 建PurchaseOrder对象时，CURRENT_PO_LINE初始化为0。在创建第一个PurchaseOrderLine对象时，使用 CURRENT_PO_LINE的值加一个增量1（或者增量10），作为新创建PurchaseOrderLine对象的PO_LINE值，然后 CURRENT_PO_LINE也加上这个增量。即CURRENT_PO_LINE加一个增量，就是下一个PurchaseOrderLine对象的 PO_LINE值。这里主要是考察一下这种设计方式下，使用NHibernate的开发模式。
TBLPLANTITEM表主要是考察继承方面。在对象模型上，PlantItem将继承自Item，这里有一些属性将使用父类的，例如 ITEM_DESCRIPTION；部分属性需要重写父类的，例如UNIT；另外子类会派生出自己的属性，例如ITEM_CATEGORY、 PURCHASE_CATEGORY等。
TBLUSER用户表，TBLPURCHASEGROUP采购组。某个采购订单是由特定的采购组来负责的，这个采购组里面的用户可以对这个采购订单进行维护（修改、删除等）。采购组跟用户是many-to-many关系，主要用于测试many-to-many。

数据库脚本
ifexists(select*fromdbo.sysobjectswhereid=object_id(N'[dbo].[RefTBLCOMPANY9]')andOBJECTPROPERTY(id,N'IsForeignKey')=1)
ALTERTABLE[dbo].[TBLPLANT]DROPCONSTRAINTRefTBLCOMPANY9
GO

ifexists(select*fromdbo.sysobjectswhereid=object_id(N'[dbo].[RefTBLCOMPANY2]')andOBJECTPROPERTY(id,N'IsForeignKey')=1)
ALTERTABLE[dbo].[TBLPURCHASEORDER]DROPCONSTRAINTRefTBLCOMPANY2
GO

ifexists(select*fromdbo.sysobjectswhereid=object_id(N'[dbo].[RefTBLITEM11]')andOBJECTPROPERTY(id,N'IsForeignKey')=1)
ALTERTABLE[dbo].[TBLPLANTITEM]DROPCONSTRAINTRefTBLITEM11
GO

ifexists(select*fromdbo.sysobjectswhereid=object_id(N'[dbo].[RefTBLITEM4]')andOBJECTPROPERTY(id,N'IsForeignKey')=1)
ALTERTABLE[dbo].[TBLPURCHASEORDERLINE]DROPCONSTRAINTRefTBLITEM4
GO

ifexists(select*fromdbo.sysobjectswhereid=object_id(N'[dbo].[RefTBLPLANT10]')andOBJECTPROPERTY(id,N'IsForeignKey')=1)
ALTERTABLE[dbo].[TBLPLANTITEM]DROPCONSTRAINTRefTBLPLANT10
GO

ifexists(select*fromdbo.sysobjectswhereid=object_id(N'[dbo].[RefTBLPLANT5]')andOBJECTPROPERTY(id,N'IsForeignKey')=1)
ALTERTABLE[dbo].[TBLPURCHASEORDERLINE]DROPCONSTRAINTRefTBLPLANT5
GO

ifexists(select*fromdbo.sysobjectswhereid=object_id(N'[dbo].[RefTBLPURCHASEGROUP7]')andOBJECTPROPERTY(id,N'IsForeignKey')=1)
ALTERTABLE[dbo].[TBLPURCHASEGROUPUSER]DROPCONSTRAINTRefTBLPURCHASEGROUP7
GO

ifexists(select*fromdbo.sysobjectswhereid=object_id(N'[dbo].[RefTBLPURCHASEGROUP8]')andOBJECTPROPERTY(id,N'IsForeignKey')=1)
ALTERTABLE[dbo].[TBLPURCHASEORDER]DROPCONSTRAINTRefTBLPURCHASEGROUP8
GO

ifexists(select*fromdbo.sysobjectswhereid=object_id(N'[dbo].[RefTBLPURCHASEORDER1]')andOBJECTPROPERTY(id,N'IsForeignKey')=1)
ALTERTABLE[dbo].[TBLPURCHASEORDERLINE]DROPCONSTRAINTRefTBLPURCHASEORDER1
GO

ifexists(select*fromdbo.sysobjectswhereid=object_id(N'[dbo].[RefTBLUSER6]')andOBJECTPROPERTY(id,N'IsForeignKey')=1)
ALTERTABLE[dbo].[TBLPURCHASEGROUPUSER]DROPCONSTRAINTRefTBLUSER6
GO

ifexists(select*fromdbo.sysobjectswhereid=object_id(N'[dbo].[RefTBLVENDOR3]')andOBJECTPROPERTY(id,N'IsForeignKey')=1)
ALTERTABLE[dbo].[TBLPURCHASEORDER]DROPCONSTRAINTRefTBLVENDOR3
GO

ifexists(select*fromdbo.sysobjectswhereid=object_id(N'[dbo].[TBLCOMPANY]')andOBJECTPROPERTY(id,N'IsUserTable')=1)
droptable[dbo].[TBLCOMPANY]
GO

ifexists(select*fromdbo.sysobjectswhereid=object_id(N'[dbo].[TBLITEM]')andOBJECTPROPERTY(id,N'IsUserTable')=1)
droptable[dbo].[TBLITEM]
GO

ifexists(select*fromdbo.sysobjectswhereid=object_id(N'[dbo].[TBLPLANT]')andOBJECTPROPERTY(id,N'IsUserTable')=1)
droptable[dbo].[TBLPLANT]
GO

ifexists(select*fromdbo.sysobjectswhereid=object_id(N'[dbo].[TBLPLANTITEM]')andOBJECTPROPERTY(id,N'IsUserTable')=1)
droptable[dbo].[TBLPLANTITEM]
GO

ifexists(select*fromdbo.sysobjectswhereid=object_id(N'[dbo].[TBLPURCHASEGROUP]')andOBJECTPROPERTY(id,N'IsUserTable')=1)
droptable[dbo].[TBLPURCHASEGROUP]
GO

ifexists(select*fromdbo.sysobjectswhereid=object_id(N'[dbo].[TBLPURCHASEGROUPUSER]')andOBJECTPROPERTY(id,N'IsUserTable')=1)
droptable[dbo].[TBLPURCHASEGROUPUSER]
GO

ifexists(select*fromdbo.sysobjectswhereid=object_id(N'[dbo].[TBLPURCHASEORDER]')andOBJECTPROPERTY(id,N'IsUserTable')=1)
droptable[dbo].[TBLPURCHASEORDER]
GO

ifexists(select*fromdbo.sysobjectswhereid=object_id(N'[dbo].[TBLPURCHASEORDERLINE]')andOBJECTPROPERTY(id,N'IsUserTable')=1)
droptable[dbo].[TBLPURCHASEORDERLINE]
GO

ifexists(select*fromdbo.sysobjectswhereid=object_id(N'[dbo].[TBLUSER]')andOBJECTPROPERTY(id,N'IsUserTable')=1)
droptable[dbo].[TBLUSER]
GO

ifexists(select*fromdbo.sysobjectswhereid=object_id(N'[dbo].[TBLVENDOR]')andOBJECTPROPERTY(id,N'IsUserTable')=1)
droptable[dbo].[TBLVENDOR]
GO

CREATETABLE[dbo].[TBLCOMPANY](
[COMPANY_ID][nvarchar](4)NOTNULL,
[COMPANY_NAME][nvarchar](70)NULL
)ON[PRIMARY]
GO

CREATETABLE[dbo].[TBLITEM](
[ITEM_ID][nvarchar](18)NOTNULL,
[ITEM_DESCRIPTION][nvarchar](50)NULL,
[UNIT][nvarchar](10)NULL,
[PRICE][decimal](18,6)NULL
)ON[PRIMARY]
GO

CREATETABLE[dbo].[TBLPLANT](
[PLANT_ID][nvarchar](4)NOTNULL,
[COMPANY_ID][nvarchar](4)NOTNULL,
[PLANT_DESCRIPTION][nvarchar](70)NULL
)ON[PRIMARY]
GO

CREATETABLE[dbo].[TBLPLANTITEM](
[PLANT_ID][nvarchar](4)NOTNULL,
[ITEM_ID][nvarchar](18)NOTNULL,
[UNIT][nvarchar](10)NULL,
[ITEM_CATEGORY][nvarchar](3)NULL,
[PURCHASE_CATEGORY][nvarchar](5)NULL,
[STOCK_OPTION][int]NULL
)ON[PRIMARY]
GO

CREATETABLE[dbo].[TBLPURCHASEGROUP](
[PURCHASE_GROUP_ID][nvarchar](3)NOTNULL,
[DESCRIPTION][nvarchar](50)NULL
)ON[PRIMARY]
GO

CREATETABLE[dbo].[TBLPURCHASEGROUPUSER](
[USER_ID][nvarchar](18)NOTNULL,
[PURCHASE_GROUP_ID][nvarchar](3)NOTNULL
)ON[PRIMARY]
GO

CREATETABLE[dbo].[TBLPURCHASEORDER](
[PO_NO][nvarchar](18)NOTNULL,
[COMPANY_ID][nvarchar](4)NOTNULL,
[VENDOR_ID][nvarchar](12)NOTNULL,
[PURCHASE_GROUP_ID][nvarchar](3)NOTNULL,
[CREATE_DATE][datetime]NOTNULL,
[CURRENCY][nvarchar](5)NOTNULL,
[TOTAL_AMOUNT][decimal](18,0)NULL,
[PAYMENT_TERMS][nvarchar](30)NULL,
[APPROVE_STATE][nvarchar](3)NULL,
[APPROVED_BY][nvarchar](16)NULL,
[APPROVED_DATE][int]NULL,
[APPROVED_TIME][int]NULL,
[CURRENT_PO_LINE][nvarchar](5)NULL
)ON[PRIMARY]
GO

CREATETABLE[dbo].[TBLPURCHASEORDERLINE](
[PO_NO][nvarchar](18)NOTNULL,
[PO_LINE][nvarchar](5)NOTNULL,
[PLANT_ID][nvarchar](4)NOTNULL,
[ITEM_ID][nvarchar](18)NOTNULL,
[UNIT][nvarchar](10)NULL,
[PRICE][decimal](18,6)NULL,
[QUANTITY][decimal](18,6)NULL,
[REQUEST_DATE][int]NULL,
[LINE_STATE][int]NULL
)ON[PRIMARY]
GO

CREATETABLE[dbo].[TBLUSER](
[USER_ID][nvarchar](18)NOTNULL,
[USER_NAME][nvarchar](40)NULL
)ON[PRIMARY]
GO

CREATETABLE[dbo].[TBLVENDOR](
[VENDOR_ID][nvarchar](12)NOTNULL,
[VENDOR_NAME][nvarchar](50)NULL
)ON[PRIMARY]
GO

ALTERTABLE[dbo].[TBLCOMPANY]WITHNOCHECKADD
CONSTRAINT[PK_TBLCOMPANY]PRIMARYKEYCLUSTERED
(
[COMPANY_ID]
)ON[PRIMARY]
GO

ALTERTABLE[dbo].[TBLITEM]WITHNOCHECKADD
CONSTRAINT[PK_TBLITEM]PRIMARYKEYCLUSTERED
(
[ITEM_ID]
)ON[PRIMARY]
GO

ALTERTABLE[dbo].[TBLPLANT]WITHNOCHECKADD
CONSTRAINT[PK_TBLPLANT]PRIMARYKEYCLUSTERED
(
[PLANT_ID]
)ON[PRIMARY]
GO

ALTERTABLE[dbo].[TBLPURCHASEGROUP]WITHNOCHECKADD
CONSTRAINT[PK_TBLPURCHASEGROUP]PRIMARYKEYCLUSTERED
(
[PURCHASE_GROUP_ID]
)ON[PRIMARY]
GO

ALTERTABLE[dbo].[TBLPURCHASEORDER]WITHNOCHECKADD
CONSTRAINT[PK_TBLPURCHASEORDER]PRIMARYKEYCLUSTERED
(
[PO_NO]
)ON[PRIMARY]
GO

ALTERTABLE[dbo].[TBLPURCHASEORDERLINE]WITHNOCHECKADD
CONSTRAINT[PK_TBLPURCHASEORDERLINE]PRIMARYKEYCLUSTERED
(
[PO_NO],
[PO_LINE]
)ON[PRIMARY]
GO

ALTERTABLE[dbo].[TBLUSER]WITHNOCHECKADD
CONSTRAINT[PK_TBLUSER]PRIMARYKEYCLUSTERED
(
[USER_ID]
)ON[PRIMARY]
GO

ALTERTABLE[dbo].[TBLVENDOR]WITHNOCHECKADD
CONSTRAINT[PK_TBLVENDOR]PRIMARYKEYCLUSTERED
(
[VENDOR_ID]
)ON[PRIMARY]
GO

ALTERTABLE[dbo].[TBLPLANTITEM]ADD
CONSTRAINT[Entity1PK]PRIMARYKEYNONCLUSTERED
(
[PLANT_ID],
[ITEM_ID]
)ON[PRIMARY]
GO

ALTERTABLE[dbo].[TBLPURCHASEGROUPUSER]ADD
CONSTRAINT[PKTBLPURCHASEGROUPUSER]PRIMARYKEYNONCLUSTERED
(
[USER_ID],
[PURCHASE_GROUP_ID]
)ON[PRIMARY]
GO

ALTERTABLE[dbo].[TBLPLANT]ADD
CONSTRAINT[RefTBLCOMPANY9]FOREIGNKEY
(
[COMPANY_ID]
)REFERENCES[dbo].[TBLCOMPANY](
[COMPANY_ID]
)
GO

ALTERTABLE[dbo].[TBLPLANTITEM]ADD
CONSTRAINT[RefTBLITEM11]FOREIGNKEY
(
[ITEM_ID]
)REFERENCES[dbo].[TBLITEM](
[ITEM_ID]
),
CONSTRAINT[RefTBLPLANT10]FOREIGNKEY
(
[PLANT_ID]
)REFERENCES[dbo].[TBLPLANT](
[PLANT_ID]
)
GO

ALTERTABLE[dbo].[TBLPURCHASEGROUPUSER]ADD
CONSTRAINT[RefTBLPURCHASEGROUP7]FOREIGNKEY
(
[PURCHASE_GROUP_ID]
)REFERENCES[dbo].[TBLPURCHASEGROUP](
[PURCHASE_GROUP_ID]
),
CONSTRAINT[RefTBLUSER6]FOREIGNKEY
(
[USER_ID]
)REFERENCES[dbo].[TBLUSER](
[USER_ID]
)
GO

ALTERTABLE[dbo].[TBLPURCHASEORDER]ADD
CONSTRAINT[RefTBLCOMPANY2]FOREIGNKEY
(
[COMPANY_ID]
)REFERENCES[dbo].[TBLCOMPANY](
[COMPANY_ID]
),
CONSTRAINT[RefTBLPURCHASEGROUP8]FOREIGNKEY
(
[PURCHASE_GROUP_ID]
)REFERENCES[dbo].[TBLPURCHASEGROUP](
[PURCHASE_GROUP_ID]
),
CONSTRAINT[RefTBLVENDOR3]FOREIGNKEY
(
[VENDOR_ID]
)REFERENCES[dbo].[TBLVENDOR](
[VENDOR_ID]
)
GO

ALTERTABLE[dbo].[TBLPURCHASEORDERLINE]ADD
CONSTRAINT[RefTBLITEM4]FOREIGNKEY
(
[ITEM_ID]
)REFERENCES[dbo].[TBLITEM](
[ITEM_ID]
),
CONSTRAINT[RefTBLPLANT5]FOREIGNKEY
(
[PLANT_ID]
)REFERENCES[dbo].[TBLPLANT](
[PLANT_ID]
),
CONSTRAINT[RefTBLPURCHASEORDER1]FOREIGNKEY
(
[PO_NO]
)REFERENCES[dbo].[TBLPURCHASEORDER](
[PO_NO]
)
GO