spring-boot-2.0.3之quartz集成，最佳實踐

時間  2019-11-07
標籤 spring boot 2.0.3 quartz 集成 最佳 實踐 欄目 Spring 简体版
原文   原文鏈接

前言

　　開心一刻html

　　　　快過年了，大街上，爺爺在給孫子示範摔炮怎麼放，嘴裏還不停唸叨：要像這樣，用勁甩才能響。示範了一個，兩個，三個... 孫子終於忍不住了，抱着爺爺的腿哭起來：爺呀，你給我剩個吧！java

　　新的一年祝你們：健健康康，快快樂樂！mysql

　　github：https://github.com/youzhibinggit

　　碼雲(gitee)：https://gitee.com/youzhibinggithub

前情回顧與問題

　　spring-boot-2.0.3之quartz集成，不是你想的那樣哦！ 講到了quartz的基本概念，以及springboot與quartz的集成；集成很是簡單，引入相關依賴便可，此時咱們job存儲方式採用的是jdbc。web

　　spring-boot-2.0.3之quartz集成，數據源問題，源碼探究 講到了quartz的數據源問題，若是咱們沒有@QuartzDataSource修飾的數據源，那麼默認狀況下就是咱們的工程數據源，springboot會將工程數據源設置給quartz；爲何須要數據源，由於咱們的job不會空跑，每每會進行數據庫的操做，那麼就會用到數據庫鏈接，而獲取數據庫鏈接最經常使用的的方式就是從數據源獲取。spring

　　後續使用過程當中，發現了一些問題：sql

　　　　一、spring注入，job到底能不能注入到spring容器，job中能不能自動注入咱們的mapper（spring的autowired）；數據庫

　　　　二、job存儲方式，到底用JDBC仍是MEMORY，最佳實踐是什麼express

　　　　三、調度失準，沒有嚴格按照咱們的cron配置進行

spring注入

　　spring-boot-2.0.3之quartz集成，數據源問題，源碼探究中我還分析的層次分明，並很自信的得出結論：job不能注入到spring，也不能享受spring的自動注入

　　那時候採用的是從quartz數據源中獲取connection，而後進行jdbc編程，發現jdbc用起來真的不舒服（不是說有問題，mybatis、spring jdbcTemplate等底層也是jdbc），此時我就有了一個疑問：quartz job真的不能注入到spring、不能享受spring的自動注入嗎？ 結論可想而知：能！

打的真疼

　　job能不能注入到spring容器？ 答案是能夠的（各類註解：@Compoment、@Service、@Repository等），只是咱們將job注入到spring容器有意義嗎？ 咱們知道quartz是經過反射來實例化job的（具體實例化過程請往下看），與spring中已存在的job bean沒有任何關聯，咱們將job注入到spring也只是使spring中多了一個沒調用者的bean而已，沒有任何意義。這個問題應該換個方式來問：job有必要注入到spring容器中嗎？ 很顯然不必。

　　job中能不能注入spring中的常規bean了？ 答案是能夠的。咱們先來看下springboot官網是如何描述的：job能夠定義setter來注入data map屬性，也能夠以相似的方式注入常規bean，以下所示

public class SampleJob extends QuartzJobBean {

    private MyService myService;

    private String name;

    // Inject "MyService" bean （注入spring 常規bean）
    public void setMyService(MyService myService) { ... }

    // Inject the "name" job data property （注入job data 屬性）
    public void setName(String name) { ... }

    @Override
    protected void executeInternal(JobExecutionContext context)
            throws JobExecutionException {
        ...
    }

}
View Code

　　實現

　　　　pom.xml

<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0"
         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
    <modelVersion>4.0.0</modelVersion>

    <groupId>com.lee</groupId>
    <artifactId>spring-boot-quartz</artifactId>
    <version>1.0-SNAPSHOT</version>

    <properties>
        <java.version>1.8</java.version>
        <maven.compiler.source>1.8</maven.compiler.source>
        <maven.compiler.target>1.8</maven.compiler.target>
        <druid.version>1.1.10</druid.version>
        <pagehelper.version>1.2.5</pagehelper.version>
        <druid.version>1.1.10</druid.version>
    </properties>

    <parent>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-parent</artifactId>
        <version>2.0.3.RELEASE</version>
    </parent>

    <dependencies>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-web</artifactId>
        </dependency>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-thymeleaf</artifactId>
        </dependency>

        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-quartz</artifactId>
        </dependency>

        <dependency>
            <groupId>com.alibaba</groupId>
            <artifactId>druid-spring-boot-starter</artifactId>
            <version>${druid.version}</version>
        </dependency>
        <dependency>
            <groupId>mysql</groupId>
            <artifactId>mysql-connector-java</artifactId>
        </dependency>
        <dependency>
            <groupId>com.github.pagehelper</groupId>
            <artifactId>pagehelper-spring-boot-starter</artifactId>
            <version>${pagehelper.version}</version>
        </dependency>

        <!-- 日誌 -->
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-logging</artifactId>
            <exclusions>            <!-- 排除spring-boot-starter-logging中的所有依賴 -->
                <exclusion>
                    <groupId>*</groupId>
                    <artifactId>*</artifactId>
                </exclusion>
            </exclusions>
            <scope>test</scope>     <!-- 打包的時候不打spring-boot-starter-logging.jar -->
        </dependency>
        <dependency>
            <groupId>ch.qos.logback</groupId>
            <artifactId>logback-classic</artifactId>
        </dependency>

        <dependency>
            <groupId>org.projectlombok</groupId>
            <artifactId>lombok</artifactId>
            <optional>true</optional>
        </dependency>
    </dependencies>

    <build>
        <finalName>spring-boot-quartz</finalName>
        <plugins>
            <!-- 打包項目 mvn clean package -->
            <plugin>
                <groupId>org.springframework.boot</groupId>
                <artifactId>spring-boot-maven-plugin</artifactId>
            </plugin>
        </plugins>
    </build>
