NHibernate使用教程(20):深入解析SchemaExport工具操作方法?

2026-05-25 07:502阅读0评论SEO问题
  • 内容介绍
  • 文章标签
  • 相关推荐

本文共计1994个文字,预计阅读时间需要8分钟。

NHibernate使用教程(20):深入解析SchemaExport工具操作方法?

本节内容+引入+实例分析+1. 表及其约束+2. 存储过程、视图+结语+引入+上节我们初步探索了SchemaExport工具的使用,了解了如何利用SchemaExport工具和SchemaUpdate工具通过NHibernate实现类持久化和映射文件生成。

本节内容

  • 引入
  • 实例分析
    • 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

在映射文件设置外键名称,注意有的需要两边都要设置才生效,代码片段如下:

NHibernate使用教程(20):深入解析SchemaExport工具操作方法?

<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.viewCustomer</drop> </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.viewCustomer</create> <drop>drop table dbo.viewCustomer</drop> </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!

本文共计1994个文字,预计阅读时间需要8分钟。

NHibernate使用教程(20):深入解析SchemaExport工具操作方法?

本节内容+引入+实例分析+1. 表及其约束+2. 存储过程、视图+结语+引入+上节我们初步探索了SchemaExport工具的使用,了解了如何利用SchemaExport工具和SchemaUpdate工具通过NHibernate实现类持久化和映射文件生成。

本节内容

  • 引入
  • 实例分析
    • 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

在映射文件设置外键名称,注意有的需要两边都要设置才生效,代码片段如下:

NHibernate使用教程(20):深入解析SchemaExport工具操作方法?

<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.viewCustomer</drop> </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.viewCustomer</create> <drop>drop table dbo.viewCustomer</drop> </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!