定時任務使用指南

如果你想做定時任務，有高可用方面的需求，或者僅僅想入門快，上手簡單，那麼選用它準沒錯。

定時任務模組是對Quartz框架進一步封裝，使用更加簡潔。

1、引入依賴

<dependency>
    <groupId>xin.altitude.cms</groupId>
    <artifactId>ucode-cms-quartz</artifactId>
    <version>1.5.4.1</version>
</dependency>

2、快速上手

實現org.quartz.Job

啟動專案，定時任務便處於監聽與執行中。

@Component
@DisallowConcurrentExecution
@CronExp(cron = "0/5 * * * * ?")
public class DemoJob implements Job {
    @Override
    public void execute(JobExecutionContext context) {
        System.out.println("任務1：" + LocalDateTime.now());
    }
}
 

3、手動觸發定時任務

定時任務除了以既有頻率週期性執行外，還有通過介面手動被觸發的能力。

呼叫如下介面，可手動觸發任務ID編號為jobId的任務。

http://localhost:8080/cms-api/quartz/job/{jobId}

如果有手動觸發定時任務的需求，則需要任務ID唯一併且已知，因此需要在編寫定時任務時手動指定。

@CronExp(id = 1, cron = "0/5 * * * * ?")

通過註解CronExp的id屬性可指定任務ID，不顯示指定則使用隨機ID，不滿足已知的條件，因此無法手動觸發。

4、帶引數任務

儘管大多數任務不需要注入引數，但仍有少量的場景需要向定時任務注入引數。

public void execute(JobExecutionContext context) {
    /* 如果在呼叫任務時傳入了引數，則能夠從Map中獲取 */
    Map<String, Object> dataMap = context.getMergedJobDataMap();
    /* 比如從Map中獲取一個鍵值對，一般來說引數均為基本資料型別 */
    Object key = dataMap.get("key");
    System.out.println("任務2：" + LocalDateTime.now() + ": " + key);
}

在編寫定時任務時，可從JobExecutionContext物件中解析一個Map，從而完成引數的注入。

http://localhost:8080/cms-api/quartz/job/1?key=a

上述http呼叫的含義是手動觸發任務ID為【1】的任務，並且向其傳遞引數為【key】值為【a】的引數。

5、任務併發

本框架不支援任務併發，換句話說併發對定時任務不利，因此需要手動禁止。

需要注意的是Quartz的併發是指當任務執行耗時超過任務排程週期時，上一個任務未執行完，新任務是否執行。

一般來說需要顯示禁止併發，在任務類上添加註解DisallowConcurrentExecution即可禁止任務併發。

6、持久化

如果定時任務有高可用的需求，那麼需要對任務進行持久化。定時任務資料持久化到資料庫中後，支援應用程式多開。定時任務持久化多節點部署後，叢集中單節點故障不影響定時任務的執行。

定時任務持久化，僅需修改yml檔案配置即可達到目標，無需修改程式碼。一般而言使用Mysql做持久化的容器。

spring:
  quartz:
    properties:
      org.quartz.jobStore.isClustered: true
      org.quartz.jobStore.class: org.quartz.impl.jdbcjobstore.JobStoreTX
      org.quartz.jobStore.driverDelegateClass: org.quartz.impl.jdbcjobstore.StdJDBCDelegate
      org.quartz.jobStore.dataSource: qzDS
      org.quartz.dataSource.qzDS.driver: com.mysql.cj.jdbc.Driver
      org.quartz.dataSource.qzDS.URL: jdbc:mysql://localhost:3306/quartz-demo
      org.quartz.dataSource.qzDS.user: root
      org.quartz.dataSource.qzDS.password: 123456

除了修改主機、埠、資料庫名、使用者名稱、密碼五個引數外，其餘引數使用預設值即可。

配置完資料庫連線後，使用SQL指令碼，注意初始化資料庫