Scheduler (bus-all 5.6.5 API)

java.lang.Object
- org.aoju.bus.cron.Scheduler

public class Scheduler
extends Object

任务调度器

调度器启动流程：

 启动Timer =》 启动TaskLauncher =》 启动TaskExecutor

调度器关闭流程:

 关闭Timer =》 关闭所有运行中的TaskLauncher =》 关闭所有运行中的TaskExecutor

其中：

 TaskLauncher：定时器每分钟调用一次（如果isMatchSecond()为true每秒调用一次）,
 负责检查TaskTable是否有匹配到此时间运行的Task

 TaskExecutor：TaskLauncher匹配成功后,触发TaskExecutor执行具体的作业,执行完毕销毁

Since:: JDK 1.8+
Version:: 5.6.5
Author:: Kimi Liu

Field Summary

Fields
Modifier and Type	Field and Description
`protected boolean`	`daemon` 是否为守护线程
`protected ExecutorManager`	`executorManager` 执行器管理器
`protected LauncherManager`	`launcherManager` 启动器管理器
`protected TaskListenerManager`	`listenerManager` 监听管理器列表
`protected boolean`	`matchSecond` 是否支持秒匹配
`protected TaskTable`	`taskTable` 定时任务表
`protected ExecutorService`	`threadExecutor` 线程池

Constructor Summary

Constructors
Constructor and Description

Scheduler()

Constructors
Constructor and Description
`Scheduler()`

Method Summary

All Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`Scheduler`	`addListener(TaskListener listener)` 增加监听器
`Scheduler`	`clear()` 清空任务表
`Scheduler`	`deschedule(String id)` 移除Task
`CronPattern`	`getPattern(String id)` 获得指定id的`CronPattern`
`Task`	`getTask(String id)` 获得指定id的`Task`
`TimeZone`	`getTimeZone()` 获得时区,默认为 `TimeZone.getDefault()`
`boolean`	`isDeamon()` 是否为守护线程
`boolean`	`isEmpty()` 是否无任务
`boolean`	`isMatchSecond()` 是否支持秒匹配
`boolean`	`isStarted()`
`Scheduler`	`removeListener(TaskListener listener)` 移除监听器
`Scheduler`	`schedule(Setting cronSetting)` 批量加入配置文件中的定时任务配置文件格式为： xxx.xxx.xxx.Class.method = * * * * *
`Scheduler`	`schedule(String id, CronPattern pattern, Task task)` 新增Task
`String`	`schedule(String pattern, Runnable task)` 新增Task,使用随机UUID
`Scheduler`	`schedule(String id, String pattern, Runnable task)` 新增Task
`Scheduler`	`schedule(String id, String pattern, Task task)` 新增Task
`String`	`schedule(String pattern, Task task)` 新增Task,使用随机UUID
`Scheduler`	`setDaemon(boolean on)` 设置是否为守护线程如果为true,则在调用`stop()`方法后执行的定时任务立即结束,否则等待执行完毕才结束默认非守护线程
`Scheduler`	`setMatchSecond(boolean isMatchSecond)` 设置是否支持秒匹配,默认不使用
`Scheduler`	`setTimeZone(TimeZone timezone)` 设置时区
`int`	`size()` 当前任务数
`Scheduler`	`start()` 启动
`Scheduler`	`start(boolean isDeamon)` 启动
`Scheduler`	`stop()` 停止定时任务此方法调用后会将定时器进程立即结束,如果为守护线程模式,则正在执行的作业也会自动结束,否则作业线程将在执行完成后结束此方法并不会清除任务表中的任务,请调用`clear()` 方法清空任务或者使用`stop(boolean)`方法可选是否清空
`Scheduler`	`stop(boolean clearTasks)` 停止定时任务此方法调用后会将定时器进程立即结束,如果为守护线程模式,则正在执行的作业也会自动结束,否则作业线程将在执行完成后结束
`Scheduler`	`updatePattern(String id, CronPattern pattern)` 更新Task执行的时间规则

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Field Detail
  - matchSecond
```
protected boolean matchSecond
```
    是否支持秒匹配
  - daemon
```
protected boolean daemon
```
    是否为守护线程
  - taskTable
```
protected TaskTable taskTable
```
    定时任务表
  - launcherManager
```
protected LauncherManager launcherManager
```
    启动器管理器
  - executorManager
```
protected ExecutorManager executorManager
```
    执行器管理器
  - listenerManager
```
protected TaskListenerManager listenerManager
```
    监听管理器列表
  - threadExecutor
```
protected ExecutorService threadExecutor
```
    线程池
- Constructor Detail
  - Scheduler
```
public Scheduler()
```
- Method Detail
  - getTimeZone
```
public TimeZone getTimeZone()
```
    获得时区,默认为 TimeZone.getDefault()
    
    Returns:
    
    时区
  - setTimeZone
```
public Scheduler setTimeZone(TimeZone timezone)
```
    设置时区
    
    Parameters:
    
    timezone - 时区
    
    Returns:
    
    this
  - setDaemon
```
public Scheduler setDaemon(boolean on)
                    throws InstrumentException
```
    设置是否为守护线程如果为true,则在调用stop()方法后执行的定时任务立即结束,否则等待执行完毕才结束默认非守护线程
    
    Parameters:
    
    on - true为守护线程,否则非守护线程
    
    Returns:
    
    this
    
    Throws:
    
    InstrumentException - 定时任务已经启动抛出此异常
  - isDeamon
