cn.hutool.cron.pattern.parser.PatternParser Maven / Gradle / Ivy
package cn.hutool.cron.pattern.parser;
import cn.hutool.core.lang.Assert;
import cn.hutool.core.util.StrUtil;
import cn.hutool.cron.CronException;
import cn.hutool.cron.pattern.Part;
import cn.hutool.cron.pattern.matcher.AlwaysTrueMatcher;
import cn.hutool.cron.pattern.matcher.PartMatcher;
import cn.hutool.cron.pattern.matcher.PatternMatcher;
import java.util.ArrayList;
import java.util.List;
/**
* 定时任务表达式解析器，用于将表达式字符串解析为{@link PatternMatcher}的列表
*
* @author looly
* @since 5.8.0
*/
public class PatternParser {
private static final PartParser SECOND_VALUE_PARSER = PartParser.of(Part.SECOND);
private static final PartParser MINUTE_VALUE_PARSER = PartParser.of(Part.MINUTE);
private static final PartParser HOUR_VALUE_PARSER = PartParser.of(Part.HOUR);
private static final PartParser DAY_OF_MONTH_VALUE_PARSER = PartParser.of(Part.DAY_OF_MONTH);
private static final PartParser MONTH_VALUE_PARSER = PartParser.of(Part.MONTH);
private static final PartParser DAY_OF_WEEK_VALUE_PARSER = PartParser.of(Part.DAY_OF_WEEK);
private static final PartParser YEAR_VALUE_PARSER = PartParser.of(Part.YEAR);
/**
* 解析表达式到匹配列表中
*
* @param cronPattern 复合表达式
* @return {@link List}
*/
public static List parse(String cronPattern) {
return parseGroupPattern(cronPattern);
}
/**
* 解析复合任务表达式，格式为：
*
* cronA | cronB | ...
*
*
* @param groupPattern 复合表达式
* @return {@link List}
*/
private static List parseGroupPattern(String groupPattern) {
final List patternList = StrUtil.splitTrim(groupPattern, '|');
final List patternMatchers = new ArrayList<>(patternList.size());
for (String pattern : patternList) {
patternMatchers.add(parseSingle(pattern));
}
return patternMatchers;
}
/**
* 解析单一定时任务表达式
*
* @param pattern 表达式
* @return {@link PatternMatcher}
*/
private static PatternMatcher parseSingle(String pattern) {
final String[] parts = pattern.split("\\s+");
Assert.checkBetween(parts.length, 5, 7,
() -> new CronException("Pattern [{}] is invalid, it must be 5-7 parts!", pattern));
// 偏移量用于兼容Quartz表达式，当表达式有6或7项时，第一项为秒
int offset = 0;
if (parts.length == 6 || parts.length == 7) {
offset = 1;
}
// 秒，如果不支持秒的表达式，则第一位赋值0，表示整分匹配
final String secondPart = (1 == offset) ? parts[0] : "0";
// 年
PartMatcher yearMatcher;
if (parts.length == 7) {// 支持年的表达式
yearMatcher = YEAR_VALUE_PARSER.parse(parts[6]);
} else {// 不支持年的表达式，全部匹配
yearMatcher = AlwaysTrueMatcher.INSTANCE;
}
return new PatternMatcher(
// 秒
SECOND_VALUE_PARSER.parse(secondPart),
// 分
MINUTE_VALUE_PARSER.parse(parts[offset]),
// 时
HOUR_VALUE_PARSER.parse(parts[1 + offset]),
// 天
DAY_OF_MONTH_VALUE_PARSER.parse(parts[2 + offset]),
// 月
MONTH_VALUE_PARSER.parse(parts[3 + offset]),
// 周
DAY_OF_WEEK_VALUE_PARSER.parse(parts[4 + offset]),
// 年
yearMatcher
);
}
}