在经历地震的日子里，我曾同朋友（一个脚板不触及地面的超凡脱俗的女子）争辩一个问题“有多少人真心关注这灾难？”。我们达成一致: 是这样的人，再过两三个月，还能主动提及这灾难，主动帮助受灾的人们。基于这结论，朋友很悲观，因大多数人的猎奇心态而哀叹。说实话，我也认为这样的人很少。但是不能够因此在道义层面对人们做出评判。对于个体而言，一个事件所能激发的关注度取决于其体验和记忆与这事件的关联度。我们没有在家乡亲身经历这灾难，但感同身受，夜不能眠，是因为电视里、报纸上、网络中不断闪现的是自己熟悉的地名、人名，甚而面孔。他们的每一次出现，都会唤起一份记忆或是一次体验，刺激一次神经。如果没有这些关联的记忆和体验，你甚至没有去过这些地方，没有听说这地名，那刺激只能来源于那些平时难得一见的画面。在年初雪灾中，我们都没有捐款，忘却的也很快。 

     我很兴奋，午夜来敲入这段文字，是因为我的朋友中有这样的人: 时隔两三月，仍关切这灾难，且慷慨相助。虽然当时在MSN上有很多朋友激情加入，但在推进一加一的时候我很仍很惶恐，担忧这援助活动给朋友带来道德和信义的考验，我谨慎的选择在地震一个月后还主动询问的朋友。经历过一些尴尬，沙去金现，今夜，又有两个孩子得到了三年的学费援助。我相信，所有参与的人们是快乐的。我，尤其快乐！因为我有过几乎失去教育机会的体验，因为这些优秀的孩子很有可能因此而改变人生的轨迹，更是因为我交到了这些值得交往的朋友，他们甚至和这事件没有太多的关联度。快哉！乐哉！

偶然获知其老版依然免费，心里痒痒，再次尝试。感觉CC的帮助写得不够完善，就来涂一篇。

配置CC项目

1 通过NCover调用NUnit做测试，就不需要在项目中其他地方再做一次了。NCover将在baseDirectory中生成Coverage.xml文件。

    <exec executable="D:\Studio\tools\NCover\NCover.console.exe" 
            baseDirectory="D:\studio\" 
            buildArgs="D:\Studio\tools\nunit\nunit-console.exe /noshadow D:\studio\tests\bin\Release\MyTest.dll /xml:D:\studio\nunit-results.xml" />

2 接下来基于Coverage.xml生成NCoverExplore报告(CoverageReport.xml)：

    <exec executable="D:\Studio\tools\NCover\NCoverExplorer.Console.exe" 
        baseDirectory="D:\studio\" 
        buildArgs="/x /r:4" />
    </tasks>    

3 将NUnit、NCover和NCoverExplore的输出文件合并到本次集成的日志中（注意: merge节必须放在xmllogger之前）：

<publishers>
    <merge>
        <files>
            <file>D:\studio\nunit-results.xml</file>
            <file>D:\studio\Coverage.xml</file>
            <file>D:\studio\CoverageReport.xml</file>
        </files>
    </merge>            
    <xmllogger logDir="log" />
</publishers>        

配置Web DashBoard

1 在编译的总报告中加入NCoverSummary和NCoverExplorerSummary

    <buildReportBuildPlugin>
    <xslFileNames>
     <xslFile>xsl\header.xsl</xslFile>
     <xslFile>xsl\modifications.xsl</xslFile>
     <xslFile>xsl\compile.xsl</xslFile>
     <xslFile>xsl\compile-msbuild.xsl</xslFile>
     <xslFile>xsl\unittests.xsl</xslFile>
     <xslFile>xsl\fxcop-summary.xsl</xslFile>
     <xslFile>xsl\NCoverSummary.xsl</xslFile>
     <xslFile>xsl\NCoverExplorerSummary.xsl</xslFile>
     <xslFile>xsl\SimianSummary.xsl</xslFile>
    </xslFileNames>
   </buildReportBuildPlugin>  

  其输出如图：

