ORM设计工具:Mindscape NHibernate Designer,请安装Mindscape.NHibernateModelDesigner.vsix文件。
它是一个Visual Studio 2010的插件,运行时效果所示
支持Model frist和Database first两种开发模式,如下图所示
Update Model from Database,从数据库schema更新模型定义
Update Database from Model 则是以实体定义更新数据库。
设计器会生成一个组件layout文件,用于设计器工作,一个cs文件,对应于实体属性与数据库字段映射,Agent内容如下
public partial class Agent
{
public virtual string Name { get; set; }
public virtual string Position { get; set; }
public virtual string Description { get; set; }
static partial void CustomizeMappingDocument(System.Xml.Linq.XDocument mappingDocument);
internal static System.Xml.Linq.XDocument MappingXml
{
get
{
var mappingDocument = System.Xml.Linq.XDocument.Parse(@"<?xml version='1.0' encoding='utf-8' ?>
<hibernate-mapping xmlns='urn:nhibernate-mapping-2.2'
assembly='" + typeof(Agent).Assembly.GetName().Name + @"'
namespace='BusinessLogic'
>
<class name='Agent'
table='`Agent`'
>
<id name='Name'
column='`Name`'
>
<generator class='identity'>
</generator>
</id>
<property name='Position'
column='`Position`'
/>
<property name='Description'
column='`Description`'
/>
</class>
</hibernate-mapping>");
CustomizeMappingDocument(mappingDocument);
return mappingDocument;
}
}
}
MappingXml的值,就是我们开发NHibernate时需要配置的映射文件,由设计器维护。
数据库选用MySQL 5.1。
MySQL 数据表的创建
SQL脚本如下
DROP TABLE IF EXISTS `ctu`.`agent`;
CREATE TABLE `ctu`.`agent` (
`Name` varchar(40) NOT NULL,
`Position` varchar(45) NOT NULL,
`Description` varchar(45) NOT NULL,
PRIMARY KEY (`Name`)
) ENGINE=InnoDB DEFAULT CHARSET=latin1;
先查看一下这个表的数据项,有三笔数据,分别以Jack,Tony,Charles为主键
启动Visual Studio 2010,打开Server Explorer,创建一个新的MySQL连接
记住这里要勾选Allow saving password,否则当把表拖动到设计器中时,会出现无法连接的异常
把表CTU拖动到NHibernate设计器中,以完成模型的创建
在设计器中右键,调出Get Started菜单项
如图所示,已经写好了配置文件的主要内容,添加App.config或Web.config文件,把配置内容拷贝到文件中
<configSections>
<section name="hibernate-configuration" type="NHibernate.Cfg.ConfigurationSectionHandler, NHibernate" />
</configSections>
<hibernate-configuration xmlns="urn:nhibernate-configuration-2.2">
<session-factory>
<property name="dialect">NHibernate.Dialect.MySQL5Dialect</property>
<property name="connection.connection_string">User Id=root;Password=123;Host=JAMESLI;Database=ctu;Persist Security Info=True;</property>
<property name='proxyfactory.factory_class'>NHibernate.ByteCode.Castle.ProxyFactoryFactory, NHibernate.ByteCode.Castle</property>
</session-factory>
</hibernate-configuration>
在项目的启动目录中,添加这2个程序集:NHibernate.ByteCode.Castle.dll和Castle.Core.dll
把Get Started中的NHibernateHelper文件拷贝到项目中
public static class NHibernateHelper
{
private static ISessionFactory _sessionFactory;
internal static ISessionFactory SessionFactory
{
get
{
if (_sessionFactory == null)
{
var configuration = ConfigurationHelper.CreateConfiguration();
_sessionFactory = configuration.BuildSessionFactory();
}
return _sessionFactory;
}
}
internal static ISession OpenSession()
{
return SessionFactory.OpenSession();
}
}
设计如下的测试代码
[TestMethod]
public void TestFetch()
{
using (ISession session = NHibernateHelper.OpenSession())
using (ITransaction tx = session.BeginTransaction())
{
string name = "Tony";
Agent tony = session.Get<Agent>(name);
string fullName = tony.Description;
}
}
启动调试器,进入方法中,效果如下图所示
这表明,NHibernate已经成功的从MySQL数据库中取得了数据记录。
从.NET 1.1起,NHibernate就是极力推荐的ORM开发工具。因为没有称心的ORM设计工具,维护数据库字段与实体属性之间的映射关系非常麻烦,而且容易出错。商业的ORM工具,卖点之一就是简化映射文件的设计。不管是用xml文件或是cs文件来维护映射,只要维护关系映射简单,就是很大的进步,如果能熟练操作文章中提到的数据库与实体映射的内容,用NHibernate来开发ERP/MIS应该是很简单轻巧的事情。
写完了这篇文档,检查NHibernate文档,发生有个NHibernate.Tool.hbm2net的软件,解释如下
NHibernate.Tool.hbm2net 是 NHibernate 的附加软件.它使得从hbm.xml映射文件产生源代码成为可能。
在 NHibernate.Tasks目录,有一个叫做Hbm2NetTask的工具,你可以用它自动编译程序(使用NAnt)。
温故而知新,NHibernate拥有很多实用工具,再推荐一个工具NHibernate Profiler工具
在应用程序中添加对HibernatingRhinos.NHibernate.Profiler.Appender.dll程序集的引用,并在启动时添加代码
[TestInitialize]
public void InitializeProfiler()
{
HibernatingRhinos.NHibernate.Profiler.Appender.NHibernateProfiler.Initialize();
}
HibernatingRhinos.NHibernate.Profiler.Appender.NHibernateProfiler.Initialize();
以插入跟踪程序,再启动之前的测试方法,切换到NHibernate Profiler的界面中即可看到被发送到服务器的SQL语句。
当然,也可以用SQL Server Profiler来追踪出问题的SQL语句,举例说明
SalesOrderEntity salesOrder=session.Get<SalesOrderEntity>(5023);
这是用主键来查找数据记录,通常不会有问题。反过来,写两个SQL来对比一下,请看以下两条SQL
SELECT * FROM SalesOrder WHERE CustomerId is NULL
SELECT * FROM SalesOrder WHERE CustomerId =’’
这两句,从SQL的层面来理解,前一句是找出客户编号为空的采购单,后一句是找出客户编号为空白的采购单
对应于CustomerId,一般会用string类型来映射。如果有语句将CustomerId 初试化为string.Empty,而另一段代码
却没有初试化CustomerId,意味着CustomerId为null,这两个ORM语句发送到服务器中去,就会是两种不同的WHERE条件,即CustomerId =’’和CustomerId is NULL,也就是发送的ORM语句与实际SQL查询的结果不一致。
ORM开发中,出现ORM语句的语意与我们设想的SQL不同时,可使用NHibernate Profiler或SQL Server Profiler来追踪有问题的SQL语句,从而修改ORM的写法来排除错误。