JFinal的任务调度cron4jPlugin源码

本文档详细介绍了JFinal插件Cron4jPlugin的源码,它是基于cron4j实现的任务调度器。Cron4jPlugin允许通过配置文件或Java代码来定义任务,使用cron表达式来调度任务执行。它支持Runnable、Task和ProcessTask类型的任务,提供了添加任务、启动和停止调度的方法。此外,还展示了如何通过ProcessTask调用系统程序。
/**
 * Copyright (c) 2011-2016, James Zhan 詹波 (jfinal@126.com).
 *
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at
 *
 *      http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 */
 
package com.jfinal.plugin.cron4j;
 
import it.sauronsoftware.cron4j.ProcessTask;
import it.sauronsoftware.cron4j.Scheduler;
import java.util.ArrayList;
import java.util.List;
import com.jfinal.kit.Prop;
import com.jfinal.kit.StrKit;
import com.jfinal.plugin.IPlugin;
import it.sauronsoftware.cron4j.Task;
 
/**
 * Cron4jPlugin 封装 cron4j,使用 cron 表达式调试 Task 执行
 *
 * cron 表达式由五部分组成:分 时 天 月 周
 * 分 :从 0 到 59
 * 时 :从 0 到 23
 * 天 :从 1 到 31,字母 L 可以表示月的最后一天
 * 月 :从 1 到 12,可以别名:jan", "feb", "mar", "apr", "may", "jun", "jul", "aug", "sep", "oct", "nov" and "dec"
 * 周 :从 0 到 6,0 表示周日,6 表示周六,可以使用别名: "sun", "mon", "tue", "wed", "thu", "fri" and "sat"
 *
 * 数字 n:表示一个具体的时间点,例如 5 * * * * 表示 5 分这个时间点时执行
 * 逗号 , :表示指定多个数值,例如 3,5 * * * * 表示 3 和 5 分这两个时间点执行
 * 减号 -:表示范围,例如 1-3 * * * * 表示 1 分、2 分再到 3 分这三个时间点执行
 * 星号 *:表示每一个时间点,例如 * * * * * 表示每分钟执行
 * 除号 /:表示指定一个值的增加幅度。例如 n/m表示从 n 开始,每次增加 m 的时间点执行
 *
 * 一、配置文件用法
 * cp = new Cron4jPlugin("cron4j.txt");
 * me.add(cp);
 *
 * 配置文件:
 * cron4j=task1, task2
 * task1.cron=* * * * *
 * task1.class=com.xxx.TaskAaa
 * task1.daemon=true
 * task1.enable=true
 *
 * task2.cron=* * * * *
 * task2.class=com.xxx.TaskBbb
 * task2.daemon=true
 * task2.enable=false
 *
 * cron4j 是所有配置的入口,用来配置有哪些 task 需要被调度,多个任务名称可用逗号分隔,例如上例中的 task1、task2
 * 后面的配置项均以 task1、task2 为前缀进行配置,具体意义如下
 * task1.cron 表示 task1 使用 cron 表达式调试任务
 * task1.cl
### 3.1 启用定时任务支持 在 Spring Boot 3 中,要启用定时任务功能,首先需要在主应用类或配置类上添加 `@EnableScheduling` 注解。该注解会激活基于注解的定时任务调度功能,使得 `@Scheduled` 注解的方法能够被调度执行[^5]。 ```java @SpringBootApplication @EnableScheduling public class SchedulerApplication { public static void main(String[] args) { SpringApplication.run(SchedulerApplication.class, args); } } ``` --- ### 3.2 使用 `@Scheduled` 注解实现定时任务 `@Scheduled` 注解可以用于标记方法为定时执行任务,支持固定延迟、固定频率、Cron 表达式等多种调度方式。以下是一个基于 `@Scheduled` 注解的完整示例: ```java @Component public class ScheduledTasks { private static final Logger logger = LoggerFactory.getLogger(ScheduledTasks.class); // 每5秒执行一次 @Scheduled(fixedRate = 5000) public void runFixedRateTask() { logger.info("执行固定频率任务 - {}", new Date()); } // 初始延迟2秒,之后每3秒执行一次 @Scheduled(fixedDelay = 3000, initialDelay = 2000) public void runFixedDelayTask() { logger.info("执行固定延迟任务 - {}", new Date()); } // 每天凌晨1点执行 @Scheduled(cron = "0 0 1 * * ?") public void runCronTask() { logger.info("执行Cron表达式任务 - {}", new Date()); } } ``` 上述代码展示了三种常见的调度方式:固定频率、固定延迟和基于 Cron 表达式的任务调度[^5]。 --- ### 3.3 动态定时任务实现 若需在运行时动态修改定时任务的执行周期,可以使用 `TaskScheduler` 或 `ScheduledExecutorService` 实现。以下是一个基于 `TaskScheduler` 的动态任务调度示例: ```java @Component public class DynamicTaskScheduler { private final TaskScheduler taskScheduler; public DynamicTaskScheduler(TaskScheduler taskScheduler) { this.taskScheduler = taskScheduler; } public void scheduleTask(Runnable task, long initialDelay, long period) { taskScheduler.scheduleAtFixedRate(task, initialDelay, period); } } ``` 通过注入 `TaskScheduler` 实例,可以动态地调度任务并更改执行周期,适用于需要运行时动态控制任务执行的场景[^3]。 --- ### 3.4 配置多线程任务执行 默认情况下,Spring 的任务调度使用单线程执行任务,可能导致任务阻塞。可以通过自定义 `TaskScheduler` 来启用多线程调度: ```java @Configuration public class SchedulerConfig implements SchedulingConfigurer { @Override public void configureTasks(ScheduledTaskRegistrar taskRegistrar) { taskRegistrar.setScheduler(Executors.newScheduledThreadPool(5)); // 设置5线程池 } } ``` 该配置将任务调度器设置为使用一个固定大小为 5 的线程池,从而支持并发执行多个定时任务[^4]。 --- ### 3.5 定时任务持久化与管理(进阶) 为了实现更高级的动态任务管理,例如从数据库加载任务配置或支持任务的启动与停止,可以结合 `@Scheduled` 和数据库存储的 Cron 表达式实现。以下是一个简化的任务管理服务示例: ```java @Service public class TaskManagementService { private final ScheduledTaskRegistrar taskRegistrar; private ScheduledFuture<?> scheduledFuture; public TaskManagementService(ScheduledTaskRegistrar taskRegistrar) { this.taskRegistrar = taskRegistrar; } public void startTask(String cronExpression) { scheduledFuture = taskRegistrar.getTaskScheduler().schedule(() -> { // 执行任务逻辑 System.out.println("动态任务执行 - " + new Date()); }, triggerContext -> { return new CronTrigger(cronExpression).nextExecutionTime(triggerContext); }); } public void stopTask() { if (scheduledFuture != null) { scheduledFuture.cancel(true); } } } ``` 此服务类允许通过传入不同的 Cron 表达式动态启动和停止任务,适用于需要外部配置管理的场景[^3]。 --- ###
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值