JDRing

 

突然想开发一个任务提醒软件用，所以广泛收集相关开源项目。所谓“他山之石，可以攻玉” ，顺便也读读开源代码，学习之。

开源一： JDRing

翻开JDRing的主页面【http://www.jtheory.com/jdring.html】，够简洁。大概说明了软件功能、实例、代码维护变迁以及源码下载。这几天颇为闲暇，翻译之，归纳如下：

1> 简介
JDRing是轻量级的JAVA工作调度工具。尽管设计简单且体积小，却能够支持指定间隔响铃(Alarm)提示、一次性提示或者像cron所支持的一样，实现复杂的工作调度。

2> 特性
Alarm在代码中中进行添加或者删除--没有涉及深入的文件格式或者是XML schema。只需要调用一个添加alarm的方法（并且指明你所定义的监听器）。你可以选择为每一个alarm设置一个名称，如此以来可以让众多alarm使用一个监听器。假如没有设置名称，那么JDRing自动为每一个alarm设置一个独有的名称。

Alarms可以被设置为一个固定的时间间隔（比如，每30分钟启动一次），或者只是一个固定的日期（如，2004年11月10号早上10点15分），再或者是cron-based的灵活工作计划。

通过cron风格的设置，可以设置分钟，小时，一个月中的某一天(号)，一周中的某一天(星期)，月份（或者使用"ALL"表明所有月份），于是在每一次匹配的时候都会提示。例如，你可以让Alarm在夏季月份的每个周一至周四的早上九点至下午两点每半个小时提示一次。那么可以这么设置：minutes: 0, 30; hours: 9,10,11,12,13,14; days of week: 1,2,3,4; days of month: all; months: 5,6,7.

对于时间的计数的标识也是和java.utils.Calendar类相一致的，即，分钟：0到59，小时：0到23，星期：1（周日）到7，日期：1到31（与月份相关）。而月份有些出乎意料，是从0（一月）到31（十二月）。

当星期与日期都按照cron风格设置完毕之后，每一次匹配Alarm都会提示。例如，按如下设置：minutes: 0; hours: 6; days of week: 2,3; days of month: 1,15; and months: all。Alarm将会在周一和周四的早上六点，以及每个月的1号和15号的时候提示。（当然，如果1号恰好也是周一，那么就只会提示一次）

所有的Alarm默认情况下都在一个线程中运行，因此在一个周期比较长的alarm将会延迟接下来的alarm直至完成。这或许是用户所期望的-因为alarm任务或许是相互依赖的。假如不是这样，任何一个alarm都可以被标记在一个不同的线程中运行，因此它将不会延误其它的alarm。

3> 维护变迁
JDRing 的原作者是Olivier Dedieu(其它的贡献者：David Sims, Simon Bécot, and Jim Lerner)，并且遵照LGPL license进行的发布。而现在发布的作者因需要修改了其中的bugs并且添加了一些想要的特性（包括重写scheduling代码以完全支持cron风格的灵活性）。而后该作者试图与原作者Olivier联系，但都杳无音信，并且原来的项目主页也消失了。现作者以为Olivier可能将兴趣转移到其它更好的项目上去了，因此，现在上庄扶持自己更改后的版本。
 
目前对于Java项目而言，有很多任务调度工具可以利用。比如大型的调度，工作流管理，文件监视等等，可以选择Flux【http://www.fluxcorp.com/】产品(实际上是由David Sims在开发完JDRing之后开发)。相比较而言，JDRing是一个十分简单、设计又非常紧凑的工具(jar文件只有24K)。提供了可以满足很多项目所需要的基本调度的特性与伸缩性，而且它是免费且开放源代码的。

4> 下载
JDRing 2.0版的下载地址(包含源代码)【http://www.jtheory.com/files/jdring-2.0.zip】

以下用一个小实例示意一下如何使用jDring来进行工作调度：（此例中的工作为println打印，可更换为其它需要在此时间点需要被触发的工作）

  import  java.util.Calendar;
import  java.util.Date;
import  java.util.List;
import  java.util.Iterator;

import  com.jtheory.jdring. * ;


public   class  jDringTest  ... {
  public static void main(String[] args) throws Exception ...{

    AlarmManager mgr = new AlarmManager();
    long current = System.currentTimeMillis();
    System.out.println("Current date is " + new Date(current));

    AlarmListener listener = new AlarmListener() ...{
      public void handleAlarm(AlarmEntry entry) ...{
       System.out.println("fixed date alarm : " + entry);
      }
    };

    
    // Date alarm
    mgr.addAlarm(new Date(current + (5 * 1000)), listener);
    mgr.addAlarm(new Date(current + (10 * 1000)), listener);

    System.out.println("Here are the registered alarms: ");
    System.out.println("----------------------------");
    List list = mgr.getAllAlarms();
    for(Iterator it = list.iterator(); it.hasNext();) ...{
      System.out.println("- " + it.next());
    }
    System.out.println("----------------------------");
  }
}