elastic-job-spring-boot-starter介绍
Elastic-Job Spring Boot 自动集成,只需要一个注解即可发布Job。
GitHub地址:https://github.com/yinjihuan/elastic-job-spring-boot-starter
Elastic-Job官方提供了基于Spring和Java代码2种方式的任务配置,刚开始用Elastic-Job的时候我比较喜欢用Spring XML文件的方式来配置任务。
这种方式能够很直观的看到所有的任务信息,结构比较清晰。当Spring Boot全面普及后,于是我们慢慢淡忘了XML配置。
由于官方没有提供Elastic-Job的Spring Boot Starter,于是我抽时间写了一个Starter,目的当然是使用注解简化XML的配置,下面我们就来看看怎么使用吧:
增加elastic-job-spring-boot-starter的Maven依赖
由于目前刚开发完成,也不知道会有多少人需要使用这个Starter,Jar包暂时不传到Maven中央仓库,需要体验的同学直接下载源码编译即可依赖,等后面Star的数量多了起来之后,有比较多的人关注了这个Starter,后面我会传到Maven中央仓库供大家更方便的使用。
<dependency> <groupId>com.cxytiandi</groupId> <artifactId>elastic-job-spring-boot-starter</artifactId> <version>1.0.0</version></dependency>
增加Zookeeper注册中心的配置
elasticJob.zk.serverLists=192.168.10.47:2181elasticJob.zk.namespace=cxytiandi_job2
Zookeeper配置的前缀是elasticJob.zk,详细的属性配置请查看ZookeeperProperties
开启Elastic-Job自动配置
开启自动配置只需要在Spring Boot的启动类上增加@EnableElasticJob注解
import java.util.concurrent.CountDownLatch;import org.springframework.boot.autoconfigure.SpringBootApplication;import org.springframework.boot.builder.SpringApplicationBuilder;import com.cxytiandi.elasticjob.annotation.EnableElasticJob;/** * ElasticJob Spring Boot集成案例 * * @author yinjihuan * * @about http://cxytiandi.com/about * */@SpringBootApplication@EnableElasticJobpublic class JobApplication { public static void main(String[] args) { new SpringApplicationBuilder().sources(JobApplication.class).web(false).run(args); try { new CountDownLatch(1).await(); } catch (InterruptedException e) { } } }
配置任务
@ElasticJobConf(name = "MySimpleJob", cron = "0/10 * * * * ?", shardingItemParameters = "0=0,1=1", description = "简单任务")public class MySimpleJob implements SimpleJob { public void execute(ShardingContext context) { System.out.println(2/0); String shardParamter = context.getShardingParameter(); System.out.println("分片参数:"+shardParamter); int value = Integer.parseInt(shardParamter); for (int i = 0; i < 1000000; i++) { if (i % 2 == value) { String time = new SimpleDateFormat("HH:mm:ss").format(new Date()); System.out.println(time + ":开始执行简单任务" + i); } } } }
任务的配置只需要在任务类上增加一个ElasticJobConf注解,注解中有很多属性,这些属性都是任务的配置,详细的属性配置请查看ElasticJobConf
到此为止,我们就快速的使用注解发布了一个任务,DataflowJob和ScriptJob的使用方式一样。
使用示列参考:elastic-job-spring-boot-example
事件追踪功能使用
事件追踪功能在注解中也只需要配置eventTraceRdbDataSource=你的数据源 就可以使用了,数据源用什么连接池无限制,唯一需要注意的一点是你的数据源必须在spring-boot-elastic-job-starter之前创建,因为spring-boot-elastic-job-starter中依赖了你的数据源,下面我以druid作为连接池来进行讲解。
引入druid的Spring Boot Starter,GitHub地址:druid-spring-boot-starter
<dependency> <groupId>com.alibaba</groupId> <artifactId>druid-spring-boot-starter</artifactId> <version>1.1.2</version></dependency>
配置连接池属性:
spring.datasource.druid.log.url=jdbc:mysql://localhost:3306/event_logspring.datasource.druid.log.username=root spring.datasource.druid.log.password=123456spring.datasource.druid.log.driver-class-name=com.mysql.jdbc.Driver
然后在项目中定义一个配置类,配置连接池,手动配置的原因是连接池可以在elastic-job-starter之前被初始化。
@Configurationpublic class BeanConfig { /** * 任务执行事件数据源 * @return */ @Bean("datasource") @ConfigurationProperties("spring.datasource.druid.log") public DataSource dataSourceTwo(){ return DruidDataSourceBuilder.create().build(); } }
然后在注解中增加数据源的配置即可:
@ElasticJobConf(name = "MySimpleJob", cron = "0/10 * * * * ?", shardingItemParameters = "0=0,1=1", description = "简单任务", eventTraceRdbDataSource = "datasource")
application.properties中配置任务信息
使用注解是比较方便,但很多时候我们需要不同的环境使用不同的配置,测试环境跟生产环境的配置肯定是不一样的,当然你也可以在发布之前将注解中的配置调整好然后发布。
为了能够让任务的配置区分环境,还可以在属性文件中配置任务的信息,当属性文件中配置了任务的信息,优先级就比注解中的高。
首先还是在任务类上加@ElasticJobConf(name = "MySimpleJob")注解,只需要增加一个name即可,任务名是唯一的。
剩下的配置都可以在属性文件中进行配置,格式为elasticJob.任务名.配置属性=属性值
elasticJob.MySimpleJob.cron=0/10 * * * * ? elasticJob.MySimpleJob.overwrite=trueelasticJob.MySimpleJob.shardingTotalCount=1 elasticJob.MySimpleJob.shardingItemParameters=0=0,1=1 elasticJob.MySimpleJob.jobParameter=testelasticJob.MySimpleJob.failover=trueelasticJob.MySimpleJob.misfire=trueelasticJob.MySimpleJob.description=simple job elasticJob.MySimpleJob.monitorExecution=falseelasticJob.MySimpleJob.listener=com.cxytiandi.job.core.MessageElasticJobListener elasticJob.MySimpleJob.jobExceptionHandler=com.cxytiandi.job.core.CustomJobExceptionHandler elasticJob.MySimpleJob.disabled=true
Script任务使用说明
由于Script任务的执行逻辑是在具体的脚本中,是通过scriptCommandLine来指定执行脚本的路径。我这边为了统一的去发现项目中的任务列表,还是需要建一个脚本的Java类,加上ElasticJobConf注解,只是不需要写逻辑而已,示例如下:
/** * 脚本任务不需要写逻辑,逻辑在被执行的脚本中,这边只是定义一个任务而已 * @author yinjihuan * */@ElasticJobConf(name = "MyScriptJob")public class MyScriptJob implements ScriptJob { public void execute(ShardingContext context) { } }
配置:
elasticJob.MyScriptJob.cron=0/10 * * * * ? elasticJob.MyScriptJob.overwrite=trueelasticJob.MyScriptJob.scriptCommandLine=D:\\apache-tomcat-addrepo-allcity\\bin\\startup.bat
Spring XML配置代码示例
https://github.com/yinjihuan/spring-cloud/tree/master/fangjia-job
作者:尹吉欢
链接:https://www.jianshu.com/p/dd3c5b7d7694