计划任务
本指南将指导您完成使用Spring计划任务(即大家常说的定时任务)的步骤。
What you’ll build
你将构建一个应用程序,使用Spring的’@ Scheduled’注释每五秒打印一次当前时间。
What you’ll need
- 约15分钟
- 最喜欢的文本编辑器或IDE
- JDK 1.8或更高版本
- Gradle 2.3+或Maven 3.0+
- 您也可以从本指南导入代码,以及直接在Spring Tool Suite(STS)中查看网页,并从那 里开始工作 。
How to complete this guide
与大多数Spring 入门指南一样,您可以从头开始并完成每个步骤,也可以绕过已经熟悉的基本设置步骤。 无论如何,你最终得到工作代码。
要从头开始, 请转到使用Gradle构建.
要跳过基本操作,请执行以下操作:
- Download 并解压缩本指南的源代码仓库,或使用 Git:
git clone https://github.com/spring-guides/gs-scheduling-tasks.git
- cd 到
gs-scheduling-tasks/initial
- 跳转到Create a scheduled task.
当你做完这一切, 你可以根据 gs-scheduling-tasks/complete
中的代码检查结果.
Build with Gradle
Build with Maven
Build with your IDE
- 阅读如何通过本指南直接导入Spring Tool Suite。
- 阅读如何在IntelliJ IDEA上使用本指南。
-
创建计划任务
完成项目设置后,您可以创建一个计划任务。
src/main/java/hello/ScheduledTasks.java
1 | package hello; |
Scheduled
注解定义了一个特定方法在何时运行。 注意:此示例使用fixedRate
,它指定从每次调用的开始时间开始测量的方法调用之间的间隔。 有其他选项,如fixedDelay
,其中 指定从任务完成起测量的调用之间的间隔。 您还可以使用@Scheduled(cron=". . .")
表达式来进行更复杂的任务调度.
启用计划任务
尽管计划任务可以嵌入在Web应用程序和WAR文件中,但下面演示的更简单的方法创建了一个独立的应用程序。 你把一切都包装在一个可执行的JAR文件中,由一个大家初学Java时的Javamain()
方法驱动。src/main/java/hello/Application.java
1 | package hello; |
@SpringBootApplication
是一个很方便的注解,查看其源码可以发现添加了以下所有内容:
@Configuration
将类标记为应用程序上下文的bean定义的源。@EnableAutoConfiguration
告诉Spring Boot根据类路径设置,其他bean和各种属性设置开始添加bean。- 通常你会为Spring MVC应用程序添加
@EnableWebMvc
,但是Spring Boot在类路径上看到 spring-webmvc 时会自动添加它。这将应用程序标记为Web应用程序,并激活关键行为,如设置一个“DispatcherServlet”。 @ComponentScan
告诉Spring在hello
包中寻找其他组件,配置和服务,允许它找到控制器。
main()
方法使用Spring Boot的SpringApplication.run()
方法来启动应用程序。你注意到没有一行XML?没有 web.xml 文件。这个Web应用程序是100%纯Java,你不必处理配置任何管道或基础设施。
@EnableScheduling
确保创建了后台任务执行器。没有它,鬼知道什么时候运行定时计划任务,更不用说执行了。
构建可执行JAR
您可以使用Gradle或Maven从命令行运行应用程序。 或者,您可以构建单个可执行文件,其中包含所有必需的依赖关系,类和资源,并运行它。 这使得在整个开发生命周期中,易于跨不同环境将服务作为应用程序进行发布,维护版本和部署等等。
如果您使用Gradle,可以使用./gradlew bootRun
运行应用程序。 或者你可以使用./gradlew build
来构建JAR文件。 然后可以运行JAR文件:
1 | java -jar build/libs/gs-scheduling-tasks-0.1.0.jar |
如果您使用Maven,可以使用 ./mvnw spring-boot:run
.运行应用程序。 或者你可以用./mvnw clean package
构建JAR文件。 然后可以运行JAR文件:
1 | java -jar target/gs-scheduling-tasks-0.1.0.jar |
** | 上面的过程将创建一个可运行的JAR。 您也可以选择build a classic WAR file |
---|---|
将显示日志输出,你可以从日志中看到它在后台线程上运行。 你应该会看到你的预定任务每5秒钟触发一次:
1 | [...] |
最后
恭喜! 您已使用计划任务创建应用程序。此技术适用于任何类型的应用程序。
翻译自:https://spring.io/guides/gs/scheduling-tasks/