</project>
View Code

　　　　application.yml

server:
  port: 9001
  servlet:
    context-path: /quartz
spring:
  thymeleaf:
    mode: HTML
    cache: false
  #鏈接池配置
  datasource:
    type: com.alibaba.druid.pool.DruidDataSource
    name: ownDataSource
    druid:
      driver-class-name: com.mysql.jdbc.Driver
      url: jdbc:mysql://localhost:3306/spring-boot-quartz?useSSL=false&useUnicode=true
      username: root
      password: 123456
      initial-size: 1                     #鏈接池初始大小
      max-active: 20                      #鏈接池中最大的活躍鏈接數
      min-idle: 1                         #鏈接池中最小的活躍鏈接數
      max-wait: 60000                     #配置獲取鏈接等待超時的時間
      pool-prepared-statements: true    #打開PSCache，而且指定每一個鏈接上PSCache的大小
      max-pool-prepared-statement-per-connection-size: 20
      validation-query: SELECT 1 FROM DUAL
      validation-query-timeout: 30000
      test-on-borrow: false             #是否在得到鏈接後檢測其可用性
      test-on-return: false             #是否在鏈接放回鏈接池後檢測其可用性
      test-while-idle: true             #是否在鏈接空閒一段時間後檢測其可用性
  quartz:
    #相關屬性配置
    properties:
      org:
        quartz:
          scheduler:
            instanceName: quartzScheduler
            instanceId: AUTO
          threadPool:
            class: org.quartz.simpl.SimpleThreadPool
            threadCount: 10
            threadPriority: 5
            threadsInheritContextClassLoaderOfInitializingThread: true
#mybatis配置
mybatis:
  type-aliases-package: com.lee.quartz.entity
  mapper-locations: classpath:mybatis/mapper/*.xml
#分頁配置, pageHelper是物理分頁插件
pagehelper:
  #4.0.0之後版本能夠不設置該參數，該示例中是5.1.4
  helper-dialect: mysql
  #啓用合理化，若是pageNum<1會查詢第一頁，若是pageNum>pages會查詢最後一頁
  reasonable: true
logging:
  level:
    com.lee.quartz.mapper: debug
View Code

　　　　FetchDataJob.java

package com.lee.quartz.job;

import com.lee.quartz.entity.User;
import com.lee.quartz.mapper.UserMapper;
import org.quartz.JobExecutionContext;
import org.quartz.JobExecutionException;
import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.scheduling.quartz.QuartzJobBean;

import java.util.Random;
import java.util.stream.IntStream;

public class FetchDataJob extends QuartzJobBean {

    private static final Logger LOGGER = LoggerFactory.getLogger(FetchDataJob.class);

    @Autowired
    private UserMapper userMapper;

    @Override
    protected void executeInternal(JobExecutionContext context) throws JobExecutionException {

        // TODO 業務處理

        Random random = new Random();
        IntStream intStream = random.ints(18, 100);
        int first = intStream.limit(1).findFirst().getAsInt();
        int count = userMapper.saveUser(new User("zhangsan" + first, first));
        if (count == 0) {
            LOGGER.error("用戶保存失敗！");
            return;
        }
        LOGGER.info("用戶保存成功");
    }
}
View Code

　　　　如上，FetchDataJob中是能夠注入userMapper的，完整代碼請看：spring-boot-quartz-plus

　　job實例化過程源碼解析

　　　　還記得SchedulerFactoryBean的建立嗎，能夠看看這裏，咱們從SchedulerFactoryBean開始

　　　　QuartzSchedulerThread線程的啓動

　　　　　　QuartzSchedulerThread聲明以下

View Code

　　　　　　負責觸發QuartzScheduler註冊的Triggers，能夠理解成quartz的主線程（守護線程）。咱們從SchedulerFactoryBean的afterPropertiesSet()開始

　　　　　　QuartzSchedulerThread繼承了Thread，經過DefaultThreadExecutor的execute()啓動了QuartzSchedulerThread線程

　　　　jobFactory的建立與替換

　　　　　　AutowireCapableBeanJobFactory實例後續會賦值給quartz，做爲quartz job的工廠，具體在哪賦值給quartz的了，咱們往下看

　　　　　　當quartz scheduler建立完成後，將scheduler的jobFactory替換成了AutowireCapableBeanJobFactory。

　　　　job的建立與執行

　　　　　　QuartzSchedulerThread在上面已經啓動了，AutowireCapableBeanJobFactory也已經賦值給了scheduler；咱們來看看QuartzSchedulerThread的run()，裏面有job的建立與執行

　　　　　　最終會調用AutowireCapableBeanJobFactory的createJobInstance方法，經過反射建立了job實例，還向job實例中填充了job data map屬性和spring常規bean。具體this.beanFactory.autowireBean(jobInstance);是如何向job實例填充spring常規bean的，須要你們本身去跟了。job被封裝成了JobRunShell（實現了Runnable），而後從線程池中取第一個線程來執行JobRunShell，最終會執行到FetchDataJob的executeInternal，處理咱們的業務；quartz的線程實現與線程機制，有興趣的小夥伴自行去看。

　　　　小結下：先啓動QuartzSchedulerThrea線程，而後將quartz的jobFactory替換成AutowireCapableBeanJobFactory；QuartzSchedulerThread是一個守護線程，會按規則處理trigger和job（要成對存在），最終完成咱們的定時業務。

job存儲方式

　　JobStore是負責跟蹤調度器（scheduler）中全部的工做數據：做業任務、觸發器、日曆等。咱們無需在咱們的代碼中直接使用JobStore實例，只須要經過配置信息告知Quartz該用哪一個JobStore便可。quartz的JobStore有兩種：RAMJobStore、JDBCJobStore，經過名字咱們也能猜到這二者之間的區別與優缺點

　　上述兩種JobStore對應到springboot就是：MEMORY、JDBC

/*
 * Copyright 2012-2017 the original author or authors.
 *
 * 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.springframework.boot.autoconfigure.quartz;

/**
 * Define the supported Quartz {@code JobStore}.
 *
 * @author Stephane Nicoll
 * @since 2.0.0
 */
