Spring Boot2 系列教程(十六)定時任務的兩種實現方式

江南一點雨發表於2019-10-25

在 Spring + SpringMVC 環境中,一般來說,要實現定時任務,我們有兩中方案,一種是使用 Spring 自帶的定時任務處理器 @Scheduled 註解,另一種就是使用第三方框架 Quartz ,Spring Boot 源自 Spring+SpringMVC ,因此天然具備這兩個 Spring 中的定時任務實現策略,當然也支援 Quartz,本文我們就來看下 Spring Boot 中兩種定時任務的實現方式。

@Scheduled

使用 @Scheduled 非常容易,直接建立一個 Spring Boot 專案,並且新增 web 依賴 spring-boot-starter-web,專案建立成功後,新增 @EnableScheduling 註解,開啟定時任務:

@SpringBootApplication
@EnableScheduling
public class ScheduledApplication {
    public static void main(String[] args) {
        SpringApplication.run(ScheduledApplication.class, args);
    }
}
複製程式碼

接下來配置定時任務:

    @Scheduled(fixedRate = 2000)
    public void fixedRate() {
        System.out.println("fixedRate>>>"+new Date());    
    }
    @Scheduled(fixedDelay = 2000)
    public void fixedDelay() {
        System.out.println("fixedDelay>>>"+new Date());
    }
    @Scheduled(initialDelay = 2000,fixedDelay = 2000)
    public void initialDelay() {
        System.out.println("initialDelay>>>"+new Date());
    }
複製程式碼
  1. 首先使用 @Scheduled 註解開啟一個定時任務。
  2. fixedRate 表示任務執行之間的時間間隔,具體是指兩次任務的開始時間間隔,即第二次任務開始時,第一次任務可能還沒結束。
  3. fixedDelay 表示任務執行之間的時間間隔,具體是指本次任務結束到下次任務開始之間的時間間隔。
  4. initialDelay 表示首次任務啟動的延遲時間。
  5. 所有時間的單位都是毫秒。

上面這是一個基本用法,除了這幾個基本屬性之外,@Scheduled 註解也支援 cron 表示式,使用 cron 表示式,可以非常豐富的描述定時任務的時間。cron 表示式格式如下:

[秒] [分] [小時] [日] [月] [周] [年]

具體取值如下:

序號 說明 是否必填 允許填寫的值 允許的萬用字元
1 0-59 - * /
2 0-59 - * /
3 0-23 - * /
4 1-31 - * ? / L W
5 1-12 or JAN-DEC - * /
6 1-7 or SUN-SAT - * ? / L ##
7 1970-2099 - * /

這一塊需要大家注意的是,月份中的日期和星期可能會起衝突,因此在配置時這兩個得有一個是 ?

萬用字元含義:

  • ? 表示不指定值,即不關心某個欄位的取值時使用。需要注意的是,月份中的日期和星期可能會起衝突,因此在配置時這兩個得有一個是 ?
  • * 表示所有值,例如:在秒的欄位上設定 *,表示每一秒都會觸發
  • , 用來分開多個值,例如在周欄位上設定 "MON,WED,FRI" 表示週一,週三和週五觸發
  • - 表示區間,例如在秒上設定 "10-12",表示 10,11,12秒都會觸發
  • / 用於遞增觸發,如在秒上面設定"5/15" 表示從5秒開始,每增15秒觸發(5,20,35,50)
  • ## 序號(表示每月的第幾個周幾),例如在周欄位上設定"6##3"表示在每月的第三個週六,(用 在母親節和父親節再合適不過了)
  • 周欄位的設定,若使用英文字母是不區分大小寫的 ,即 MON 與mon相同
  • L 表示最後的意思。在日欄位設定上,表示當月的最後一天(依據當前月份,如果是二月還會自動判斷是否是潤年), 在周欄位上表示星期六,相當於"7"或"SAT"(注意週日算是第一天)。如果在"L"前加上數字,則表示該資料的最後一個。例如在周欄位上設定"6L"這樣的格式,則表示"本月最後一個星期五"
  • W 表示離指定日期的最近工作日(週一至週五),例如在日欄位上設定"15W",表示離每月15號最近的那個工作日觸發。如果15號正好是週六,則找最近的週五(14號)觸發, 如果15號是周未,則找最近的下週一(16號)觸發,如果15號正好在工作日(週一至週五),則就在該天觸發。如果指定格式為 "1W",它則表示每月1號往後最近的工作日觸發。如果1號正是週六,則將在3號下週一觸發。(注,"W"前只能設定具體的數字,不允許區間"-")
  • LW 可以一組合使用。如果在日欄位上設定"LW",則表示在本月的最後一個工作日觸發(一般指發工資 )

例如,在 @Scheduled 註解中來一個簡單的 cron 表示式,每隔5秒觸發一次,如下:

@Scheduled(cron = "0/5 * * * * *")
public void cron() {
    System.out.println(new Date());
}
複製程式碼

上面介紹的是使用 @Scheduled 註解的方式來實現定時任務,接下來我們再來看看如何使用 Quartz 實現定時任務。

Quartz

一般在專案中,除非定時任務涉及到的業務實在是太簡單,使用 @Scheduled 註解來解決定時任務,否則大部分情況可能都是使用 Quartz 來做定時任務。在 Spring Boot 中使用 Quartz ,只需要在建立專案時,新增 Quartz 依賴即可:

