循环引擎 ICycleEngine --ESBasic 可复用的.NET类库(04)

 1.缘起:

有些系统需要每隔一段时间就执行一下某个动作,比如,一个监控系统每隔10秒钟就要检测一下被监控对象的状态是否正常,那这时我们就可以用到循环引擎了。

    有人说可以使用.NET框架自带定时器如System.Threading.Timer,嗯,没错。但是若这个类使用不当可能会引发后台池线程耗尽的后果。因为Timer的定时事件触发实在后台线程池中的某个线程中处理的。也就是说Timer的每次定时事件触发都会用到一个线程,如果定时的时间间隔小于事件处理的时间,则后台线程池中将会有越来越多的线程被Timer使用掉,直至线程池中再无空闲的线程。

    而ESBasic.Threading.Engines.ICycleEngine的设计目标是永远都只使用一个线程。比如,它会隔10秒执行一个Action,执行完后再隔10秒再执行Action。间隔时间的等待与Action的执行都是在同一个线程中处理的。
    循环引擎的形象示意图如下:   

   

2.适用场合:

   根据上面的描述你应该已经看到了ICycleEngine与Timer之间的区别。由于Action的执行会占用额外的时间,所以ICycleEngine不适合于精确定时的任务。比如上面的例子,下一个Action开始的时刻与上一个Action开始的时刻的真正的时间差可能是12秒,而不是10秒,因为上一个Action的执行花费了2秒。

   所以,如果你的系统不需要精确的定时任务,而且又不想花费过多的精力去防范使用Timer时线程耗尽的窘境出现,那么ICycleEngine将是个不错的选择。
 

3.设计思想与实现

     ICycleEngine接口的源码如下:   

    /// <summary>
    /// ICycleEngine 在后台线程中进行间隔循环的引擎
    /// zhuweisky 2006.12.21
    /// </summary>
    public interface ICycleEngine
    {
        /// <summary>
        /// Start 启动后台引擎线程
        /// </summary>
        void Start();

        /// <summary>
        /// Stop 停止后台引擎线程,只有当线程安全退出后,该方法才返回
        /// </summary>
        void Stop();

        /// <summary>
        /// IsRunning 引擎是否运行中
        /// </summary>
        bool IsRunning { get; }

        /// <summary>
        /// DetectSpanInSecs 引擎进行轮询的间隔,DetectSpanInSecs=0,表示无间隙运作引擎;DetectSpanInSecs小于0则表示不使用引擎
        /// </summary>
        int DetectSpanInSecs { get;set; }

        /// <summary>
        /// OnEngineStopped 当引擎由运行变为停止状态时,将触发此事件。如果是异常停止,则事件参数为异常对象,否则,事件参数为null。
        /// </summary>
        event CbException OnEngineStopped;
    }

       
   如何实现这个接口了?

   由于不同的系统要求执行的Action不一样,所以,我们可以实现一个abstract基类BaseCycleEngine来保证循环引擎的正常运转,而派生类只要override基类的abstract方法DoDetect来执行自己的Action。

   关于BaseCycleEngine的实现要注意以下几点:

(1)循环引擎是在后台线程池的某个线程上运行的。

(2)循环引擎可以无限次的启动、停止、启动、停止……

(3)为了保证调用Stop方法时能迅速地停止引擎,我将间隔时间划分为多个BaseCycleEngine.SleepTime。而不是一次性地Sleep间隔时间。

(4)为了保证循环引擎真正停止后,才返回Stop方法的调用,我使用了ManualResetEvent来进行控制。

(5)DoDetect方法的返回值为false,则表示在该Action执行完后将停止循环引擎。此后,可以重新调用Start方法再次启动循环引擎。

 

4. 使用时的注意事项

(1)     要确保我们的Action(即派生类的DoDetect方法)不任何抛出异常,否则会导致循环引擎异常停止,并导致循环引擎的内部状态损坏而不可用。所以在派生类的DoDetect方法方法实现时捕捉所有的异常并加以处理。

(2)     在DoDetect方法实现中不能调用Stop方法,否则会导致死锁出现。

(3)     如果将DetectSpanInSecs设为0,则表示无间隙的执行DoDetect方法。而如果将DetectSpanInSecs设为负数,则表示不启动循环引擎。

(4)     当引擎已经启动并正在运行的过程中,如果要改变DetectSpanInSecs的值并使其生效,则必须重新启动(先调用Stop方法再调用Start方法)引擎才可。

 