public enum JobStoreType {

    /**
     * Store jobs in memory.
     */
    MEMORY,

    /**
     * Store jobs in the database.
     */
    JDBC

}
View Code

　　至於選擇哪一種方式，就看哪一種方式更契合咱們的業務需求，沒有絕對的選擇誰與不選擇誰，只看哪一種更合適。據個人理解和工做中的應用，內存方式用的更多；實際應用中，咱們每每只是持久化咱們自定義的基礎job（不是quartz的job）到數據庫，應用啓動的時候加載基礎job到quartz中，進行quartz job的初始化，quartz的job相關信息所有存儲在RAM中；一旦應用中止，quartz的job信息所有丟失，但這影響不大，能夠經過咱們的自定義job進行quartz job的恢復，可是恢復的quartz job是原始狀態，若是須要實時保存quartz job的狀態，那就須要另外設計或者用JDBC方式了。

調度失準

　　當存儲方式是JDBCJobStore時，會出現調度失準的狀況，沒有嚴格按照配置的cron表達式執行，例如cron表達式：1 */1 * * * ?，日誌輸入以下

　　秒數會有不對，但這影響比較小，咱們還能接受，但是時間間隔有時候卻由1分鐘變成2分鐘，甚至3分鐘，這個就有點接受不了。具體緣由我尚未查明，我的以爲可能和數據庫持久化有關。

　　當存儲方式是RAMJobStore時，調度很準，還未發現調度失準的狀況，cron表達式：3 */1 * * * ?，日誌輸入以下

總結

　　一、quartz job無需注入到spring容器中（注入進去了也沒用），但quartz job中是能夠注入spring容器中的常規bean的，固然還能夠注入jab data map中的屬性值；

　　二、 springboot覆寫了quartz的jobFactory，使得quartz在調用jobFactory建立job實例的時候，可以將spring容器的bean注入到job中，AutowireCapableBeanJobFactory中createJobInstance方法以下

@Override
protected Object createJobInstance(TriggerFiredBundle bundle) throws Exception {
    Object jobInstance = super.createJobInstance(bundle);    // 經過反射實例化job，並將JobDataMap中屬性注入到job實例中
    this.beanFactory.autowireBean(jobInstance);                // 注入job依賴的spring中的bean    
    this.beanFactory.initializeBean(jobInstance, null);
    return jobInstance;
}

　　三、最佳實踐

　　　　JobStore選擇RAMJobStore；持久化咱們自定義的job，應用啓動的時候將咱們自定義的job都加載給quartz，初始化quartz job；quartz job狀態改變的時候，分析清楚是否須要同步到咱們自定義的job中，有則同步改變自定義job狀態。

參考

　　Quartz Scheduler

相關文章
相關標籤/搜索
每日一句
    每一个你不满意的现在，都有一个你没有努力的曾经。
本站公眾號
   歡迎關注本站公眾號,獲取更多信息
聯繫我們 最近搜索 最新文章 沪ICP备13005482号-10 MyBatis教程 SQL 教程 MySQL教程 Java 教程 Thymeleaf 教程 Hibernate教程 Spring教程 Redis教程