Solon

solon.scheduling

v2.7.3 </> 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