NHibernate之旅(20)：再探SchemaExport工具使用
2008-11-13 18:33 李永京 阅读(...) 评论(...) 编辑 收藏本节内容
- 引入
- 实例分析
- 1.表及其约束
- 2.存储过程、视图
- 结语
引入
上篇我们初步探索了SchemaExport工具使用，知道如何使用SchemaExport工具和SchemaUpdate工具利用NHibernate持久化类和映射文件删除、创建、更新数据库架构，这篇具体分析如何为表字段增加一些约束？如何生成存储过程？如何生成视图？使用SchemaExport工具帮你搞定。
实例分析
1.表及其约束
众所周知，SchemaExport工具根据映射文件来生成数据库架构，在映射文件中通过Class映射可以很方便的生成数据库表。但是这篇我们看看映射的条件，所以我重新定义两个实体CategorySchema和ProductSchema，一对多关系。
Step1：两个实体持久化类编写代码如下：
public class CategorySchema { public virtual Guid Id { get; set; } public virtual string Name { get; set; } } public class ProductSchema { public virtual Guid Id { get; set; } public virtual string Name { get; set; } public virtual int UnitsOnStock { get; set; } public virtual CategorySchema CategorySchema { get; set; } }
Step2：为两个实体映射，使用最简方式，编写代码如下：
xml version="1.0" encoding="utf-8" ?>
<hibernate-mapping xmlns="urn:nhibernate-mapping-2.2"
assembly="DomainModel" namespace="DomainModel">
<class name="DomainModel.Entities.CategorySchema,DomainModel">
<id name="Id">
<generator class="guid"/>
id>
<property name="Name"/>
class>
<class name="DomainModel.Entities.ProductSchema,DomainModel">
<id name="Id">
<generator class="guid"/>
id>
<property name="Name"/>
<many-to-one name="CategorySchema"
class="DomainModel.Entities.CategorySchema,DomainModel"/>
class>
hibernate-mapping>
Step3：编写测试用例用于生成数据库架构：
[Test] public void ExecuteSchemaTest() { var export = new SchemaExport(_cfg); export.Execute(true, true, false, true); }
Step4：测试！NHibernate生成语句如下：
if exists (select 1 from sys.objects where object_id = OBJECT_ID(N'[FK45BBFB51BC9515A6]') AND parent_object_id = OBJECT_ID('ProductSchema')) alter table ProductSchema drop constraint FK45BBFB51BC9515A6 if exists (select * from dbo.sysobjects where id = object_id(N'ProductSchema') and OBJECTPROPERTY(id, N'IsUserTable') = 1) drop table ProductSchema if exists (select * from dbo.sysobjects where id = object_id(N'CategorySchema') and OBJECTPROPERTY(id, N'IsUserTable') = 1) drop table CategorySchema create table ProductSchema ( Id UNIQUEIDENTIFIER not null, Name NVARCHAR(255) null, CategorySchema UNIQUEIDENTIFIER null, primary key (Id) ) create table CategorySchema ( Id UNIQUEIDENTIFIER not null, Name NVARCHAR(255) null, primary key (Id) ) alter table ProductSchema add constraint FK45BBFB51BC9515A6 foreign key (CategorySchema) references CategorySchema
仔细看看生成的语句，都按默认的值生成了表，Name列字符串类型NVARCHAR(255)，默认为null；外键默认一数字字符串等。
1.设置非空类型和长度
在映射文件中为ProductSchema实体的Name属性添加：not-null="true"表示非空类型，length="50"：列长度设置为50，代码片段如下：
<property name="Name" not-null="true" length="50"/>
测试，生成语句如下：
create table ProductSchema ( Id UNIQUEIDENTIFIER not null, Name NVARCHAR(50) not null, CategorySchema UNIQUEIDENTIFIER null, primary key (Id) )
2.设置外键Foreign Keys
在映射文件设置外键名称，注意有的需要两边都要设置才生效，代码片段如下：
<many-to-one name="CategorySchema" class="DomainModel.Entities.CategorySchema,DomainModel" foreign-key="FK_Product_Category"/>
生成语句如下：
if exists (select 1 from sys.objects where object_id = OBJECT_ID(N'[FK_Product_Category]') AND parent_object_id = OBJECT_ID('ProductSchema')) alter table ProductSchema drop constraint FK_Product_Category ... alter table ProductSchema add constraint FK_Product_Category foreign key (CategorySchema) references CategorySchema
3.设置Unique约束
我们要求Name字段唯一，添加Unique约束，代码片段如下：
<property name="Name" not-null="true" length="50" unique="true"/>
生成语句如下：
create table ProductSchema ( Id UNIQUEIDENTIFIER not null, Name NVARCHAR(50) not null unique, CategorySchema UNIQUEIDENTIFIER null, primary key (Id) )
还有一种unique-key约束，同时为两个属性设置unique-key约束。我们为Customer持久化类的FirstName和LastName属性添加Unique约束：
编写映射，设置FirstName和LastName的Unique约束为UK_Person_Name：
<property name="FirstName" not-null="true" length="50" unique-key="UK_Customer_Name"/> <property name="LastName" not-null="true" length="50" unique-key="UK_Customer_Name"/>
生成语句如下：
create table Customer( CustomerId INT IDENTITY not null, FirstName NVARCHAR(50) not null, LastName NVARCHAR(50) not null, primary key (CustomerId), unique (FirstName, LastName) )
4.设置索引Index
<property name="Name" not-null="true" length="50" unique="true" index="IDX_Product_Name" />
生成语句如下：
create table ProductSchema (Id UNIQUEIDENTIFIER...) create table CategorySchema (Id UNIQUEIDENTIFIER...) create index IDX_Product_Name on ProductSchema (Name)
5.设置Check约束
我们为UnitsOnStock值设置大于等于0：
<property name="UnitsOnStock" not-null="true" > <column name="UnitsOnStock" check="UnitsOnStock >= 0"/> property>
生成语句如下：
create table ProductSchema ( Id UNIQUEIDENTIFIER not null, Name NVARCHAR(50) not null unique, UnitsOnStock INT null check( UnitsOnStock >= 0) , CategorySchema UNIQUEIDENTIFIER null, primary key (Id) )
好了，还有很多设置大家自己探索啦！知道了这些我们在写映射的时候就注意啦！我之前映射文件属性映射为什么写的比较全呢？就是这个原因，便于生成数据库架构是自己约束的并不是默认的。
2.存储过程、视图
除了表，我们还有存储过程和视图。怎么利用SchemaExport工具生成存储过程和视图呢？在映射文件中提供了database-object元素用来创建和删除数据库对象。
<database-object> <create>创建存储过程或视图语句等数据库对象create> <drop>删除存储过程或视图语句等数据库对象drop> database-object>
1.存储过程
还记得我们在NHibernate之旅(17)：探索NHibernate中使用存储过程(下)中创建的三个存储过程了吗？当时我们在数据库中手写创建的啊。现在完全可以不用那种古老的方法啦。我们在映射文件中编写database-object：在创建数据库架构时创建名为entitySProcs的存储过程，在删除数据库架构时删除名为entitySProcs的存储过程。现在使用SchemaExport工具不仅仅生成了表，还生成了存储过程。还剩两个存储过程就留给大家去完成吧。
<database-object> <create> CREATE PROCEDURE entitySProcs AS SELECT CustomerId,Version,Firstname,Lastname FROM Customer create> <drop> DROP PROCEDURE entitySProcs drop> database-object>
2.视图
还记得我们在NHibernate之旅(14)：探索NHibernate中使用视图中创建了第一个视图了吗？那时我们也是在数据库中手动创建的，现在我们可以自动创建了！打开CustomerView.hbm.xml文件，添加database-object：在创建数据库架构时创建名为viewCustomer的视图，在删除数据库架构时删除名为viewCustomer的视图。
<database-object> <create> CREATE VIEW [dbo].[viewCustomer] AS SELECT DISTINCT c.CustomerId, c.Firstname, c.Lastname, o.OrderId, o.OrderDate FROM dbo.Customer AS c INNER JOIN dbo.[Order] AS o ON c.CustomerId = o.OrderId INNER JOIN dbo.OrderProduct AS op ON o.OrderId = op.[Order] INNER JOIN dbo.Product AS p ON op.Product = p.ProductId GROUP BY c.CustomerId, c.Firstname, c.Lastname, o.OrderId, o.OrderDate create> <drop>drop view dbo.viewCustomerdrop> database-object>
测试生成数据库架构，出现错误“数据库中已存在名为'viewCustomer'的对象”。这是什么原因呢？看看NHibernate生成语句：
create table viewCustomer ( CustomerId INT IDENTITY NOT NULL, Firstname NVARCHAR(255) null, Lastname NVARCHAR(255) null, OrderId INT null, OrderDate DATETIME null, primary key (CustomerId) )
观察NHibernate生成SQL语句发现NHibernate利用Class映射自动生成了viewCustomer表，因为NHibernate见到Class映射就认为是表，它不知道这里映射的是视图，视图和表在映射文件中没有什么区别。我们修改一下这个映射文件，在database-object元素上面再添加一个database-object用于删除NHibernate生成的表。
<database-object> <create>drop table dbo.viewCustomercreate> <drop>drop table dbo.viewCustomerdrop> database-object>
这个database-object的意思就是在创建数据库架构时删除NHibernate自动生成的表viewCustomer，在删除数据库架构时删除表viewCustomer。为什么删除两次呢？因为我们有可能只Drop，那么NHibernate就执行database-object中的Drop。
这样在CustomerView.hbm.xml文件中就有两个database-object了，总体的意思就是在创建数据库架构时删除NHibernate自动生成的表viewCustomer并创建名为viewCustomer的视图，在删除数据库架构时删除名为viewCustomer表和名为viewCustomer的视图。
结语
好了，终于把SchemaExport工具研究透彻了，应该没有说漏别的东西，就到这里了。下面看看NHibernate对象去，什么状态啦，缓存啦。
本系列链接：NHibernate之旅系列文章导航
NHibernate Q&A- 欢迎加入NHibernate中文社区，一起讨论NHibernate知识！
- 请到NHibernate中文社区下载本系列相关源码。
下次继续分享NHibernate！