5.扩展

(1)AgileCycleEngine

在上面的介绍中,我们都是以DoDetect方法来表示要执行的Action,而且我们必须以继承BaseCycleEngine的方式来使用循环引擎,这无疑限制了循环引擎的使用。

AgileCycleEngine的存在便是为了突破这个限制。

    public sealed class AgileCycleEngine :BaseCycleEngine
    {
        private IEngineActor engineActor;

        public AgileCycleEngine(IEngineActor _engineActor)
        {
            this.engineActor = _engineActor;
        }

        protected override bool DoDetect()
        {
            return this.engineActor.EngineAction();
        }
    }

 
    AgileCycleEngine继承自BaseCycleEngine,但是它是非abstract的。AgileCycleEngine通过组合而非继承的方式来使用循环引擎,我们可以将Action的执行者抽象为一个接口IEngineActor。

    public interface IEngineActor
    {
        /// <summary>
        /// EngineAction 执行引擎动作,返回false表示停止引擎。
        /// 注意,该方法不能抛出异常,否则会导致引擎停止运行(循环线程遭遇异常退出)。
        /// </summary>       
        bool EngineAction() ;
    }

通过实现IEngineActor来表明我们要执行的Action,然后将其注入到AgileCycleEngine中。

(2)永不停止的循环引擎

我们再考虑一个扩展的情况,假设我们的系统要求在启动时就将引擎运行起来,而且在整个运行的生命周期中,都不需要停止引擎,那么我们可能不想将Start方法、Stop方法暴露出来以免意外的调用Stop方法而导致引擎停止运行,那这个时候我们可以使用类似下面的技巧来做到:

    public sealed class MyCircleEngine : IEngineActor
    {
        private AgileCycleEngine agileCycleEngine;
        public void Initialize()
        {
            this.agileCycleEngine = new AgileCycleEngine(this);
            this.agileCycleEngine.DetectSpanInSecs = 10;
            this.agileCycleEngine.Start();
        }
        #region IEngineActor 成员
        public bool EngineAction()
        {
            // My Action
            return true;
        }
        #endregion
    }

用于示例的MyCycleEngine内部使用了AgileCycleEngine,但它没有暴露循环引擎的任何控制方法,而且Initialize方法表明MyCycleEngine只要一初始化便开始运行,而且没有办法让其停止运行。MyCycleEngine实现了IEngineActor接口,并把自己注入到AgileCycleEngine类型的成员中,于是引擎将每隔10秒钟执行一次MyCycleEngine的EngineAction方法。

注: ESBasic已经开源,点击这里下载源码。
   ESBasic开源前言

 

 

时间: 2024-10-27 13:54:06

循环引擎 ICycleEngine --ESBasic 可复用的.NET类库(04)的相关文章

工作者引擎 IWorkerEngine -- ESBasic 可复用的.NET类库(05)

1.缘起:     假设我们的系统在运行的过程中,源源不断的有新的任务需要处理(比如订单处理),而且这些任务的处理是相互独立的,没有前后顺序依赖性(顺序依赖性是指,必须在任务A处理结束后才可开始B任务),那么我们就可以使用多个线程来同时处理多个任务.每个处理任务的线程称为"工作者(线程)".      我设计了ESBasic.Threading.Engines.IWorkerEngine工作者引擎,其目的就是使用多个线程来并行处理任务,提高系统的吞吐能力.       工作者引擎的形象

循环任务切换器 CircleTaskSwitcher -- ESBasic 可复用的.NET类库(06)

 1.缘起:     假设我的订单处理系统有这样的需求:将一天24小时分为4个时段,凌晨2:15到8:30采用A类型的处理器处理接收到的订单,8:30到14:00采用B类型的处理器,14:00到20:00采用C类型的处理器,20:00到第二天凌晨2:15采用D类型的处理器.     即我们的订单处理器需要在任一天的2:15.8:30.14:00.20:00这四个时刻发生切换,这就是一个循环切换器所要做的工作.     我设计了ESBasic.Threading.Application. ICir

回调定时器ICallbackTimer --ESBasic 可复用的.NET类库(07)

 1.缘起:     举个例子也许就能够说清楚回调定时器的用途.假设我的订单系统接收各种不同类型的订单,当订单A进来时,系统根据订单的类型和其它特征进行综合判断后,决定A订单要在2秒之后被方法M1处理:接下来收到的B订单经过同样的判断后,决定要在10秒后被方法M2处理,--.这时候就可以用回调定时器来管理这些将要被延迟一定时间再执行的任务.     当然,我们可以使用定时器或前面介绍的循环引擎来实现这样的功能,只不过我们自己需要手动管理注册的定时回调任务,并且定时检查每一个未处理订单是否已经到了

