輕量級任務調度平臺xqiang-job使用實例

上文中介紹了任務調度平臺。本文主要講解使用。

實現方案

• DB存儲任務相關信息
• 基於Quartz實現任務調度
  • 定時器，bean+方法反射方式調用。
• 基於Lauyi的頁面後臺管理

搭建一個SpringBoot項目

添加依賴

核心依賴

 <dependency>
   <groupId>com.github.xqiangme</groupId>
   <artifactId>xqiang-job-admin</artifactId>
   <version>0.0.2-RELEASE</version>
  </dependency>

全部依賴示例

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

    <properties>
        <java.version>1.8</java.version>
        <alibaba.druid.version>1.0.29</alibaba.druid.version>
        <mysql-connector.version>8.0.18</mysql-connector.version>
        <mybatis-spring-boot.version>1.3.1</mybatis-spring-boot.version>
        <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
    </properties>

    <!-- 依賴 -->
    <dependencies>

        <dependency>
            <groupId>com.github.xqiangme</groupId>
            <artifactId>xqiang-job-admin</artifactId>
            <version>0.0.2-RELEASE</version>
        </dependency>

        <!-- spring-boot 相關 依賴 -->
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-web</artifactId>
        </dependency>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-jdbc</artifactId>
        </dependency>
        <dependency>
            <groupId>org.mybatis.spring.boot</groupId>
            <artifactId>mybatis-spring-boot-starter</artifactId>
            <version>${mybatis-spring-boot.version}</version>
        </dependency>
        <!-- mysql connector -->
        <dependency>
            <groupId>mysql</groupId>
            <artifactId>mysql-connector-java</artifactId>
            <version>${mysql-connector.version}</version>
        </dependency>
        <!-- druid 連接池 -->
        <dependency>
            <groupId>com.alibaba</groupId>
            <artifactId>druid</artifactId>
            <version>${alibaba.druid.version}</version>
        </dependency>
        <dependency>
            <groupId>org.slf4j</groupId>
            <artifactId>slf4j-api</artifactId>
            <version>1.7.5</version>
        </dependency>
        <dependency>
            <groupId>com.alibaba</groupId>
            <artifactId>fastjson</artifactId>
            <version>1.2.67</version>
        </dependency>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-thymeleaf</artifactId>
        </dependency>

        <!-- 以下依賴非必須  -->
        <dependency>
            <groupId>org.projectlombok</groupId>
            <artifactId>lombok</artifactId>
            <version>1.16.4</version>
        </dependency>
    </dependencies>

添加配置

server.port=8083

#數據源 >>   配置
##連接地址
spring.datasource.url=jdbc:mysql://localhost:3306/job-admin?useUnicode=true&characterEncoding=utf8&autoReconnect=true&failOverReadOnly=false&serverTimezone=Asia/Shanghai&useSSL=false
#用戶名
spring.datasource.username=root
#密碼
spring.datasource.password=123456
#驅動
spring.datasource.driver-class-name=com.mysql.cj.jdbc.Driver

#重啓後是否初始化任務on|off
job.base.config.start= on
#項目名稱key（當前項目唯一key）
job.base.config.project-key = common
#項目名稱(例如：xx商城)
job.base.config.platform-name = 小強

#thymelea模板配置（必須）
spring.thymeleaf.prefix=classpath:/templates/
spring.thymeleaf.suffix=.html
spring.thymeleaf.mode=HTML
spring.thymeleaf.encoding=UTF-8
spring.thymeleaf.cache=false

#日誌配置（可選）
logging.config=classpath:log4j.xml
logging.level.root=WARN
logging.level.com.example=debug
logging.level.com.xqiang.job.admin=debug

部分配置說明：
1.重啓後是否初始化任務
job.base.config.start= on
如果設置了off，項目啓動將不會自動啓動任務。一般測試環境設置of


2.項目名稱key（當前項目唯一key）
job.base.config.project-key = common
不同項目後臺配置一個唯一Key,可以公用同一套任務管理表。會通過該屬性來隔離。


3.項目名稱(例如：xx商城)
job.base.config.platform-name = 小強
項目名稱，建議5字以內，會在登錄頁與首頁等展示配置的該名稱
注意：數據不共享，如果要建立多個，平臺的調度後臺，還需要將超級管理員用戶，補錄對應的project-key

啓動類

添加Job-admin掃描包地址配置

@ComponentScans({@ComponentScan(JobAdminOpenConstant.SCAN_PACKAGE)})

數據源配置

• 數據源配置上添加job-admin相關文件的掃描地址
  

示例Job

Demo工程

Demo工程源碼地址：傳送門

工程結構示例

Demo工程啓動後訪問：http://localhost:8083/job-admin/login
超級管理員賬號：superadmin
管理員賬號：admin
密碼均爲：123456 （可登錄後修改）


注：爲了防止項目中存在其他外部接口調用，工具中默認只攔截/job-admin下的請求地址。

程序日誌

對應腳本來說如果出了問題，排除日誌還是比較頭疼的，所以在設計上加了logId的概念,在任務開啓的時候設置一個logId,可以通過當前logId找到當前任務的執行日誌。

公衆號
更多精彩內容、編程故事、心得分享，歡迎關注公衆號