```
public boolean isDeamon()
```
    是否为守护线程
    
    Returns:
    
    是否为守护线程
  - isMatchSecond
```
public boolean isMatchSecond()
```
    是否支持秒匹配
    
    Returns:
    
    true使用,false不使用
  - setMatchSecond
```
public Scheduler setMatchSecond(boolean isMatchSecond)
```
    设置是否支持秒匹配,默认不使用
    
    Parameters:
    
    isMatchSecond - true支持,false不支持
    
    Returns:
    
    this
  - addListener
```
public Scheduler addListener(TaskListener listener)
```
    增加监听器
    
    Parameters:
    
    listener - TaskListener
    
    Returns:
    
    this
  - removeListener
```
public Scheduler removeListener(TaskListener listener)
```
    移除监听器
    
    Parameters:
    
    listener - TaskListener
    
    Returns:
    
    this
  - schedule
```
public Scheduler schedule(Setting cronSetting)
```
    批量加入配置文件中的定时任务配置文件格式为： xxx.xxx.xxx.Class.method = * * * * *
    
    Parameters:
    
    cronSetting - 定时任务设置文件
    
    Returns:
    
    this
  - schedule
```
public String schedule(String pattern,
                       Runnable task)
```
    新增Task,使用随机UUID
    
    Parameters:
    
    pattern - CronPattern对应的String表达式
    
    task - Runnable
    
    Returns:
    
    ID
  - schedule
```
public String schedule(String pattern,
                       Task task)
```
    新增Task,使用随机UUID
    
    Parameters:
    
    pattern - CronPattern对应的String表达式
    
    task - Task
    
    Returns:
    
    ID
  - schedule
```
public Scheduler schedule(String id,
                          String pattern,
                          Runnable task)
```
    新增Task
    
    Parameters:
    
    id - ID,为每一个Task定义一个ID
    
    pattern - CronPattern对应的String表达式
    
    task - Runnable
    
    Returns:
    
    this
  - schedule
```
public Scheduler schedule(String id,
                          String pattern,
                          Task task)
```
    新增Task
    
    Parameters:
    
    id - ID,为每一个Task定义一个ID
    
    pattern - CronPattern对应的String表达式
    
    task - Task
    
    Returns:
    
    this
  - schedule
```
public Scheduler schedule(String id,
                          CronPattern pattern,
                          Task task)
```
    新增Task
    
    Parameters:
    
    id - ID,为每一个Task定义一个ID
    
    pattern - CronPattern
    
    task - Task
    
    Returns:
    
    this
  - deschedule
```
public Scheduler deschedule(String id)
```
    移除Task
    
    Parameters:
    
    id - Task的ID
    
    Returns:
    
    this
  - updatePattern
```
public Scheduler updatePattern(String id,
                               CronPattern pattern)
```
    更新Task执行的时间规则
    
    Parameters:
    
    id - Task的ID
    
    pattern - CronPattern
    
    Returns:
    
    this
  - getPattern
```
public CronPattern getPattern(String id)
```
    获得指定id的CronPattern
    
    Parameters:
    
    id - ID
    
    Returns:
    
    CronPattern
    
    Since:
    
    3.1.1
  - getTask
```
public Task getTask(String id)
```
    获得指定id的Task
    
    Parameters:
    
    id - ID
    
    Returns:
    
    Task
    
    Since:
    
    3.1.1
  - isEmpty
```
public boolean isEmpty()
```
    是否无任务
    
    Returns:
    
    true表示无任务
  - size
```
public int size()
```
    当前任务数
    
    Returns:
    
    当前任务数
  - clear
```
public Scheduler clear()
```
    清空任务表
    
    Returns:
    
    this
  - isStarted
```
public boolean isStarted()
```
    Returns:
    
    是否已经启动
  - start
```
public Scheduler start(boolean isDeamon)
```
    启动
    
    Parameters:
    
    isDeamon - 是否以守护线程方式启动,如果为true,则在调用stop()方法后执行的定时任务立即结束,否则等待执行完毕才结束
    
    Returns:
    
    this
  - start
```
public Scheduler start()
```
    启动
    
    Returns:
    
    this
  - stop
```
public Scheduler stop()
```
    停止定时任务此方法调用后会将定时器进程立即结束,如果为守护线程模式,则正在执行的作业也会自动结束,否则作业线程将在执行完成后结束此方法并不会清除任务表中的任务,请调用clear() 方法清空任务或者使用stop(boolean)方法可选是否清空
    
    Returns:
    
    this
  - stop
```
public Scheduler stop(boolean clearTasks)
```
    停止定时任务此方法调用后会将定时器进程立即结束,如果为守护线程模式,则正在执行的作业也会自动结束,否则作业线程将在执行完成后结束
    
    Parameters:
    
    clearTasks - 标记
    
    Returns:
    
    this

Class Scheduler

Field Summary

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Field Detail

matchSecond

daemon

taskTable

launcherManager

executorManager

listenerManager

threadExecutor

Constructor Detail

Scheduler

Method Detail

getTimeZone

setTimeZone

setDaemon

isDeamon

isMatchSecond

setMatchSecond

addListener

removeListener

schedule

schedule

schedule

schedule

schedule

schedule

deschedule

updatePattern

getPattern

getTask

isEmpty

size

clear

isStarted

start

start

stop

stop