<?xml version="1.0" encoding="UTF-8"?> 
<databaseChangeLog
  xmlns="http://www.liquibase.org/xml/ns/dbchangelog/1.6"
  xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
  xsi:schemaLocation="http://www.liquibase.org/xml/ns/dbchangelog/1.6
         http://www.liquibase.org/xml/ns/dbchangelog/dbchangelog-1.6.xsd">
 
    <changeSet id="1" author="bob">
        <createTable tableName="department">
            <column name="id" type="int">
                <constraints primaryKey="true" nullable="false"/>
            </column>
            <column name="name" type="varchar(50)">
                <constraints nullable="false"/>
            </column>
            <column name="active" type="boolean" defaultValue="1"/>
        </createTable>
    </changeSet> 
</databaseChangeLog>

       其中，changeSet包含不同的数据库变化，几乎涵盖了所有的数据库变化类型，具体支持的类型要看API，我这里给几个例子：
       *  创建和删除表、视图、存储过程、主键、外键、索引等
       *  重命名表、视图、列等
       *  加入列缺省值、唯一约束、非空约束等
       *  合并两个列
       *  在一个表的数据的基础上创建一个字典表
       
       除此之外，Liquibase还允许你运行自己的Sql脚本、执行Shell程序。
       之所以所说”几乎涵盖“，是因为目前我发现不支持用户自定义数据和自定义函数的。由于在我新的数据库开发原则中摒弃了对他们的依赖，所以也不痛苦。

Liquibase在持续集成中的应用

      如果你基于Java开发，你可能会更喜欢Liquibase，如果基于Ruby On Rails开发，你可能会选择Migration 和 Rake。我基于.Net，考察过Red Gate($),Migration.Net, Machine.Migrations,Power Tools等等，最终还是选择了Liquibase。如何整合到我的开发流程中来，我选择命令行以及基于命令行的MsBuild任务。
      用命令行搞一个bat文件执行Liquibase，用户数据库部署（见我例子中的deploy.bat)。
      Msbuild提供比较、部署、文档生成等等全套功能，用于开发的全过程，当然也用于CC.Net（见例子中的ci.proj)。
      
      具体的应用包括：
      * 开发人员在本地完成一个阶段的开发后，使用ci.proj中的diff target比较本地数据和基线数据，产生changelog.xml，提交到SVN（这里，XML文件中的changeSet中的Author取开发人员本地机器的用户名）
      * CC.Net检测到SVN的变化，触发持续集成过程，调用ci.proj中的deploy在一个测试数据库中创建最新的数据结构，然后对实体类和访问层进行测试（开发人员在本地机器的测试亦如此）。测试成功，使用ci.proj中的doc生成文档，发布在持续集成服务器的IIS中。
      * 如果是trunk项目则在测试完成后需要在SVN上打Tag，然后使用ci.proj中的publish发布数据库部署升级程序（含changelog.xml)
      * 发布的数据库部署升级程序中含deploy.bat给部署人员用以部署或升级现有的产品系统数据库。
     
      关于changelog.xml的合并：
      * 每一次开发人员有新的changelog.xml提交，我会通过SVN的Merge功能将其新的changeSet合并
      * 这个过程可以通过SVN自动完成，但鉴于数据库的变化影响面太大，需要谨慎审核，因此还是选择手工来做
     
      关于test.proj： 这是用MsBuild写的一个测试案例，测试ci.proj提供的数据库比较和升级功能。      

      关于ci.proj的说明:
      * 对dtproperties的特殊处理
         一旦你使用过Sql Server的企业管理器操作过数据库，会自动生成这个表存一些数据库对象的属性。虽然在企业管理器中显示为系统表，但它的object_id很大，使得liquibase将其看做用户表，会影响数据库比较结果，因此在ci.proj中会检查参与比较的两个数据是否存在该表，如果不存在则创建它。
      * <Target Name="CheckExec">
        MsBuild使用Java命令行调用liquibase，如果执行出错，MsBuild不能得到该错误，这样将导致CC.Net的持续集成在失败时报成功。没有找到更好的办法，我将执行Java得到的输出写入exec.log文件，然后用CheckExec检查其中是否有Failed关键字。可能还有其他的关键字需要检查，如果园友发现还请告诉我。

