• 引入
• SchemaExport工具
• SchemaUpdate工具
• 实例分析
• 结语

引入

我其实都是一直先编写持久化类和映射文件，然后使用SchemaExport工具生成数据库架构。这样的方式就是领域驱动设计/开发(DDD，Domain Driven Design/Development)。我的理解是系统的设计应该基于对象模型，主要考虑对象的设计和逻辑上，然后按照对象模型建立数据库关系模型，这才是现在面向对象开发的步骤，并不是上一篇先设计数据库然后再设计对象。用一幅图可以形象的说明领域驱动设计：

当在设计时，我们的领域模型需要改变，只需修改NHibernate结构和应用程序，不需要修改数据库架构，只要利用SchemaExport工具重新生成数据库架构就可以了。但是使用数据库只是其中一种方式，我们也可以使用XML文件来存储数据。

SchemaExport工具

NHibernate的hbm2dll提供SchemaExport工具：给定一个连接字符串和映射文件，不需输入其他东西就可以按照持久化类和映射文件自动生成数据库架构，现在SchemaExport工具还不是很强大，但是一般应用足够了，它还是一个相当原始的API还在不断改进。

SchemaExport工具就是把DDL脚本输出到标准输出，同时/或者执行DDL语句。SchemaExport工具提供了三个方法，分别是Drop()、Create()、Execute()，前两个方法实质是调用Execute()方法。通常使用Execute()方法来生成数据库架构的。

SchemaUpdate工具

在NHibernate2.0中新添加SchemaUpdate工具，可以用来更新数据库架构。但是我觉得没有什么作用，因为它不能Drop现有的表或列，也不能更新现有的列，只能添加新的表和列。如果我需要删除表或者列或者修改其中列，SchemaUpdate工具就显得无能为力了。

实例分析

知道了上面的知识就好好实战一下：看看具体怎么使用呢？

1.SchemaExport工具实战

通常我们使用生成数据库架构代码实例像这样：

Configuration cfg=new Configuration();
cfg.Configure();
SchemaExport export =new SchemaExport(cfg);
export.Execute(....);

1.准备工作

现在数据访问测试层新建一SchemaExportFixture.cs文件用于测试生成实战。声明一个全局变量_cfg，编写 [SetUp]方法在每个测试方法执行之前调用：

TestFixture]
public class SchemaExportFixture
{
private Configuration _cfg;
[SetUp]
public void SetupContext()
{
_cfg = new Configuration();
_cfg.Configure();
}
//测试......
}

2.测试Drop(script, export)方法

Test]
public void DropTest()
{
var export = new SchemaExport(_cfg);
export.Drop(true, true);
}

Drop(script, export)方法根据持久类和映射文件执行删除数据库架构。有两个参数，第一个为True就是把DDL语句输出到控制台，第二个为True就是根据持久类和映射文件执行删除数据库架构操作，经过调试可以发现Drop(script, export)方法其实质是执行了Execute(script, export, true, true)方法。

3.测试Create(script, export)方法

Test]
public void CreateTest()
{
var export = new SchemaExport(_cfg);
export.Create(true, true);
}

Create(script,export)方法根据持久类和映射文件先删除架构后创建删除数据库架构。有两个参数，第一个为True就是把DDL语句输出到控制台，第二个为True就是根据持久类和映射文件先执行删除再执行创建操作，经过调试可以发现这个方法其实质是执行Execute(script,export, false, true)方法。

4.测试Execute(script, export, justDrop, format)方法

Test]
public void ExecuteTest()
{
var export = new SchemaExport(_cfg);
export.Execute(true, true, false, false);
}

Execute(script, export, justDrop, format)方法根据持久类和映射文件先删除架构后创建删除数据库架构。有四个参数，第一个为True就是把DDL语句输出到控制台；第二个为True就是根据持久类和映射文件在数据库中先执行删除再执行创建操作；第三个为false表示不是仅仅执行Drop语句还执行创建操作，这个参数的不同就扩展了上面两个方法；第四个参数为false表示不是格式化输出DDL语句到控制台，是在一行输出的。

