1. 完成 Job 的 CRUD 功能

src/main/java/cn/iocoder/dashboard/framework/mybatis/core/mapper/BaseMapperX.java

@@ -28,4 +28,8 @@ public interface BaseMapperX<T> extends BaseMapper<T> {
         return selectList(new QueryWrapper<>());
     }
 
+    default T selectOne(String field, Object value) {
+        return selectOne(new QueryWrapper<T>().eq(field, value));
+    }
+
 }

src/main/java/cn/iocoder/dashboard/framework/quartz/core/scheduler/SchedulerManager.java

@@ -7,6 +7,12 @@ import org.quartz.*;
 /**
  * {@link org.quartz.Scheduler} 的管理器，负责创建任务
  *
+ * 考虑到实现的简洁性，我们使用 jobHandlerName 作为唯一标识，即：
+ * 1. Job 的 {@link JobDetail#getKey()}
+ * 2. Trigger 的 {@link Trigger#getKey()}
+ *
+ * 另外，jobHandlerName 对应到 Spring Bean 的名字，直接调用
+ *
  * @author 芋道源码
  */
 public class SchedulerManager {
@@ -17,6 +23,15 @@ public class SchedulerManager {
         this.scheduler = scheduler;
     }
 
+    /**
+     * 添加 Job 到 Quartz 中
+     *
+     * @param jobId 任务编号
+     * @param jobHandlerName 任务处理器的名字
+     * @param jobHandlerParam 任务处理器的参数
+     * @param cronExpression CRON 表达式
+     * @throws SchedulerException 添加异常
+     */
     public void addJob(Long jobId, String jobHandlerName, String jobHandlerParam, String cronExpression)
             throws SchedulerException {
         // 创建 JobDetail 对象
@@ -30,6 +45,14 @@ public class SchedulerManager {
         scheduler.scheduleJob(jobDetail, trigger);
     }
 
+    /**
+     * 更新 Job 到 Quartz
+     *
+     * @param jobHandlerName 任务处理器的名字
+     * @param jobHandlerParam 任务处理器的参数
+     * @param cronExpression CRON 表达式
+     * @throws SchedulerException 更新异常
+     */
     public void updateJob(String jobHandlerName, String jobHandlerParam, String cronExpression)
             throws SchedulerException {
         // 创建新 Trigger 对象
@@ -38,19 +61,45 @@ public class SchedulerManager {
         scheduler.rescheduleJob(new TriggerKey(jobHandlerName), newTrigger);
     }
 
+    /**
+     * 删除 Quartz 中的 Job
+     *
+     * @param jobHandlerName 任务处理器的名字
+     * @throws SchedulerException 删除异常
+     */
     public void deleteJob(String jobHandlerName) throws SchedulerException {
         scheduler.deleteJob(new JobKey(jobHandlerName));
     }
 
+    /**
+     * 暂停 Quartz 中的 Job
+     *
+     * @param jobHandlerName 任务处理器的名字
+     * @throws SchedulerException 暂停异常
+     */
     public void pauseJob(String jobHandlerName) throws SchedulerException {
         scheduler.pauseJob(new JobKey(jobHandlerName));
     }
 
+    /**
+     * 启动 Quartz 中的 Job
+     *
+     * @param jobHandlerName 任务处理器的名字
+     * @throws SchedulerException 启动异常
+     */
     public void resumeJob(String jobHandlerName) throws SchedulerException {
         scheduler.resumeJob(new JobKey(jobHandlerName));
         scheduler.resumeTrigger(new TriggerKey(jobHandlerName));
     }
 
+    /**
+     * 立即触发一次 Quartz 中的 Job
+     *
+     * @param jobId 任务编号
+     * @param jobHandlerName 任务处理器的名字
+     * @param jobHandlerParam 任务处理器的参数
+     * @throws SchedulerException 触发异常
+     */
     public void triggerJob(Long jobId, String jobHandlerName, String jobHandlerParam)
             throws SchedulerException {
         JobDataMap data = new JobDataMap();

src/main/java/cn/iocoder/dashboard/framework/quartz/core/util/CronUtils.java

@@ -0,0 +1,22 @@
+package cn.iocoder.dashboard.framework.quartz.core.util;
+
+import org.quartz.CronExpression;
+
+/**
+ * Quartz Cron 表达式的工具类
+ *
+ * @author 芋道源码
+ */
+public class CronUtils {
+
+    /**
+     * 校验 CRON 表达式是否有效
+     *
+     * @param cronExpression CRON 表达式
+     * @return 是否有效
+     */
+    public static boolean isValid(String cronExpression) {
+        return CronExpression.isValidExpression(cronExpression);
+    }
+
+}