本文基于Nhibernate 3.0 Cookbook,下载地址:
准备工作,下载Nhibernate:
因为是基于Nhibernate 3.0 Cookbook,所以用的版本也是书上的一致,不是最新的。
下面我们来说说如何通过配置类的XML文件,最后在数据库中生成相应的表。
一 创建一个简单的类映射。
1.新建一个类库项目:Eg.Core,并将解决方命名为:CookbookDemo。
2.在解决方案目录下,新建一个文件夹:Lib,并将下载的Nhibernate中Required_Bin folder和Required_For_LazyLoading\Castle目录中的文件解压到些文件夹中。
3.在类库项目:Eg.Core中,新建一个类Entity,代码如下:
public abstract class Entity { public virtual Guid Id { get; protected set; } }
4.在新建一个类:Product
public class Product : Entity { public virtual string Name { get; set; } public virtual string Description { get; set; } public virtual Decimal UnitPrice { get; set; } }
5.在项目Eg.Core中添加一个XML文件,命名为:Product.hbm.xml,右键该XML文件,选择属性,将生成操作改成:嵌入的资源。这个很重要,不然Nhbernate会找不到你所配置的XML文件。
打开Product.hbm.xml,配置hibernate-mapping如下:
PS:为了让配置XML时出现智能提示,在下载的NHibernate中找到configuration.xsd和nhibernate-mapping.xsd两个文件并复制到你的VS安装目录:X:\Program Files\Microsoft Visual Studio 9.0\Xml\Schemas目录即可。
6. 这样,Eg.Core项目就完成了,点击生成,确认没有错误后,我们再新建一个控制台项目:CookBookDemo,在项目中添加对Nhibernate.dll, NHibernate.ByteCode.Castle.dll,Eg.Core.dll的引用。
7.在CookBookDemo项目中添加配置文件:app.cofig
NHibernate.ByteCode.Castle.ProxyFactoryFactory, NHibernate.ByteCode.Castle NHibernate.Dialect.MsSql2008Dialect, NHibernate db 100
8 在program.cs中添加如下代码:
using System;using NHibernate.Cfg;using NHibernate.Tool.hbm2ddl;namespace CookBookDemo{ class Program { static void Main(string[] args) { var nhConfig = new Configuration().Configure(); var schemaExport = new SchemaExport(nhConfig); schemaExport.Create(false, true); Console.WriteLine("NHibernate Configured!"); Console.ReadKey(); } }}
9 将CookbookDemo设置为启动项目然后调试,控制台上输出:NHibernate Configured后再打开你的数据库,就可以看到生成的Product表了。
二、创建一个层次结构的映射。
比如,我们有两个具体的产品:Movie与Book,它们继承Product
我们先来看看存储在同一张表,即Product中:
1.在项目Eg.Core中新增两个类:Movie与Book
public class Movie : Product{public virtual string Director { get; set; }}
public class Book : Product{public virtual string ISBN { get; set; }public virtual string Author { get; set; }}
2.因为是存在同一张表中,所以为了区别Movie与Book,在Product中增加一个字段用于将它们区分开来,所以,我们要修改Product.hbm.xml
discriminator 节点中的值就是区分字段,默认情况下它的值就是类的名称,所以在本例中,它的值可能为:Eg.Core.Product, Eg.Core.Book, 与 Eg.Core.Movie。当然你也可以手动的通过在类或子类节点中增加discriminator-value属性来设置该类的鉴别值。如:
3.在项目中增加Movie.hbm.xml与Book.hbm.xml,注意要将生成操作改成:嵌入的资源。
4.编译并执行项目:CookbookDemo,执行成功后,打开数据库,我们可以看到新生成的Product表结构如下:
我们也可以将每个类存储在独立的表中,这也分两种情况:子类与父类之间有外键约束与没有外键约束
有外键约束的情况
1.Product.hbm.xml中去掉节点:discriminator,因为是存储在独立的表中,所以就不需要这个了。
2.修改Movie.hbm.xml为:
3.修改Book.hbm.xml为:
4.编译并执行项目:CookbookDemo,执行成功后,打开数据库,会看到有三张表:Book,Movie与Product,且三张表的关系如下图:
我们可以测试,如果尝试在Movie或Book表中插入Product表中不存在的ID是会报错的:
没有外键约束时,三张表都真的是独立存储,个人感觉这时候Product表就没什么作用了。
1.修改上面的Movie.hbm.xml为:
2.修改上面的Book.hbm.xml为:
3.编译并执行项目:CookbookDemo.打开数据库,表之间的关系图如一下:
三 一对多映射
很多数据都会出现一对多的情况,我们增加一个类ActorRole,它与Movie之间的关系是一对多的。
public class ActorRole : Entity { public virtual string Actor { get; set; } public virtual string Role { get; set; } }
再增加该类的XML文件:
修改Movie类:
public class Movie : Product { public virtual string Director { get; set; } public virtual IListActors { get; set; } }
修改Movie.hbm.xml文件:
all-delete-orphan表明,删除一个Movie时,与该Movie相关联的ActorRole也会被删除。