补习系列(9)-springboot 定时器，你用对了吗

简介

大多数的应用程序都离不开定时器，通常在程序启动时、运行期间会需要执行一些特殊的处理任务。
比如资源初始化、数据统计等等，SpringBoot 作为一个灵活的框架，有许多方式可以实现定时器或异步任务。
我总结了下，大致有以下几种：

1. 使用 JDK 的 TimerTask

1. 使用 JDK 自带调度线程池

1. 使用 Quartz 调度框架

1. 使用 @Scheduled 、@Async 注解

其中第一种使用 TimerTask 的方法已经不建议使用，原因是在系统时间跳变时TimerTask存在挂死的风险。
第三种使用 Quartz 调度框架可以实现非常强大的定时器功能，包括分布式调度定时器等等。
考虑作为大多数场景使用的方式，下面的篇幅将主要介绍 第二、第四种。

一、应用启动任务

在 SpringBoot 应用程序启动时，可以通过以下两个接口实现初始化任务：

1. CommandLineRunner

2. ApplicationRunner

两者的区别不大，唯一的不同在于：
CommandLineRunner 接收一组字符串形式的进程命令启动参数；
ApplicationRunner 接收一个经过解析封装的参数体对象。

详细的对比看下代码：

public class CommandLines {    private static final Logger logger = LoggerFactory.getLogger(CommandLines.class);    @Component
    @Order(1)    public static class CommandLineAppStartupRunner implements CommandLineRunner {        @Override
        public void run(String... args) throws Exception {
            logger.info(                    "[CommandLineRunner]Application started with command-line arguments: {} .To kill this application, press Ctrl + C.",
                    Arrays.toString(args));
        }
    }    
    @Component
    @Order(2)    public static class AppStartupRunner implements ApplicationRunner {        
        @Override
        public void run(ApplicationArguments args) throws Exception {
            logger.info("[ApplicationRunner]Your application started with option names : {}", args.getOptionNames());
        }
    }
}

二、JDK 自带调度线程池

为了实现定时调度，需要用到 ScheduledThreadpoolExecutor
初始化一个线程池的代码如下：

    /**
     * 构造调度线程池
     * 
     * @param corePoolSize
     * @param poolName
     * @return
     */
    public static ScheduledThreadPoolExecutor newSchedulingPool(int corePoolSize, String poolName) {

        ScheduledThreadPoolExecutor threadPoolExecutor = new ScheduledThreadPoolExecutor(corePoolSize);        // 设置变量
        if (!StringUtils.isEmpty(poolName)) {
            threadPoolExecutor.setThreadFactory(new ThreadFactory() {                
                @Override
                public Thread newThread(Runnable r) {
                    Thread tr = new Thread(r, poolName + r.hashCode());                    return tr;
                }
            });
        }        return threadPoolExecutor;
    }

可以将 corePoolSize 指定为大于1，以实现定时任务的并发执行。

为了在 SpringBoot 项目中使用，我们利用一个CommandLineRunner来实现：

@Component@Order(1)public class ExecutorTimer implements CommandLineRunner {    private static final Logger logger = LoggerFactory.getLogger(ExecutorTimer.class);    private ScheduledExecutorService schedulePool;    @Override
    public void run(String... args) throws Exception {
        logger.info("start executor tasks");

        schedulePool = ThreadPools.newSchedulingPool(2);

        schedulePool.scheduleWithFixedDelay(new Runnable() {            @Override
            public void run() {
                logger.info("run on every minute");

            }
        }, 5, 60, TimeUnit.SECONDS);
    }
}

schedulePool.scheduleWithFixedDelay 指定了调度任务以固定的频率执行。

三、@Scheduled

@Scheduled 是 Spring3.0 提供的一种基于注解实现调度任务的方式。
在使用之前，需要通过 @EnableScheduling 注解启用该功能。

代码如下：