<Target Name="CheckExec">
    <ReadLinesFromFile File="$(ExecLog)" >
        <Output TaskParameter="Lines" PropertyName="ExecOutput"/>
    </ReadLinesFromFile>
    <Message Text="$(ExecOutput)" Importance="high"/>
    <StringComparison Comparison="Contains" Param1="$(ExecOutput)" Param2="Failed" >
        <Output TaskParameter="Result" PropertyName="StringSearchResult"/>
    </StringComparison>
    <Delete Files="$(ExecLog)"/>
    <Error Text="liquibase report error" Condition="$(StringSearchResult)"/>
</Target>

1 表列

如果你的列名是数据库的保留字，在Property中用"`"声明列名

[Property("`User`")]
public String User
{
    get { return _user; }
    set { _user = value; }
}

不要使用Status做列名，它是NHibernate的保留字，否则ActiveRecord会抛异常：Ambiguous column name 'Status'
可以使用枚举作为列的类型，在数据库中将创建整数类型的列

2 对象保存到数据库的时机

只有在会话Flush()或事务Commit()的时候，对象才存入数据库
自动保存
 * 当session.Find()被调用 
 * 当Filter()被调用 
 * 自动保存需要session.FlushMode为Auto（缺省值）

3 对象关系

* 不支持在非主键上建立关系
3.1 BelongsTo
* 表现多对一的关系
* ActiveRecord将为该关系建立数据库表的外键
* 如“用户”相对于“部门", 在“用户”实体类上申明 
3.2 HasMany
* 表现一对多的关系
* ActiveRecord将为该关系建立数据库表的外键
* 如“部门”相对于“用户", 在“部门”实体类上申明

3.3 HasAndBelongsToMany
* 表现多对多的关系
* ActiveRecord将为创建一个关联表
* 如允许一个用户有多个角色的情况下的“用户”和“角色”
3.4 OneToOne
* 表现一对一的关系
* 两个实体(数据库表)拥有相同的数据库表主键，从表实体需将主键类型申明为PrimaryKeyType.Foreign
* 如“用户”和“用户地址”
3.5 Any 和 HasManyToAny
* 用于表示不确定一对多关系
* 如：“设备视频端口”可能保存多种设备(DVR/Matrix/DVS)的端口信息

[ActiveRecord()]
public class DeviceDvr : ActiveRecordBase, IVideoDeivce
{  }

[ActiveRecord()]
public class DeviceDvs : ActiveRecordBase, IVideoDeivce
{  }

[Any(typeof(Guid), MetaType=typeof(string),TypeColumn="DeviceType",IdColumn="DeviceGuid",Cascade=CascadeEnum.SaveUpdate)]
public IVideoDeivce VideoDeivce 
{
    get {  } 
    set {  } 
}

4 实体类继承

4.1 单表继承

 * 所有父子实体类都保存在一个数据库表中
 * “字典”、“设备类型字典”和“设备故障字典”

    /* 使用Type列来标示该行数据归属的字典类型 */
    [ActiveRecord(DiscriminatorColumn = "Type", DiscriminatorType = "String", DiscriminatorValue = "none")]
    public class Dictionary : ActiveRecordBase<Dictionary>
    {  }

    [ActiveRecord(DiscriminatorValue = "device_type")]
    public class DictionaryDeviceType : Dictionary

    [ActiveRecord(DiscriminatorValue = "device_failure")]
    public class DictionaryDeviceFailure : Dictionary

4.2  类表继承

 * 所有父子实体类各拥有一张数据库表，由基类生成主键
 * 如： “汽车”、“跑车”和“房车”

5 嵌套的数据 Nested data

 * 支持用一个非数据库表的数据对象表现数据库表的一个或多个列的集合
 * 如：“用户”、“单位”和“地址”，用户和单位表中都有地址信息，地址类只是多个列的集合
 * 表现数据库中的一个列是，也可用于定义用户自定义数据，以实现数据库的用户定义数据类型 
   。 如此可统一各个实体类中相同含义的列的格式定义（Sql数据类型、长度、格式验证等等）
   。 如：Emai地址、电话号码

6 延迟加载Lazy load

 * 延迟加载确保数据只在需要时才从数据库中加载，如“用户”对象中的“部门”在加载“用户”对象时不会被加载
 * 如此启用实体的延迟加载： [ActiveRecord(Lazy=true)]
 * 除了BelongTo，其他所有关系缺省的都未启用延迟加载

