Class CronUtil

java.lang.Object
com.sure.tool.cron.CronUtil

public class CronUtil extends Object
Cron 定时调度器:注册表达式任务,启动后每秒扫描并在匹配时刻执行,参考 Hutool 的 CronUtil 设计。

调度线程每秒检查一次;任务执行在虚拟线程(JDK 21+ 虚拟线程池),互不阻塞。 同一秒内同一任务只执行一次(秒级精度)。

English: Cron expression parsing and scheduling helpers.

Since:
0.1.0
Author:
suretool
  • Method Details

    • isValid

      public static boolean isValid(String cron)
      校验 Cron 表达式是否合法。
      Parameters:
      cron - 表达式
      Returns:
      是否合法
    • parse

      public static CronPattern parse(String cron)
      解析 Cron 表达式。
      Parameters:
      cron - 表达式
      Returns:
      表达式对象
    • schedule

      public static void schedule(String cron, Runnable task)
      注册定时任务(调度器未启动时注册,start() 后生效)。
      Parameters:
      cron - 6 段表达式
      task - 任务
    • getJobCount

      public static int getJobCount()
      已注册任务数。
      Returns:
      任务数
    • start

      public static void start()
      启动调度(幂等)。
    • stop

      public static void stop()
      停止调度并清空任务(幂等)。
    • nextTimeAfter

      public static Date nextTimeAfter(String cron, Date date)
      计算表达式在指定时间之后的下一次执行时间。
      Parameters:
      cron - 表达式
      date - 基准时间
      Returns:
      下次执行时间;无匹配返回 null
    • match

      public static boolean match(String cron, Date date)
      判断表达式是否匹配指定时间。
      Parameters:
      cron - 表达式
      date - 时间
      Returns:
      是否匹配