/**
 * 利用@Scheduled注解实现定时器
 * 
 * @author atp
 *
 */@Componentpublic class ScheduleTimer {    private static final Logger logger = LoggerFactory.getLogger(ScheduleTimer.class);    /**
     * 每10s
     */
    @Scheduled(initialDelay = 5000, fixedDelay = 10000)    public void onFixDelay() {
        logger.info("schedule job on every 10 seconds");
    }    /**
     * 每分钟的0秒执行
     */
    @Scheduled(cron = "0 * * * * *")    public void onCron() {
        logger.info("schedule job on every minute(0 second)");
    }    /**
     * 启用定时器配置
     * 
     * @author atp
     *
     */
    @Configuration
    @EnableScheduling
    public static class ScheduleConfig {
    }
}

说明
上述代码中展示了两种定时器的使用方式：

第一种方式
指定初始延迟(initialDelay)、固定延迟(fixedDelay)；

第二种方式
通过 cron 表达式定义
这与 unix/linux 系统 crontab 的定义类似，可以实现非常灵活的定制。

一些 cron 表达式的样例：

定制 @Scheduled 线程池

默认情况下，@Scheduled 注解的任务是由一个单线程的线程池进行调度的。
这样会导致应用内的定时任务只能串行执行。

为了实现定时任务并发，或是更细致的定制，
可以使用 SchedulingConfigurer 接口。

代码如下：

    @Configuration
    @EnableScheduling
    public class ScheduleConfig implements SchedulingConfigurer {        
        @Override
        public void configureTasks(ScheduledTaskRegistrar taskRegistrar) {
            taskRegistrar.setScheduler(taskExecutor());
        }     
        @Bean(destroyMethod="shutdown")        public Executor taskExecutor() {            //线程池大小
            return Executors.newScheduledThreadPool(50);
        }
    }

四、@Async

@Async 注解的意义在于将 Bean方法的执行方式改为异步方式。
比如 在前端请求处理时，能通过异步执行提前返回结果。

类似的，该注解需要配合 @EnableAsync 注解使用。

代码如下：

    @Configuration
    @EnableAsync
    public static class ScheduleConfig {

    }

使用 @Async 实现模拟任务

@Componentpublic class AsyncTimer implements CommandLineRunner {    private static final Logger logger = LoggerFactory.getLogger(AsyncTimer.class);    @Autowired
    private AsyncTask task;    @Override
    public void run(String... args) throws Exception {        long t1 = System.currentTimeMillis();
        task.doAsyncWork();        long t2 = System.currentTimeMillis();
        logger.info("async timer execute in {} ms", t2 - t1);
    }    @Component
    public static class AsyncTask {        private static final Logger logger = LoggerFactory.getLogger(AsyncTask.class);        @Async
        public void doAsyncWork() {            long t1 = System.currentTimeMillis();            try {
                Thread.sleep((long) (Math.random() * 5000));
            } catch (InterruptedException e) {
            }            long t2 = System.currentTimeMillis();
            logger.info("async task execute in {} ms", t2 - t1);
        }
    }

示例代码中，AsyncTask 等待一段随机时间后结束。
而 AsyncTimer 执行了 task.doAsyncWork，将提前返回。

执行结果如下：

- async timer execute in 2 ms
- async task execute in 3154 ms

这里需要注意一点，异步的实现，其实是通过 Spring 的 AOP 能力实现的。
对于 AsyncTask 内部方法间的调用却无法达到效果。

定制 @Async 线程池

对于 @Async 线程池的定制需使用 AsyncConfigurer接口。

代码如下：

    @Configuration
    @EnableAsync
    public static class ScheduleConfig implements AsyncConfigurer {        @Bean
        public ThreadPoolTaskScheduler taskScheduler() {
            ThreadPoolTaskScheduler scheduler = new ThreadPoolTaskScheduler();            //线程池大小
            scheduler.setPoolSize(60);
            scheduler.setThreadNamePrefix("AsyncTask-");
            scheduler.setAwaitTerminationSeconds(60);
            scheduler.setWaitForTasksToCompleteOnShutdown(true);            return scheduler;
        }        @Override
        public Executor getAsyncExecutor() {            return taskScheduler();
        }        @Override
        public AsyncUncaughtExceptionHandler getAsyncUncaughtExceptionHandler() {            return null;
        }

    }

作者：美码师
链接：https://www.jianshu.com/p/3abdc88549d9