IAgileEngine从目前手上的DTS系统中不断的重构完善出来,虽然IAgileEngine已经不局限于在本DTS系统中使用,但是,我还是打算在这个系列文章中来介绍它。
正如,任何事物都有最简单的雏形,IAgileEngine也是一样。DTS系统最初的引擎也是一个非常简单的引擎,随着功能不断的加入、完善,我们不断地对其重构,使其满足新的需求。终于,它慢慢地成长,这种成长的结果也是我最初没有意料到的,它已经可以在任何有类似需求环境的引擎系统中使用。这是重构带来的好处,组件在重构中成长,正是因为重构,组件才会保持生命力和可用性--这是题外话了。
最初的引擎是一个单独的组件,由于功能不断的扩展、完善,这个组件变的巨大起来,不易维护和变动。于是,我尝试分解这个引擎组件,希望能将这单个组件分解成一系列小组件的组合,并且根据不同的组合,能够使引擎产生不一样的功能、特性。我把分解得到的小组件称为引擎环IEngineTache。
于是,我们已经大致可以看到这个IAgileEngine的外貌了。IAgileEngine由一系列可拆卸的引擎环(IEngineTache)组装而成,每个引擎环负责一个相对独立的任务。由多个引擎环组装IAgileEngine的过程可以是动态的,可以根据配置的需求、当前的环境来动态的决定采用哪些引擎环来构造引擎。
组装好的IAgileEngine就拥有了一个顺序的引擎环链,它们环环相扣。当引擎启动后,将按照组装的顺序逐个调用引擎环,如果某个引擎环执行失败,那么后续的引擎环将不再执行(除非有特殊需求的引擎环,后面我们将看到这种引擎环)。
我们先来看看引擎环IEngineTache的样子:
![](https://i-blog.csdnimg.cn/blog_migrate/f6df30f2b6238cbe26a490835f3fcbf0.jpeg)
IsActive属性用于表明当前引擎环是否处于执行状态;Title属性表明当前引擎环在执行的任务名称。MessagePublished事件是该引擎环通知给用户当前正在执行的需要用户了解的细节;IgnoredMessagePublished事件是该引擎环通知给用户当前正在执行的可以被用户忽略的细节;ProgressPublished事件表明了当前引擎环的执行进度。
Pause、Continue、Stop分别表示暂停、继续、停止的功能。而Excute方法将启动引擎环的执行。Excute方法签名如下:
bool
Excute(
out
string
failureCause);
如果引擎环执行失败,将返回false,并通过out参数failureCause说明失败的原因。
现在我们考虑这样一个问题,如果下游的引擎环需要用到上游引擎环提供的数据,该如何做了?答案是IEngineTacheUtil。这是一个公共的容器,提供许多插槽,上游的引擎环将数据存放到插槽中,下游的引擎环从对应的插槽中取数据。引擎环通过Initialize方法
来接收 IEngineTacheUtil引用。
下面是IEngineTacheUtil的类图:
![](https://i-blog.csdnimg.cn/blog_migrate/7d96d9286ee5082b49ee93c8a84c8657.jpeg)
在介绍完引擎环后,我们可以正式介绍IAgileEngine了:
![](https://i-blog.csdnimg.cn/blog_migrate/79774622ee308310b8d90735eca49eb1.jpeg)
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,则如果中间的引擎环执行失败,那么最后的一个引擎环也会被执行--这是常见的需求,我们经常在最后一个引擎环中做一些清理资源、写日志等后备工作。
{
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);
}
}
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();
}
{
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开发记录(序)