如何通过编码的方式手动触发xxl-job执行器

Posted 2021-09-26 linyb极客之路

前言

xxl-job是一个分布式任务调度平台，其核心设计目标是开发迅速、学习简单、轻量级、易扩展、开箱即用。我部门大部分定时任务调度都是基于xxl-job，诸如报表统计、定时数据同步等。
今天的素材来源于某天产品经理想在定时同步报表数据的基础上，再增加一个手动触发报表数据同步的功能。即在报表页面上新增一个手动同步的按钮，触发该按钮就可以执行报表数据同步

需求分析

1、保留定时同步功能，同时新增手动同步

2、手动同步的数据产生的效果要和定时数据同步的产生效果一样

解决思路

1、方案一、新建一个手动调用的controller，controller触发数据同步逻辑service

其实就是把写在xxl-job执行器里面的同步逻辑，再放到controller执行一遍

2、方案二、新建一个手动调用的controller，在controller里面直接触发xxl-job执行器

解决方案分析

在原先的定时器场景，我们为了避免定时器里面的同步逻辑还没完成，下次定时器就触发导致数据同步不准确，我们在执行器里面做一些手段进行规避，比如设置同步完成标志位等。
如果基于方案一，方案看似可行，其实存在潜在的坑点。即定时器执行的时候，手动刚好触发执行，或者反过来，手动触发的时候，定时器也执行了。这样就会导致数据同步执行多次，导致数据不准确。

后面我们调研了xxl-job，看到了xxl-job有提供restful风格触发执行器的功能，这个功能简直就是为我们量身定做，当手动调用的时候，触发执行器，因为执行的是执行器里面的调用逻辑，因此就会触发我们为避免数据同步不准确所采取的手段

如何通过restful风格手动触发xxl-job执行器执行

其具体介绍可以查看官网，其链接如下

https://www.xuxueli.com/xxl-job/#6.2 执行器 RESTful API

本例的核心代码块

@RestController
@RequestMapping(value = "xxl-job")
@Api(tags = "xxl-job restful调度")
@Profile("job")
@Slf4j
public class XxlJobController {

    @Autowired
    private XxljobClientHelper xxljobClientHelper;

    @ApiOperation(value = "手动触发任务")
    @GetMapping("/run")
    public AjaxResult execute(){
        String adminClientAddressUrl = xxljobClientHelper.getAdminClientAddressUrl();
        String accessToken = xxljobClientHelper.getAccessToken();
        log.info("adminClientAddressUrl:{},accessToken:{}", adminClientAddressUrl,accessToken);
        ExecutorBiz executorBiz = new ExecutorBizClient(adminClientAddressUrl, accessToken);
        ReturnT<String> retval = executorBiz.run(getTriggerParam());
        log.info("retval:{}", JSON.toJSONString(retval));
         // 200 表示正常、其他失败
        if(retval.getCode() == 200){
            return AjaxResult.success();
        }
        return AjaxResult.error(retval.getMsg(),retval.getCode());
    }

    private TriggerParam getTriggerParam(){
        TriggerParam triggerParam = new TriggerParam();
        // 任务ID
//        triggerParam.setJobId(15);
        // 任务标识
        triggerParam.setExecutorHandler("demoJobHandler");
        // 任务参数
        triggerParam.setExecutorParams("手动触发任务");
        // 任务阻塞策略，可选值参考 com.xxl.job.core.enums.ExecutorBlockStrategyEnum
        triggerParam.setExecutorBlockStrategy(ExecutorBlockStrategyEnum.COVER_EARLY.name());
        // 任务模式，可选值参考 com.xxl.job.core.glue.GlueTypeEnum
        triggerParam.setGlueType(GlueTypeEnum.BEAN.name());
        // GLUE脚本代码
        triggerParam.setGlueSource(null);
        // GLUE脚本更新时间，用于判定脚本是否变更以及是否需要刷新
        triggerParam.setGlueUpdatetime(System.currentTimeMillis());
        // 本次调度日志ID
        triggerParam.setLogId(triggerParam.getJobId());
        // 本次调度日志时间
        triggerParam.setLogDateTime(System.currentTimeMillis());
        return triggerParam;

    }
}

注： 代码中的demoJobHandler，就是执行器里面的调度方法。形如下

  /**
     * 1、简单任务示例（Bean模式）
     */
    @XxlJob("demoJobHandler")
    public ReturnT<String> demoJobHandler(String param) throws Exception {
        XxlJobLogger.log("XXL-JOB, Hello World.");
        System.out.println("======================param:"+param+"================================随机数："+new Random().nextInt(1000));
        return ReturnT.SUCCESS;
    }

总结

如果选用方案一，也不是不行，就还得做一些改造，比如增加全局标志位，而且在设置标志位的时候，还要考虑并发场景下，可能出现的问题。因此还不如直接采用方案二。方案的选择一定得要基于业务场景进行考量，不基于业务场景，谈技术方案，很容易采坑

demo链接

https://github.com/lyb-geek/springboot-learning/tree/master/springboot-xxl-job-executor