所谓格式化输出就像这样：

一行输出就像这样：

5.测试Execute(script, export, justDrop, format, connection, exportOutput)方法

Test]
public void ExecuteOutTest()
{
var export = new SchemaExport(_cfg);
var sb = new StringBuilder();
TextWriter output = new StringWriter(sb);
export.Execute(true, false, false, false, null, output);
}

Execute(script, export, justDrop, format, connection, exportOutput)方法根据持久类和映射文件先删除架构后创建删除数据库架构。有六个参数，第一个为True就是把DDL语句输出到控制台；第二个为false就是不执行DDL语句；第五个为自定义连接。当export为true执行语句时必须打开连接。该方法不关闭连接，null就是使用默认连接，最后一个参数自定义输出，这里我输出到TextWriter中。

2.SchemaUpdate工具实战

现在数据访问测试层新建一SchemaUpdateFixture.cs文件用于测试生成实战。先声明一个全局变量_cfg：

private Configuration _cfg;

这里我用另外一种方式配置映射文件，先定义两个映射XML分别代表旧的和新的这样才能体现测试更新数据库架构的意义。

旧映射XML：这里我使用Product持久化类，由于在之前我们定义了Product持久化类，这里直接模拟定义映射XML：拥有主键ProductId和Name字段。

public const string product_xml =
"<?xml version='1.0' encoding='utf-8' ?>" +
"<hibernate-mapping xmlns='urn:nhibernate-mapping-2.2'" +
"                 assembly='DomainModel'" +
"                 namespace='DomainModel'>" +
"  <class name='DomainModel.Entities.Product,DomainModel'>" +
"    <id name='ProductId'>" +
"      <generator class='native'/>" +
"    </id>" +
"    <property name='Name'/>" +
"  </class>" +
"</hibernate-mapping>";

新映射XML：更新上面映射XML：主键ProductId(没有改变)；Name字段：添加不可为空和长度为50；另外增加了Cost字段，类型为float不可为空。

public const string newproduct_xml =
"<?xml version='1.0' encoding='utf-8' ?>" +
"<hibernate-mapping xmlns='urn:nhibernate-mapping-2.2'" +
"                 assembly='DomainModel'" +
"                 namespace='DomainModel'>" +
"  <class name='DomainModel.Entities.Product,DomainModel'>" +
"    <id name='ProductId'>" +
"      <generator class='native'/>" +
"    </id>" +
"    <property name='Name' not-null='true' length='50' />" +
"    <property name='Cost' type='float' not-null='true'/>" +
"  </class>" +
"</hibernate-mapping>";

测试前利用旧映射XML创建数据库架构：使用[SetUp]在测试前执行，按照旧映射XML创建数据库架构并格式化输出DDL语句：

SetUp]
public void SetupContext()
{
//模拟旧系统
_cfg = new Configuration();
_cfg.Configure();
_cfg.AddXml(product_xml);
var export = new SchemaExport(_cfg);
export.Execute(true, true, false, true);
}

测试更新数据库架构：使用SchemaUpdate类提供的唯一的Execute(script, doUpdate)方法按照新映射XML更新数据库架构：

Test]
public void UpdateExistingDatabaseSchemaTest()
{
_cfg = new Configuration();
_cfg.Configure().AddXml(newproduct_xml);
var update = new SchemaUpdate(_cfg);
update.Execute(true, true);
}

测试输出结果如图所示，如果你觉得不放心再看看数据库Product表。

看到了吗？这显然不是我要求的，首先按照旧映射XML创建了数据库架构，但是更新数据库架构显得无能为力，仅仅增加了Cost字段，我想更新Name字段属性为不可为空和长度为50，但是SchemaUpdate工具不能做到！我觉得这个类目前还没有什么作用，期待下一个版本来完善。

结语

这篇文章通过实例介绍NHibernate中提供两个实用工具SchemaExport工具利用持久化类和映射文件生成数据库架构。SchemaUpdate工具通过持久化类和映射文件更新数据库架构。

cglib-full-2.0.2.jar
CGLIB库，Hibernate用它来实现PO字节码的动态生成，非常核心的库，必须使用的jar包

