Solon v3.0.3

solon-scheduling

</> markdown 
<dependency>
    <groupId>org.noear</groupId>
    <artifactId>solon-scheduling</artifactId>
</dependency>

1、描述

调度扩展插件。为代码执行 提供“定时调度”、“异步调度”、“重试调度”、“命令行调度”的标准接口定义。目前，“定时调度”有 simple、quartz 两种实现。（v1.11.4 后支持）

2、定时调度方面

定时调度方面，只定义了标准与接口。由适配插件进行实现：

实现插件适配情况备注
solon-scheduling-simple基于本地的简单实现
solon-scheduling-quartz基于 quartz 的适配支持像 jdbc 等分布式调度

认识 @Scheduled 注解属性：

属性说明备注支持情况
name任务名字一般为自动生成simple，quartz
enable是否启用 simple，quartz
croncron 表达式：支持7位将并行执行simple，quartz
zone时区配合 cron 使用simple，quartz
fixedRate固定频率毫秒数将并行执行simple，quartz
fixedDelay固定延时毫秒数将串行执行simple
initialDelay初次执行前延时（毫秒数）配合 fixedRate 或 fixedDelay 使用simple

3、异步调度方面

异步调度方面，已提供直接实现。但，不建议使用：

  • 不能参与事务链
  • 出异常时也没有后手
  • 排队待处理的执行过多，重启一下全没了
  • 虽然可无可有的处理可用，但团队人多就会乱用

具体示例：

@EnableAsync
public class DemoApp{
    public void static void main(String[] args){
        Solon.start(DemoApp.class, args);
    }
}

//定义个服务
@Component
public class AsyncTask {
    //会被异步运行（提交到异步执行器运行）//不要返回值（返回也拿不到）
    @Async
    public void testAsync(String hint){
        System.out.println(Thread.currentThread().getName());
    }
}

//应用
@Controller
public class DemoController{
    @Inject
    AsyncTask asyncTask;
    
    @Mapping("/test")
    public void test(){
        //调用
        asyncTask.testAsync("test");
    }
}

定制运行器工厂（能起到拦截的意思）：

@Component
public class InvocationRunnableFactoryImpl implements InvocationRunnableFactory {
    @Override
    public Runnable create(Invocation inv) {
        //可以改造这里的代码 //Runnable 最终会提交给异步执行器执行
        return new InvocationRunnable(inv);
    }
}

@Component
public class InvocationRunnableFactoryImpl implements InvocationRunnableFactory {
    @Override
    public Runnable create(Invocation inv) {
        RunUtil.async(new InvocationRunnable(inv));
        //如果返回为null，则不再进入内部的异步执行器执行（即，可以自己定制执行策略）
        return null;
    }
}

4、重试调度方面

具体示例：（v2.4.1 后支持）

//定义个服务
@Component
public class RetryTask {
    //有异常，会重试执行
    @Retry(Throwable.class)
    public void test(String hint){
        System.out.println(Thread.currentThread().getName());
    }
}

//如果需要保底
@Component
public class RetryTask implements Recover {
    //有异常，会重试执行
    @Retry(include=Throwable.class, recover=RetryTask.class) //保底可能是任何 Recover 实现
    public void test(String hint){
        System.out.println(Thread.currentThread().getName());
    }
    
    @Override
    public Object recover(Callee callee, Throwable e) throws Throwable{
        //保底处理
        return null;
    }
}

//应用
@Controller
public class DemoController{
    @Inject
    RetryTask retryTask;
    
    @Mapping("/test")
    public void test(){
        //调用
        retryTask.test("test");
    }
}

5、命令调度方面

定义命令执行的服务：（v2.7.0 后支持）

@Command("cmd:test")
public class Cmd1 implements CommandExecutor {
    @Override
    public void execute(String command) {
        System.out.println("exec: " + command);
    }
}

打包后，运行示例：

java -jar demo.jar cmd:test