心跳监测器 IHeartBeatChecker -- ESBasic 可复用的.NET类库(09)

1.缘起:     假设我们的C/S系统中服务端与客户端之间采用UDP进行通信,那么服务端如何知道每个客户端当前是否仍然在线了?有可能某个客户端一直没有退出,但是在很长一段时间内都没有与服务端作任何通信,那么服务端就应该认为这个客户端已经离线了吗?为了能让服务端掌握每个客户端是否在线的状态,我们可以这样做,只要客户端一启动起来,就每隔一段时间间隔(如10秒)就向服务端发一个"我还在线"的消息,以表明自己的状态.而服务端如果在一个更大的时间间隔内(如20秒)都没有收到某个客户端的任何消息

Round缓存管理器RoundCacheManager--ESBasic 可复用的.NET类库(26)

1.缘起:     在增量自动获取器章节的缘起部分,我们曾提到增量缓存,本节我们将深入探讨它以及用于管理增量缓存的管理器.我们还是以增量自动获取器章节提到的例子作为基础,并做更进一步的讨论.       OK,现在让我们开始这有趣的旅程. 首先,基于前面例子给出的上下文,我们知道IIncreaseAutoRetriever获取的增量是用于累积当天的已成交订单报表的."当天已成交报表"就是一个典型的增量缓存,每当有新的增量到来,都会累加到上面. 我们假设今天是2009.07.08,那么我

热缓存 IHotCache --ESBasic 可复用的.NET类库(19)

1.缘起:     假设我们有一个订单系统,现在这个系统要增加一个功能――允许客人查核他认为有问题的订单的详细信息.当客人觉得自己的某个订单不对劲时,他首先会从订单系统查询这个订单的详细信息,然后打电话告诉我们的客服有问题的订单的编号,客服再去查核,如果属实,客服还要进一步上报,如果该订单非常重要,则可能需要更进一步上报复查等.     从这个需求我们看到,同一个订单可能会在比较短的时间内查询数次甚至数十次,所以我们可以称这个订单为"热点"订单.而其它的成千上万的订单可能在一个月内都不

定时刷新缓存管理器 IRefreshableCacheManager --ESBasic 可复用的.NET类库(16)

1.缘起:     为了提升系统的性能或减轻数据库的压力等原因,我们经常在系统中使用缓存来把那些经常使用的数据保留在内存中.如果因为某些原因,缓存中这些经常使用的数据不能及时与数据源进行同步更新,那么采用定时刷新缓存中的数据有可能就是一种合适的选择.     如果你的缓存是定时刷新,那么你就需要自己为其维护一个定时器或循环引擎.如果你的系统中像这样定时刷新的缓存有多个,而且每个缓存定时刷新的时间间隔又要求不一样,那么,使这些缓存按照你预想的情况进行运转,你就需要花费一些气力.     我设计了定

时刻 ShortTime --ESBasic 可复用的.NET类库(01)

          (如果您能对照着源码来阅读本文,效果会更好.) 1.缘起:        假设我们的员工打卡系统,需要设定公司规定的上班时间.下班时间.以及还要对员工是否迟到早退等这些情况进行判断.        我们以什么方式来记录类似上下班时间这样只有时分秒没有年月日的时间了?你说可以使用DateTime,但是合适吗?总是觉得用DateTime来表示上下班的时间很别扭,因为我们的上下班时间并需要指定到具体的哪一天啊.        我设计了ESBasic.ShortTime来对类似上下班

ESBasic 可复用的.NET类库(00) -- 开源前言(附下载)

自从03年正式使用.NET开发以来,已经走过了6个年头,这期间我积累了几套类库和框架,ESBasic便是其中最基础的一个类库.ESBasic是Enterprise Service Basic的缩写,虽然也简写为ESB,但是它和Enterprise Service Bus(企业服务总线)没有任何关系.ESBasic是我能够快速和高效开发应用程序的利器之一,开这个专门的blog是想将它介绍给大家,希望能对大家有所启发. ESBasic覆盖的内容包括:对象管理.插件.网络(Socket).多线程.Em