7 数据验证

• ActiveRecord提供数据验证器对列数据进行规则验证
• 验证器在数据库操作(insert,update)之前对数据格式进行验证
• 实体类需从ActiveRecordValidationBase继承
• 数据验证器包括：
  • ValidateIsUnique 检查列值在表中唯一
  • ValidateRegExp 使用正则表达式验证列数据格式
  • ValidateEmail 验证列数据为EMail地址格式
  • ValidateNonEmpty 验证列数据非空
  • ValidateConfirmation 验证两个属性相同，如密码和密码确认
• 可继承AbstractValidationAttribut来实现自定义验证器

数据分页

• Query

• SliceFindAll

     SystemUser[] users = SystemUser.SlicedFindAll(30, 10, null,new ICriterion[] { Expression.Eq("State", SystemUser.UserState.Valid) });

NHibernate用户自定义数据类型

• 用于在单列中存储更复杂的数据信息（如列表），并以对象的形式来表现
• 应用场景：不想单独使用一个表来存储这些复杂的数据信息的时候
• 如：设备报警的端口列表可能为多个，可以将他们存在一个数据库列中,格式如"2,3,5"
• 表现该列的对象需实现NHibernate的IUserType接口，如public class DeiveAlarmPorts:List<int>,IUserType
• 如此在DeviceAlarm类中声明属性

        [Property("AlarmPorts", "ActiveRecordEntities.Alarm,ActiveRecordEntities")]

        public DeiveAlarmPorts AlarmPorts { get {...} set {...}}

引用和链接

ActiveRecord Official Document     自定义数据类型

使用领域驱动设计方法(Domain Driven Design)开发数据库,以面向对象的设计方法设计数据库表，具体方法包括：

• 直接设计数据库实体类，然后使用ActiveRecord创建数据库表
• 数据库表的一切属性（列类型、长度、约束、索引，表间关系等全部在实体类中设计）
• 数据库访问层基于实体类实现，业务逻辑优先选择数据库访问层通过代码实现，除此之外的在存储过程中实现

2 数据库开发架构

• 每个数据库开发人员必须在本地数据库实例上进行设计、编码和测试
• 持续集成服务器通过监视SVN服务器上用户提交行为触发持续集成过程，在基线数据库上验证、部署新的数据库结构
• 持续集成数据库上的基线数据库
  • 其结构（包含数据库静态数据）为当前已发布系统的结构
  • 只有持续集成过程能够修改基线数据库
  • 开发人员只能通过持续集成过程来修改该数据库
  • 开发人员可将基线数据库视为产品数据库，可通过将其与本地数据库进行比较得到数据库部署脚本

3 数据库开发流程

3.1 本地开发流程

• 所有设计和测试都在本地数据库上进行
• 每一个访问层函数和较为复杂的实体类（如含外键关系）应有测试案例，必须通过测试
• 数据库部署脚本的生成
  • 在有多人设计数据库时需注意及时获取SVN上部署脚本在本地执行，与基线数据库保持一致
  • 使用liquibase对比本地数据库和基线数据库，生成部署脚本
  • 注意：已发布的数据库部署脚本不可更改

3.2 持续集成流程
3.2.1 Trunk流程

• 此流程先升级基线数据库GTCA，然后在基线数据库上做持续集成（以保证新的程序集和升级脚本兼容以发布的产品系统）
• 上图中任一流程发生错误都导致持续集成失败，数据库回滚到集成前的状态
• 通过数据库文档可查看所有数据库结构修改日志

3.2.2 Studio流程

• 此流程通过创建临时数据库GTCATest，开展测试工作

4 编码原则

• 放弃使用Sql Server的domain,rule,default等（rule和default在2005中不被支持）
• 使用ActiveRecord的Nested Data替代domain
• 通过对Nested Data所进行ActiveRecord定义实现rule和default
• 谨慎使用视图和存储过程

考量我目前的新系统开发，这个方法和流程还是可行的，估计在实践中还会有很多问题出现，希望发现问题的园友不吝赐教。

