org.dromara.hutool.cron.TaskExecutorManager Maven / Gradle / Ivy
/*
* Copyright (c) 2013-2024 Hutool Team and hutool.cn
*
* 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 org.dromara.hutool.cron;
import org.dromara.hutool.cron.task.CronTask;
import org.dromara.hutool.cron.task.Task;
import java.io.Serializable;
import java.util.ArrayList;
import java.util.Collections;
import java.util.List;
/**
* 作业执行管理器
* 负责管理作业的启动、停止等
*
*
* 此类用于管理正在运行的作业情况，作业启动后加入任务列表，任务结束移除
*
*
* @author Looly
* @since 3.0.1
*/
public class TaskExecutorManager implements Serializable {
private static final long serialVersionUID = 1L;
protected Scheduler scheduler;
/**
* 执行器列表
*/
private final List executors = new ArrayList<>();
/**
* 构造
*
* @param scheduler {@link Scheduler}
*/
public TaskExecutorManager(final Scheduler scheduler) {
this.scheduler = scheduler;
}
/**
* 获取所有正在执行的任务调度执行器
*
* @return 任务执行器列表
* @since 4.6.7
*/
public List getExecutors() {
return Collections.unmodifiableList(this.executors);
}
/**
* 启动 执行器TaskExecutor，即启动作业
*
* @param task {@link Task}
* @return {@link TaskExecutor}
*/
public TaskExecutor spawnExecutor(final CronTask task) {
final TaskExecutor executor = new TaskExecutor(this.scheduler, task);
synchronized (this.executors) {
this.executors.add(executor);
}
this.scheduler.threadExecutor.execute(executor);
return executor;
}
/**
* 执行器执行完毕调用此方法，将执行器从执行器列表移除，此方法由{@link TaskExecutor}对象调用，用于通知管理器自身已完成执行
*
* @param executor 执行器 {@link TaskExecutor}
* @return this
*/
public TaskExecutorManager notifyExecutorCompleted(final TaskExecutor executor) {
synchronized (executors) {
executors.remove(executor);
}
return this;
}
}