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开发记录（序）