摘要：写这篇文章缘于昨天跟Linkin的一段聊天。我在使用ActiveRecord的一些技巧一文中的由实体类生成数据库表提到了这样一句话：生成数据库表时只有当该表不存在时ActiveRecord才会生成，否则表如果存在ActiveRecord不会做任何事情，也不会报任何错误。Linkin说他在实验时如果数据库表存在，ActiveRecord会删除表中的记录，其实这句话是在有些情况下是不对的，本篇文章将详细介绍Castle ActiveRecord中的Schema Pitfals。
主要内容
1
．引言
2
．CreateSchema和DropSchema
3
．CreateSchemaFromFile
4
．
GenerateCreationScripts
和GenerateDropScripts
一．引言
我在Castle ActiveRecord学习实践（9）：使用ActiveRecord的一些技巧一文中的由实体类生成数据库表提到了这样一句话：
生成数据库表时只有当该表不存在时
ActiveRecord
才会生成，否则表如果存在
ActiveRecord
不会做任何事情，也不会报任何错误
。
Linkin
说他在实验时如果数据库表存在，
ActiveRecord
会删除表中的记录，其实那句话是在有些情况下是不对的，通过后面的分析我们会看到。
Castle ActiveRecord
为我们提供了由实体类生成数据库表的方法，它其实在底层是封装了
NHibernate.Tool.hbm2ddl
中的SchemaExport，既创建数据库表的方法都是通过SchemaExport类来完成了，所有的这些方法都在ActiveRecordStarter中提供，列表如下：
|
方
法
|
示
例
|
|
CreateSchema()
|
ActiveRecordStarter.CreateSchema();
|
|
CreateSchemaFromFile()
|
ActiveRecordStarter.CreateSchemaFromFile("blog.sql");
|
|
DropSchema
()
|
ActiveRecordStarter.DropSchema();
|
|
GenerateDropScripts()
|
ActiveRecordStarter.GenerateDropScripts("blog.sql");
|
|
GenerateCreationScripts()
|
ActiveRecordStarter.GenerateCreationScripts("blog.sql");
|
二．
CreateSchema
和
DropSchema
CreateSchema
根据实体类来生成数据库表，在调用ActiveRecordStarter.CreateSchema()之后，我们来看一下ActiveRecord中执行了什么操作：
public
static
void
CreateSchema()
{
CheckInitialized(); foreach(Configuration config in ActiveRecordBase._holder.GetAllConfigurations())
{ SchemaExport export = CreateSchemaExport(config); try { export.Create( false, true );
} catch(Exception ex) { throw new ActiveRecordException( "Could not create the schema", ex ); } }
}
可以看到在
ActiveRecord中，仅仅是调用了
NHibernate中的
SchemaExport的
Create方法，并传递了两个参数分别为
fasle，
true。现在我们跟踪代码到
NHibernate中：
public
void
Create(
bool
script,
bool
export )
{ Execute( script, export, false, true );}
其中的
Execute实现如下，为了简单起见，我省略了部分代码：
public
void
Execute(
bool
script,
bool
export,
bool
justDrop,
bool
format )
{ IDbConnection connection = null; StreamWriter fileOutput = null; IConnectionProvider connectionProvider = null; IDbCommand statement = null; //
try { if( outputFile != null ) { fileOutput = new StreamWriter( outputFile ); } if( export ) { connectionProvider = ConnectionProviderFactory.NewConnectionProvider( props ); connection = connectionProvider.GetConnection(); statement = connection.CreateCommand(); } //格式化删除SQL脚本 //执行脚本 if( !justDrop ) { //格式化创建SQL脚本 //执行脚本 } } catch( HibernateException ) { throw; } finally { //. }}
从代码中我们可以看到，不管传入的参数如何，它都会执行删除脚本，然后判断，是否只删除而不创建，这样一来，用
CreateSchema来生成数据库表，如果表已经存在，它删除了已有的记录就是必然的了，也就是说执行这个方法，相当于执行了下面这样一段
SQL脚本：
if
exists
(
select
*
from
dbo.sysobjects
where
id
=
object_id
(N
'
Blogs
'
)
and
OBJECTPROPERTY
(id, N
'
IsUserTable
'
)
=
1
)
drop
table
Blogs
create
table
Blogs ( blog_id
INT
IDENTITY
NOT
NULL
, blog_name
NVARCHAR
(
255
)
null
, blog_author
NVARCHAR
(
255
)
null
,
primary
key
(blog_id))
同样
DropSchema也是这样，不过
justDrop为
True罢了，它其实就执行了下面这句话：
if
exists
(
select
*
from
dbo.sysobjects
where
id
=
object_id
(N
'
Blogs
'
)
and
OBJECTPROPERTY
(id, N
'
IsUserTable
'
)
=
1
)
drop
table
Blogs
这也就是说， “生成数据库表时只有当该表不存在时
ActiveRecord才会生成，否则表如果存在
ActiveRecord不会做任何事情，也不会报任何错误”在这种情况下是不对的，
ActiveRecord会删除已经存在的数据库表，并重新创建，这就会导致表中的数据丢失。
三．
CreateSchemaFromFile
CreateSchemaFromFile
方法用来执行一段已经存在的SQL脚本，基本用法如下：
ActiveRecordStarter.CreateSchemaFromFile("blog.sql")
与其它四个方法不同的是这个方法并没有使用NHibernate的任何操作，而是通过Castle ActiveRecord自己的ARSchemaCreator来实现的。
public
static
void
CreateSchemaFromFile(String scriptFileName)
{ CheckInitialized(); ARSchemaCreator arschema = new ARSchemaCreator( ActiveRecordBase._holder.GetConfiguration( typeof(ActiveRecordBase) ) ); arschema.Execute( scriptFileName );}
在
ARSchemaCreator
中，它会对SQL脚本进行分析，并通过IDbConnection，IDbCommand实现，看其中的一个方法：
public
static
void
ExecuteScriptParts(IDbConnection connection, String[] parts)
{ using(IDbCommand statement = connection.CreateCommand()) { foreach(String part in parts) { try { statement.CommandText = part; statement.CommandType = CommandType.Text; statement.ExecuteNonQuery(); } catch(Exception ex) { // Ignored, but we output it Debug.WriteLine(String.Format("SQL: {0} \r\nthrew {1}. Ignoring", part, ex.Message)); } } }}
创建数据库表的方法很简单，但是我们知道在查询分析器中，如果执行创建数据库表的
SQL脚本，这张表存在的话，它会报“数据库中已存在名为
'' 的对象”错误，那我们看上面这段代码
catch块中有这样一句注释和代码：
//
Ignored, but we output it
Debug.WriteLine(String.Format(
"
SQL: {0} \r\nthrew {1}. Ignoring
"
, part, ex.Message));
这就是说如果数据库中存在有Blogs这张表，我们再执行再通过CreateSchemaFromFile()方法来执行下面这段脚本，ActiveRecord将不做任何事情，并且不会报错：
create
table
Blogs ( blog_id
INT
IDENTITY
NOT
NULL
, blog_name
NVARCHAR
(
255
)
null
, blog_author
NVARCHAR
(
255
)
null
,
primary
key
(blog_id))
所以，前面那句话，应该是在使用
CreateSchemaFromFile()方法的情况有效。
四．
GenerateCreationScripts
和GenerateDropScripts
有时候，我们可以使用这两个方法来生成创建或者删除数据库表的SQL脚本，然后再利用
CreateSchemaFromFile()
使用这些脚本。这两个方法的使用很简单：
ActiveRecordStarter.GenerateDropScripts(
"
blog.sql
"
);ActiveRecordStarter.GenerateCreationScripts(
"
blog.sql
"
);
它也是调用了
NHibernate中的相应的方法，将会在当前应用程序目录下生成一个
blog.sql的脚本文件。
这篇文章就分析到这儿，最后特别要感谢Linkin，没有他提的问题，我也不会去深入的研究这其中的细节，在以后的文章中，我会更加认真的去对待每一个问题。
本文转自lihuijun51CTO博客，原文链接：
http://blog.51cto.com/terrylee/67668
，如需转载请自行联系原作者