Spring Boot2 系列教程(十六)定時任務的兩種實現方式

專案建立完成後,也需要新增開啟定時任務的註解:

@SpringBootApplication
@EnableScheduling
public class QuartzApplication {
    public static void main(String[] args) {
        SpringApplication.run(QuartzApplication.class, args);
    }
}
複製程式碼

Quartz 在使用過程中,有兩個關鍵概念,一個是JobDetail(要做的事情),另一個是觸發器(什麼時候做),要定義 JobDetail,需要先定義 Job,Job 的定義有兩種方式:

第一種方式,直接定義一個Bean:

@Component
public class MyJob1 {
    public void sayHello() {
        System.out.println("MyJob1>>>"+new Date());
    }
}
複製程式碼

關於這種定義方式說兩點:

  1. 首先將這個 Job 註冊到 Spring 容器中。
  2. 這種定義方式有一個缺陷,就是無法傳參。

第二種定義方式,則是繼承 QuartzJobBean 並實現預設的方法:

public class MyJob2 extends QuartzJobBean {
    HelloService helloService;
    public HelloService getHelloService() {
        return helloService;
    }
    public void setHelloService(HelloService helloService) {
        this.helloService = helloService;
    }
    @Override
    protected void executeInternal(JobExecutionContext jobExecutionContext) throws JobExecutionException {
        helloService.sayHello();
    }
}
public class HelloService {
    public void sayHello() {
        System.out.println("hello service >>>"+new Date());
    }
}
複製程式碼

和第1種方式相比,這種方式支援傳參,任務啟動時,executeInternal 方法將會被執行。

Job 有了之後,接下來建立類,配置 JobDetail 和 Trigger 觸發器,如下:

@Configuration
public class QuartzConfig {
    @Bean
    MethodInvokingJobDetailFactoryBean methodInvokingJobDetailFactoryBean() {
        MethodInvokingJobDetailFactoryBean bean = new MethodInvokingJobDetailFactoryBean();
        bean.setTargetBeanName("myJob1");
        bean.setTargetMethod("sayHello");
        return bean;
    }
    @Bean
    JobDetailFactoryBean jobDetailFactoryBean() {
        JobDetailFactoryBean bean = new JobDetailFactoryBean();
        bean.setJobClass(MyJob2.class);
        JobDataMap map = new JobDataMap();
        map.put("helloService", helloService());
        bean.setJobDataMap(map);
        return bean;
    }
    @Bean
    SimpleTriggerFactoryBean simpleTriggerFactoryBean() {
        SimpleTriggerFactoryBean bean = new SimpleTriggerFactoryBean();
        bean.setStartTime(new Date());
        bean.setRepeatCount(5);
        bean.setJobDetail(methodInvokingJobDetailFactoryBean().getObject());
        bean.setRepeatInterval(3000);
        return bean;
    }
    @Bean
    CronTriggerFactoryBean cronTrigger() {
        CronTriggerFactoryBean bean = new CronTriggerFactoryBean();
        bean.setCronExpression("0/10 * * * * ?");
        bean.setJobDetail(jobDetailFactoryBean().getObject());
        return bean;
    }
    @Bean
    SchedulerFactoryBean schedulerFactoryBean() {
        SchedulerFactoryBean bean = new SchedulerFactoryBean();
        bean.setTriggers(cronTrigger().getObject(), simpleTriggerFactoryBean().getObject());
        return bean;
    }
    @Bean
    HelloService helloService() {
        return new HelloService();
    }
}
複製程式碼

關於這個配置說如下幾點:

  1. JobDetail 的配置有兩種方式:MethodInvokingJobDetailFactoryBean 和 JobDetailFactoryBean 。
  2. 使用 MethodInvokingJobDetailFactoryBean 可以配置目標 Bean 的名字和目標方法的名字,這種方式不支援傳參。
  3. 使用 JobDetailFactoryBean 可以配置 JobDetail ,任務類繼承自 QuartzJobBean ,這種方式支援傳參,將引數封裝在 JobDataMap 中進行傳遞。
  4. Trigger 是指觸發器,Quartz 中定義了多個觸發器,這裡向大家展示其中兩種的用法,SimpleTrigger 和 CronTrigger 。
  5. SimpleTrigger 有點類似於前面說的 @Scheduled 的基本用法。
  6. CronTrigger 則有點類似於 @Scheduled 中 cron 表示式的用法。

Spring Boot2 系列教程(十六)定時任務的兩種實現方式

全部定義完成後,啟動 Spring Boot 專案就可以看到定時任務的執行了。

總結

這裡主要向大家展示了 Spring Boot 中整合兩種定時任務的方法,整合成功之後,剩下的用法基本上就和在 SSM 中使用一致了,不再贅述。本文案例我已經上傳到 GitHub ,歡迎大家 star:github.com/lenve/javab…

關注公眾號【江南一點雨】,專注於 Spring Boot+微服務以及前後端分離等全棧技術,定期視訊教程分享,關注後回覆 Java ,領取鬆哥為你精心準備的 Java 乾貨!

Spring Boot2 系列教程(十六)定時任務的兩種實現方式

相關文章