xxl-job入门实践

源码在码云上([e-mail]:lynch168/spring-boot.git)

1、下载xxl-job源码

xxl-job源码地址：https://github.com/xuxueli/xxl-job

解压导入到Eclipse，如下图所示：

2、修改pom.xml文件
2.1、修改/xxl-job-2.0.2/pom.xml

<plugin>
    <groupId>org.apache.maven.plugins</groupId>
    <artifactId>maven-source-plugin</artifactId>
    <version>${maven-source-plugin.version}</version>
    <configuration>
        <source>1.8</source>
        <target>1.8</target>
    </configuration>
    <executions>
        <execution>
            <phase>package</phase>
            <goals>
                <goal>jar-no-fork</goal>
            </goals>
        </execution>
    </executions>
</plugin>

 

2.2、修改/xxl-job-admin/pom.xml

<plugin>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-maven-plugin</artifactId>
    <version>${spring-boot.version}</version>
    <configuration>
        <source>1.8</source>
        <target>1.8</target>
    </configuration>
    <executions>
        <execution>
            <goals>
                <goal>repackage</goal>
            </goals>
        </execution>
    </executions>
</plugin>

注意：如果jdk为7此步骤忽略；源码默认用jdk7编译，这里改成jdk8。

3、MySQL数据库
新建数据库及相关表结构：
执行xxl-job/doc/db/tables_xxl_job.sql数据库脚本；

修改配置
修改/xxl-job-admin/src/main/resources/xxl-job-admin.properties脚本中关于数据库的配置：

修改/xxl-job-admin/src/main/resources/xxl-job-admin.properties脚本中关于数据库的配置： xxl.job.db.driverClass=com.mysql.jdbc.Driver xxl.job.db.url=jdbc:mysql://localhost:3306/xxl-job?useUnicode=true&characterEncoding=UTF-8
xxl.job.db.user=root xxl.job.db.password=

 

4、运行xxl-job-admin服务
4.1、打成war包然后放到tomcat容器中执行；
mvn clean package -U

4.2、若是调试，则可以直接在IDEA/Eclipse中配置一下tomcat，然后直接运行
启动完成后在浏览器输入：http://localhost:8080/xxl-job-admin/
默认账户：admin/123456
可在/xxl-job-admin/src/main/resources/xxl-job-admin.properties脚本中进行修改配置；

5、任务调度测试
选用/xxl-job/xxl-job-executor-samples/xxl-job-executor-sample-springbootdemo作为客户端测试demo;

5.1、新建JobHandler任务

package com.xxl.job.executor.service.jobhandler; import java.time.LocalDateTime; import java.time.format.DateTimeFormatter; import org.springframework.stereotype.Component; import com.xxl.job.core.biz.model.ReturnT; import com.xxl.job.core.handler.IJobHandler; import com.xxl.job.core.handler.annotation.JobHandler; /** * 任务Handler示例（Bean模式） * <p> * 开发步骤： * 1、继承"IJobHandler"：“com.xxl.job.core.handler.IJobHandler”； * 2、注册到Spring容器：添加“@Component”注解，被Spring容器扫描为Bean实例； * 3、注册到执行器工厂：添加“@JobHandler(value="自定义jobhandler名称")”注解，注解value值对应的是调度中心新建任务的JobHandler属性的值。 * 4、执行日志：需要通过 "XxlJobLogger.log" 打印执行日志； */ @JobHandler(value = "helloJobHandler") @Component public class HelloJobHandler extends IJobHandler { @Override public ReturnT<String> execute(String param) { String now = LocalDateTime.now().format(DateTimeFormatter.ofPattern("yyyy-MM-dd HH:mm:ss")); System.out.println(now + "XXL-JOB, Hello World."); return SUCCESS; } }

 

 

 

5.2、配置
配置脚本/xxl-job/xxl-job-executor-samples/xxl-job-executor-sample-springboot/src/main/resources/application.properties

xxl.job.admin.addresses=http://127.0.0.1:8080/xxl-job-admin

 

5.3、构建打包
$ cd /xxl-job/xxl-job-executor-samples/xxl-job-executor-sample-springboot/
$ mvn clean package -U
$ cd target

5.4、启动多个客户端服务
java -jar xxl-job-executor-sample-springboot-2.0.2.jar --server.port=8901 --xxl.job.executor.port=8801

java -jar xxl-job-executor-sample-springboot-2.0.2.jar --server.port=8902 --xxl.job.executor.port=8802

或者通过IDE启动XxlJobExecutorApplication入口类

自此要确保xxl-job-admin、xxl-job-executor-sample-springboot成功运行。

6、后台管理页面配置任务
6.1、执行器
执行器管理 -> 新建执行器

新建执行器的参数，跟/xxl-job-executor-sample-springboot/src/main/resources/application.properties文件一致，如下：

### xxl-job executor address xxl.job.executor.appname=xxl-job-executor-sample xxl.job.executor.ip= xxl.job.executor.port=9999

6.2、任务
任务管理 -> 新建任务

运行模式：@JobHandler(value = "helloJobHandler")中配置的value

点击"启动"按钮，执行任务，此时在控制台会看到如下打印信息：

2019-04-28 17:02:10XXL-JOB, Hello World. 2019-04-28 17:02:15XXL-JOB, Hello World. 2019-04-28 17:02:20XXL-JOB, Hello World. 2019-04-28 17:02:25XXL-JOB, Hello World. 2019-04-28 17:02:30XXL-JOB, Hello World. 2019-04-28 17:02:35XXL-JOB, Hello World. 2019-04-28 17:02:40XXL-JOB, Hello World. 2019-04-28 17:02:45XXL-JOB, Hello World.

7、查看调度日志