DTS开发记录（7）－－ 灵活的引擎 IAgileEngine

    数据引擎是数据传递系统（DTS）的核心，正如游戏引擎是PC游戏的核心一样。
    IAgileEngine从目前手上的DTS系统中不断的重构完善出来，虽然IAgileEngine已经不局限于在本DTS系统中使用，但是，我还是打算在这个系列文章中来介绍它。

    正如，任何事物都有最简单的雏形，IAgileEngine也是一样。DTS系统最初的引擎也是一个非常简单的引擎，随着功能不断的加入、完善，我们不断地对其重构，使其满足新的需求。终于，它慢慢地成长，这种成长的结果也是我最初没有意料到的，它已经可以在任何有类似需求环境的引擎系统中使用。这是重构带来的好处，组件在重构中成长，正是因为重构，组件才会保持生命力和可用性－－这是题外话了。

    最初的引擎是一个单独的组件，由于功能不断的扩展、完善，这个组件变的巨大起来，不易维护和变动。于是，我尝试分解这个引擎组件，希望能将这单个组件分解成一系列小组件的组合，并且根据不同的组合，能够使引擎产生不一样的功能、特性。我把分解得到的小组件称为引擎环IEngineTache。

    于是，我们已经大致可以看到这个IAgileEngine的外貌了。IAgileEngine由一系列可拆卸的引擎环（IEngineTache）组装而成，每个引擎环负责一个相对独立的任务。由多个引擎环组装IAgileEngine的过程可以是动态的，可以根据配置的需求、当前的环境来动态的决定采用哪些引擎环来构造引擎。

    组装好的IAgileEngine就拥有了一个顺序的引擎环链，它们环环相扣。当引擎启动后，将按照组装的顺序逐个调用引擎环，如果某个引擎环执行失败，那么后续的引擎环将不再执行（除非有特殊需求的引擎环，后面我们将看到这种引擎环）。

    我们先来看看引擎环IEngineTache的样子：


    IsActive属性用于表明当前引擎环是否处于执行状态;Title属性表明当前引擎环在执行的任务名称。MessagePublished事件是该引擎环通知给用户当前正在执行的需要用户了解的细节；IgnoredMessagePublished事件是该引擎环通知给用户当前正在执行的可以被用户忽略的细节；ProgressPublished事件表明了当前引擎环的执行进度。
    Pause、Continue、Stop分别表示暂停、继续、停止的功能。而Excute方法将启动引擎环的执行。Excute方法签名如下：

    bool  Excute( out   string  failureCause);

    如果引擎环执行失败，将返回false，并通过out参数failureCause说明失败的原因。

    现在我们考虑这样一个问题，如果下游的引擎环需要用到上游引擎环提供的数据，该如何做了？答案是IEngineTacheUtil。这是一个公共的容器，提供许多插槽，上游的引擎环将数据存放到插槽中，下游的引擎环从对应的插槽中取数据。引擎环通过Initialize方法
来接收 IEngineTacheUtil引用。
    下面是IEngineTacheUtil的类图：


    在介绍完引擎环后，我们可以正式介绍IAgileEngine了：

    PartProgressPublished事件即简单地传递了引擎环的ProgressPublished事件，MessagePublished事件和IgnoredMessagePublished事件也是简单地传递了引擎环的同名事件。TitleChanged事件在更替正在执行的引擎环时触发，它将即将进入执行状态的引擎环的Title属性发布给外界。当引擎执行过程中出现异常而失败时，触发TransferDisruptted事件，该事件参数说明了失败原因，这个原因就是前面提到的IEngineTache.Excute方法的out参数的值。

    另外，我们可以想到，实现IAgileEngine的组件也是实现IEngineTacheUtil接口的一个不错的选择。下面我们重点来关注IAgileEngine的实现AgileEngine组件的Initialize方法和Excute方法。
    下面是Initialize方法的实现：

         public   void  Initialize(IList < IEngineTache >  tacheList,  bool  has_NecceryEnder)
        {
             this .hasNecceryEnder  =  has_NecceryEnder;
             this .engineTacheList  =  tacheList;
             this .InitializeEventHandler();

             foreach  (IEngineTache tache  in   this .engineTacheList)
            {
                 // 传递IEngineTacheUtil引用
                tache.Initialize( this );
                
                 // 传递事件
                tache.IgnoredMessagePublished  +=   new  CbSimpleStr(tache_IgnoredMessagePublished);
                tache.ProgressPublished  +=   new  CbProgress(tache_ProgressPublished);
                tache.MessagePublished  +=   new  CbSimpleStr(tache_MessagePublished);               
            }
        }  

    这个方法中，我们要注意一下has_NecceryEnder参数，它用于表明引擎环链engineTacheList中的最后一个引擎环是否是必须要执行的，如果该参数为true，则如果中间的引擎环执行失败，那么最后的一个引擎环也会被执行－－这是常见的需求，我们经常在最后一个引擎环中做一些清理资源、写日志等后备工作。
    AgileEngine的Excute方法启动了一个线程来执行Worker方法：

         private   void  Worker()
        {
             string  failureCause  =   null ;
             for  ( int  i  =   0 ; i  <   this .engineTacheList.Count; i ++ )
            {               
                 this .currentTache  =   this .engineTacheList[i];

                 this .TitleChanged( this .currentTache.Title);

                 bool  excuteSucceed  =   this .currentTache.Excute( out  failureCause);

                 if  ( ! excuteSucceed)
                {
                     if  ( this .hasNecceryEnder  &&  (i  !=  ( this .engineTacheList.Count  -   1 )))
                    {
                         string  cause  =   null ;
                         this .currentTache  =   this .engineTacheList[ this .engineTacheList.Count - 1 ];
                         this .currentTache.Excute( out  cause);
                    }
                     this .TransferDisruptted(failureCause);
                     return ;
                }
            }           

             this .TransferCompleted();
        } 

    代码已经清晰地说明了一切，就不赘言了。

    通过上面的所有介绍，我们没有看到与DTS系统相关的任何东西，所以IAgileEngine是一个与应用无关的引擎，只要你的应用中的引擎需要作类似的引擎环分解，那么可以参考下IAgileEngine的作法。

    下面，我简单说说当前的DTS系统中的引擎包含哪些引擎环：
（1）DataEngineStarter 数据引擎启动器
（2）DataEngineReadyChecker 在数据传递之前进行全面检查
（3）DataEngineTransfer 执行主要的数据传递工作
（4）DataEngineDeleteIncrHandler 执行delete增量转移
（5）DataEngineEnder 数据引擎的最后执行环节

    后面的文章中将详细介绍这些引擎环。感谢你的关注！

转到：DTS开发记录（序）