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

 

        (如果您能对照着源码来阅读本文,效果会更好。)

1.缘起:

       假设我们的员工打卡系统,需要设定公司规定的上班时间、下班时间、以及还要对员工是否迟到早退等这些情况进行判断。

       我们以什么方式来记录类似上下班时间这样只有时分秒没有年月日的时间了?你说可以使用DateTime,但是合适吗?总是觉得用DateTime来表示上下班的时间很别扭,因为我们的上下班时间并需要指定到具体的哪一天啊。

       我设计了ESBasic.ShortTime来对类似上下班时间的概念进行抽象。ShortTime只有时分秒三个必需的属性,不必再牵扯到日期。

       ShortTime的形象示意图如下:


Hour


Minute


Second

 

2.适用场合:

       任何只需要使用时分秒来表示时刻的场合。

 

3.设计思想与实现

       ShortTime的设计与实现都是相当简单的,其类图如下:        
       
       ShortTime有Hour、Minute、Second三个属性,Hour采用24小时制,取值范围为0~23,Minute和Second的取值范围都是0~59。如果在设置这些属性的值超过了其自身的取值范围,属性的set方法会自动将其修正到正确的值。

       ShortTime实现了IComparable泛型接口,表示ShortTime对象之间可以相互比较。ShortTime所表示的时刻的值越大,则ShortTime就越大,这是完全一致的。

       ShortTime是可序列化的,表示可以通过Remoting进行远程传递。

       ShortTime提供了一个非常有用的方法IsOnTime,用于判断是否到了指定的时刻。该方法接受两个参数:target和maxToleranceInSecs,target即是与当前对象进行比较的目标,maxToleranceInSecs表示认为当前对象与target所表示的时间是同一时刻所允许的最大误差(单位为秒)。比如,maxToleranceInSecs取值为3秒,那么22:15:00与22:15:02就被认为是同一时刻,IsOnTime方法将返回true。

 

4. 使用时的注意事项

(1)ShortTime的精度只能到秒,不能记录毫秒、微秒等更小的精度。

(2)IsOnTime方法的maxToleranceInSecs参数的取值是由我们的系统需求所能允许的最大时刻误差来决定了。比如,你的轮询引擎是每隔5秒钟检测一次是否到了指定的时刻,那么在这种情况下maxToleranceInSecs参数就应该设置为5,而不是更大或更小。

 

5.扩展

       我们可以将表示上班时间的ShortTime对象和表示下班时间的ShortTime对象组合成一个ShortTimeScope对象,用于表示工作时间。

          ESBasic. ShortTimeScope用来表示一个时间范围,当然,这个范围的最大长度为24小时(更准确的应该是23小时59分59秒),也就是说,ShortTimeScope不能表示跨天的时间段。

       如果我们要判断某一时刻是否在ShortTimeScope指定的时间范围内,可以调用ShortTimeScope的Contains方法。

          ShortTimeScope对象之间很难进行比较大小,但是可以比较是否相等,所以ShortTimeScope实现了“==”操作符。

       另外,在我们后面介绍的CircleTaskSwitcher(循环任务切换器),它的实现也用到了本节讲到的ShortTime。

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

 

时间: 2024-10-12 12:13:11

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

循环任务切换器 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

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

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

定时任务管理器 TimingTaskManager -- ESBasic 可复用的.NET类库(08)

1.缘起:     假设我们的报表系统需要在每天的00:05:00统计前一天的报表数据,需要在每周一的00:30:00统计上周的报表数据,又需要在每月1日的00:30:00统计上月的报表数据. 这些报表统计任务是很常见的系统需求,对于类似这样的在指定时刻执行的定时任务,我使用ESBasic.Threading.Timers.TimingTaskManager(定时任务管理器)来处理它. TimingTaskManager与前面讲的回调定时器CallbackTimer的区别在于,CallbackT

日期 Date--ESBasic 可复用的.NET类库(02)

  1.缘起:     同我们从DateTime中将时刻部分作为ShortTime抽离出来一样,我们将DateTime中的日期部分也抽离出来,以ESBasic.Date类来表示.     比如,我们的报表系统是以"天"为单位来进行统计的,为了提高效率,我们会在每天凌晨将前一天的报表数据统计完毕,并存储到数据库中,一天的报表数据就对应数据库数据库中的一条记录,该记录以一个表示日期的整数而不是DateTime作为主键.比如主键值为20090501的表示这条记录对应的是2009年5月1日的报

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

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

优先级管理器 IPriorityManager -- ESBasic 可复用的.NET类库(14)

1.缘起:     假设我们的订单处理系统所要处理的订单是有优先级的,也就是说,不同的订单类型所要求被处理的紧迫程度不同,对那些优先级高的注单要先处理,对于优先级低的注单可稍后处理.对于处于同一优先级的订单了,就按照其到达的先后顺序进行处理.     这是一个典型的管理具有优先级的对象的需求,注单就是具有优先级(With Priority)的对象.我设计了ESBasic.ObjectManagement.Managers.IPriorityManager优先级管理器(确切地说,应该称之为"具有优

片段整合提取器 ScatteredSegmentPicker -- ESBasic 可复用的.NET类库(21)

1.缘起:     当数据源中的数据量多到一定程度时,我们在查询时就经常使用分页策略.如果数据源是一个完整的整体,这没有什么大不了的,我们经常就在做类似的事情.但是,如果数据源不是一个完整的整体,而是由很多有序的片段构成的,并且不同的片段可能位于不同的位置(比如,位于不同的服务器节点上的内存中),甚至,每个片段内的数据还会随着时间的变化而变化的.     在这种假设的情况下,来从这个"虚拟的完整"数据源获取某个分页就不再是那么简单的事情了.一个分页可能位于一个片段的内部的某个区间,也有

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

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

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

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