Update 20080620 关于liquibase,请参见数据库开发的持续集成 - Liquibase的简介和应用
Update 20080625 根据实际应用的情况，修正了一下流程, 并发布数据库的持续集成-CruiseControl.Net的配置
     主要的修正在于考虑测试代码在本地，持续集成服务器上的Studio项目和Trunk项目中都能够使用，且满足下列要求
     * Trunk项目中测试代码直接在升级后的基线数据库上测试（以保证新发布的代码和脚本在兼容已发布的产品数据库），因此不允许修改数据库结构
     * Studio项目在测试数据库上测试

    上回说到了数据库开发的持续集成的总的意图，提供一个数据库部署和升级的工具，接下来说说如何进行数据库比较。

    在我的开发中数据库比较工具主要需要两种形式： 桌面工具和MsBuid任务。

    桌面工具推荐开源的DaBCoS3，基本够用,有朋友推荐直接用VS2005，但我比较喜欢小巧一点的东东，因为不仅仅在数据库开发的时候用。

    MsBuild任务很重要，在持续集成的时候可用来验证升级脚本是否正常工作。在CC.Net中加入SqlDeply任务（MsBuild），对产品系统数据库的副本进行升级，然后使用MsBuild数据库比较任务比较升级后的结构与开发数据库是否相同。以此来验证升级脚本，相当于对升级脚本做自动测试（当然还有回归测试），可大大节约人力。
    在网上搜寻一大圈，发现Red Gate提供的程序集不错，但要$，放弃。绕了一大圈，回到M$，PowerTools被选中。要先装Team Edition for Database。

    数据结构比较的MsBuild任务如此例：

<Project DefaultTargets="SchemaCompare" xmlns="http://schemas.microsoft.com/developer/msbuild/2003">
    <UsingTask TaskName="SqlSchemaCompareTask" AssemblyName="Microsoft.VisualStudio.TeamSystem.Data.PowerTools.Tasks, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a"/>

    <PropertyGroup>
    <UpdateSql/>
    </PropertyGroup>

    <Target Name ="SchemaCompare">
    <SqlSchemaCompareTask
        SourceConnectionString="server=product;user id=sa;password=mypass"
        SourceDatabaseName="Northwind"
        TargetConnectionString="Data Source=.;Integrated Security=True;Pooling=False"
        TargetDatabaseName="Northwind"
        OutputPath= "."
        OutputFileName = "update.sql"

        ForceColumnOrder="true"
        IgnoreExtendedProperties="true"
        IgnoreStatistics="true" 
        IgnoreConstraintNames="true"
        IgnoreQuotedIdentifiersAndAnsiNullSettings="true"
        IgnoreTriggerOrder="true"
        IgnoreUsers="true"
        IgnoreWhiteSpace="true"

        DoNotOutputCommentHeader="true"
        NoTransactionalChangeScript="true"
        SkipSETStatements="true"
        ScriptCollationWhenDifferentFromDefault="true"
        />    

    <ReadLinesFromFile File="update.sql">
        <Output TaskParameter="Lines" PropertyName="UpdateSql" />
    </ReadLinesFromFile>    

    <!-- NOTE: If update.sql is emtpy, the two databases are same -->
    <Message Text="$(UpdateSql)" Condition="'$(UpdateSql)' != ''" />
    <Error Text="Soure database is different from the target" Condition="'$(UpdateSql)' != ''" />
    </Target>
</Project>

<Project DefaultTargets="DataCompare" xmlns="http://schemas.microsoft.com/developer/msbuild/2003">
    <UsingTask TaskName="SqlDataCompareTask" AssemblyName="Microsoft.VisualStudio.TeamSystem.Data.PowerTools.Tasks, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a"/>

    <Target Name ="DataCompare">
    <SqlDataCompareTask
        SourceConnectionString="server=product;user id=sa;password=mypass"
        SourceDatabaseName="Northwind"
        TargetConnectionString="Data Source=.;Integrated Security=True;Pooling=False"
        TargetDatabaseName="Northwind"
        OutputPath = "."
        OutputFileName = "TestDataCompare.sql"

        TrimTrailingSpaces="true"

        DisableTriggers="true"
        DisableKeys="false"
        DoNotOutputCommentHeader="true"
        DoNotUseTransactions="true" />
    </Target>
</Project>