步驟一：添加pom依賴(lài)

以Spring Boot接入模式為例，應(yīng)用程序的pom.xml文件中添加依賴(lài)及啟動(dòng)類(lèi)。

schedulerx2.version使用客戶端最新版本。更多信息，請(qǐng)參見(jiàn)客戶端發(fā)布記錄。

<dependency>
  <groupId>com.aliyun.schedulerx</groupId>
  <artifactId>schedulerx2-spring-boot-starter</artifactId>
  <version>${schedulerx2.version}</version>
  <!--如果用的是logback，需要把log4j和log4j2排掉 -->
  <exclusions>
    <exclusion>
      <groupId>org.apache.logging.log4j</groupId>
      <artifactId>log4j-api</artifactId>
    </exclusion>
    <exclusion>
      <groupId>org.apache.logging.log4j</groupId>
      <artifactId>log4j-core</artifactId>
    </exclusion>
    <exclusion>
      <groupId>log4j</groupId>
      <artifactId>log4j</artifactId>
    </exclusion>
  </exclusions>
</dependency>

@SpringBootApplication
@EnableScheduling /** 開(kāi)啟Spring定時(shí)任務(wù) */
public class SchedulerXWorkerApplication {
    public static void main(String[] args) {
        SpringApplication.run(SchedulerXWorkerApplication.class, args);
    }
}

/** Spring原生配置的定時(shí)任務(wù)類(lèi)*/
@Service
public class SpringScheduledProcessor {
    @Scheduled(cron = "0/2 * * * * ?")
    public void hello() {
        logger.info(DateUtil.now() + " hello world. start");
        logger.info(DateUtil.now() + " hello world. end");
    }
}

步驟三：手動(dòng)創(chuàng)建定時(shí)任務(wù)（可選）

1. 登錄分布式任務(wù)調(diào)度平臺(tái)。

2. 在左側(cè)導(dǎo)航欄，單擊任務(wù)管理。

3. 在任務(wù)管理頁(yè)面，單擊創(chuàng)建任務(wù)。選擇SpringSchedule任務(wù)類(lèi)型，配置對(duì)應(yīng)定時(shí)任務(wù)類(lèi)及其方法名。

   配置名稱(chēng)	意義
   任務(wù)名	任務(wù)名稱(chēng)。
   描述	任務(wù)描述，盡量簡(jiǎn)潔地描述業(yè)務(wù)，便于后續(xù)搜索。
   應(yīng)用ID	任務(wù)所屬分組。可以在下拉列表中選擇。
   任務(wù)類(lèi)型	指任務(wù)所實(shí)現(xiàn)的語(yǔ)言，當(dāng)前支持Java、Shell、Python、Go、HTTP、Node.js、XXL-JOB和DataWorks類(lèi)型，其中Shell、Python和Go會(huì)彈出編輯框，在編輯框中編寫(xiě)任務(wù)腳本。 本文任務(wù)類(lèi)型為SpringSchedule。
   spring schedule配置	定時(shí)任務(wù)代碼的完整類(lèi)名（class name）和任務(wù)的方法名（method name）。
   執(zhí)行模式	執(zhí)行模式，這里特指任務(wù)執(zhí)行的模式，當(dāng)前支持以下模式。 單機(jī)運(yùn)行：隨機(jī)選一臺(tái)機(jī)器執(zhí)行。 廣播運(yùn)行：所有機(jī)器同時(shí)執(zhí)行并等待全部結(jié)束。 說(shuō)明 當(dāng)選擇了不同的執(zhí)行模式后，高級(jí)設(shè)置中的參數(shù)會(huì)相應(yīng)變化。
   優(yōu)先級(jí)	同一應(yīng)用下多個(gè)任務(wù)同時(shí)在一個(gè)實(shí)例中運(yùn)行時(shí)，優(yōu)先級(jí)高的任務(wù)會(huì)被優(yōu)先執(zhí)行。但當(dāng)一個(gè)應(yīng)用中的多個(gè)任務(wù)在多個(gè)實(shí)例中運(yùn)行時(shí)，不同優(yōu)先級(jí)的任務(wù)被調(diào)度到不同實(shí)例執(zhí)行，可能導(dǎo)致低優(yōu)先級(jí)任務(wù)被優(yōu)先執(zhí)行。SchedulerX通過(guò)可搶占的優(yōu)先級(jí)隊(duì)列規(guī)避了這種可能性，并保證同時(shí)在池子中等待的高優(yōu)先級(jí)任務(wù)被優(yōu)先執(zhí)行。更多信息，請(qǐng)參見(jiàn)可搶占的優(yōu)先級(jí)隊(duì)列。
   任務(wù)參數(shù)	任意字符串，可以在運(yùn)行時(shí)通過(guò)上下文獲取。

4. 配置對(duì)應(yīng)定時(shí)觸發(fā)頻率。

   說(shuō)明

   頻率會(huì)以控制臺(tái)配置的頻率為準(zhǔn)，Spring定時(shí)任務(wù)代碼中原生注解@Scheduled中配置將會(huì)失效，但該注解在代碼中需要保留。

   定時(shí)參數(shù)說(shuō)明如下：

   配置名稱(chēng)	意義
   時(shí)間類(lèi)型	none：無(wú)調(diào)度方式，一般通過(guò)工作流觸發(fā)。 cron：Cron表達(dá)式。 api：通過(guò)API觸發(fā)。 fixed_rate：固定頻率。 second_delay：秒級(jí)固定延遲。 one_time：一次性任務(wù)。
   cron表達(dá)式（僅適用于cron時(shí)間類(lèi)型）	填寫(xiě)Cron表達(dá)式。可以直接按照Cron語(yǔ)法填寫(xiě)，也可以使用工具生成并驗(yàn)證。
   固定頻率（僅適用于fixed_rate時(shí)間類(lèi)型）	填寫(xiě)固定頻率，單位為秒，只支持60秒以上。例如200表示每200s調(diào)度一次。
   固定延遲（僅適用于second_delay時(shí)間類(lèi)型）	填寫(xiě)固定延遲，單位為秒。范圍為1秒~60秒。例如5表示延遲5秒觸發(fā)調(diào)度。

   高級(jí)配置參數(shù)說(shuō)明如下：

   配置名稱(chēng)	意義
   數(shù)據(jù)時(shí)間偏移	數(shù)據(jù)時(shí)間相對(duì)于調(diào)度時(shí)間的偏移，可以在調(diào)度時(shí)從上下文獲取該值。
   時(shí)區(qū)	可以根據(jù)實(shí)際情況選擇不同時(shí)區(qū)，包括一些常用國(guó)家或地區(qū)，也包括標(biāo)準(zhǔn)的GMT表達(dá)方式。
   日歷	可選擇工作日或者金融日。

5. 設(shè)置相關(guān)報(bào)警條件和通知渠道等。關(guān)于通知渠道，請(qǐng)參見(jiàn)通知聯(lián)系人和通知聯(lián)系人組。

   完成上述步驟后，SchedulerX 任務(wù)調(diào)度平臺(tái)即可接管運(yùn)行Spring的定時(shí)任務(wù)，支持為原生的Spring任務(wù)帶來(lái)的各種可視化管控、任務(wù)業(yè)務(wù)日志查詢(xún)、執(zhí)行鏈路查看、任務(wù)執(zhí)行通知報(bào)警等企業(yè)級(jí)能力。