dom4j-1.4.jar
dom4j是一个Java的XML API，类似于jdom，用来读写XML文件的。dom4j是一个非常非常优秀的Java XML API，具有性能优异、功能强大和极端易用使用的特点，同时它也是一个开放源代码的软件，可以在SourceForge上找到它。在IBM developerWorks上面可以找到一篇文章，对主流的Java XML API进行的性能、功能和易用性的评测，dom4j无论在那个方面都是非常出色的。我早在将近两年之前就开始使用dom4j，直到现在。如今你可以看到越来越多的Java软件都在使用dom4j来读写XML，特别值得一提的是连Sun的JAXM也在用dom4j。这是必须使用的jar包，Hibernate用它来读写配置文件。

odmg-3.0.jar
ODMG是一个ORM的规范，Hibernate实现了ODMG规范，这是一个核心的库，必须使用的jar包。

commons-collections-2.1.1.jar：
Apache Commons包中的一个，包含了一些Apache开发的集合类，功能比java.util.*强大。必须使用的jar包。

commons-beanutils.jar：
Apache Commons包中的一个，包含了一些Bean工具类类。必须使用的jar包。
*注：我没有在Hibernate的lib中看到这个包，不过在Struts中看到这个包，在网上查了一下，这个包提供了易用的java反射。我没有用这个包，也没有出问题（从这里看到的：http://www.blogjava.net/kobe09/archive/2006/06/14/52745.aspx ）

commons-lang-1.0.1.jar
Apache Commons包中的一个，包含了一些数据类型工具类，是java.lang.*的扩展。必须使用的jar包。

commons-logging-1.0.4.jar
Apache Commons包中的一个，包含了日志功能，必须使用的jar包。

从网上查到的，以上为必需的包

anant-1.5.3.jar
Ant编译工具的jar包，用来编译Hibernate源代码的。如果你不准备修改和编译Hibernate源代码，那么就没有什么用，可选的jar包

ant-optional-1.5.3.jar
Ant的一个辅助包。

c3p0-0.8.4.5.jar
C3PO是一个数据库连接池，Hibernate可以配置为使用C3PO连接池。如果你准备用这个连接池，就需要这个jar包。

proxool-0.8.3.jar
也是一个连接池，同上。

commons-pool-1.2.jar, commons-dbcp-1.2.1.jar
DBCP数据库连接池，Apache的Jakarta组织开发的，Tomcat4的连接池也是DBCP。

实际上Hibernate自己也实现了一个非常非常简单的数据库连接池，加上上面3个，你实际上可以在Hibernate上选择4种不同的数据库连接池，选择哪一个看个人的偏好，不过DBCP可能更通用一些。另外强调一点，如果在EJB中使用Hibernate，一定要用App Server的连接池，不要用以上4种连接池，否则容器管理事务不起作用。

connector.jar:
JCA 规范，如果你在App Server上把Hibernate配置为Connector的话，就需要这个jar。不过实际上一般App Server肯定会带上这个包，所以实际上是多余的包。

jaas.jar
JAAS是用来进行权限验证的，已经包含在JDK1.4里面了。所以实际上是多余的包。

jcs-1.0-dev.jar
如果你准备在Hibernate中使用JCS的话，那么必须包括它，否则就不用。

jdbc2_0-stdext.jar:
JDBC2.0的扩展包，一般来说数据库连接池会用上它。不过App Server都会带上，所以也是多余的。

jta.jar：
JTA规范，当Hibernate使用JTA的时候需要，不过App Server都会带上，所以也是多余的。

junit-3.8.1.jar
Junit包，当你运行Hibernate自带的测试代码的时候需要，否则就不用。

xalan-2.4.0.jar, xerces-2.4.0.jar, xml-apis.jar:
Xerces是XML解析器，Xalan是格式化器，xml-apis实际上是JAXP。一般App Server都会带上，JDK1.4也包含了解析器，不过不是Xerces，是Crimson，效率比较差，不过Hibernate用XML只不过是读取配置文件，性能没什么紧要的，所以也是多余的。