SpringBoot 整合SpringBatch实际项目改造

SpringBoot整合SpringBatch项目,已将代码开源至github,访问地址:https://github.com/cmlbeliever/SpringBatch 欢迎star or fork!

最近由于项目需要开始研究SpringBatch,并且将其整合到SpringBoot中,去除繁杂的xml配置,使用注解,基于约定优于配置的思路进行整合。做到可以非常简单的根据业务需求进行配置,添加新的Batch。

该项目的主要整合了Spring,SpringBoot,Mybatis,DBCP等常用框架,支持DB读写分离。一个注解即可添加新的Batch。

Batch配置约定说明:

1、/db目录下的sql为当前项目所用到的ddl

2、项目运行参数说明

  • batchName(required) : 该batch名称,例如运行bat00X,则参数为:batchName=bat00X
  • logging.config(optional) : log配置所在的位置,通常本地运行时不需要关心此参数。在发布到开发机或本番时需要传入。格式:logging.config=${filePath},例如运行bat00X,则参数为:logging.config=classpath:logback-bat00X.xml

3、src/main/java工程结构说明

  • com.cml.learning.framework 为框架基础配置包,通常情况不做修改
  • com.cml.learning.module 为每个batch对应的模块信息,需要开发者自己实现

4、src/main/resource工程结构说明

  • application.properties 全局配置properties
  • logback.xml 默认的log配
  • config/jdbc-r.properties 只读db配置
  • config/jdbc-rw.properties 读写db配置
  • config/log 每个batch对应的log配置
  • config/module 每个batch对应的properties配置信息

5、项目约定说明

  • 每个batch类都需要添加注解@BatchAnnotation用于标识batch运行环境
  • 每个batch对应有自己的Configuration,用于配置SpringBatch运行信息

  • 所有batch统一在包(com.cml.learning.module)下,根据batch名称定义包名

    如: com.cml.learning.module.batch001

  • 每个batch继承com.cml.learning.framework.module.BaseModule并且实现接口 com.cml.learning.framework.constant.ModuleConst

  • 只读Mapper需要继承com.cml.learning.framework.mybatis.marker.ReadMapper,并且Mapper名称以ReadMaper结尾
  • 只读Mapper对应的xml以read.sql.xml结尾,且名称为当前batch名,例如bat001的只读xml为:bat001.read.sql.xml
  • 读写Mapper需要继承com.cml.learning.framework.mybatis.marker.WriteMapper,并且Mapper名称以WriteMapper结尾
  • 读写Mapper对应的xml以write.sql.xml结尾,并且名称为当前batch名,,例如bat001的读写xml为:bat001.write.sql.xml
  • DB所对应的bean在每个batch下的beans包下,如bat001 对应的bean在包:com.cml.learning.module.bat001.beans下,Mybatis 会自动扫描此包下对应的bean
  • processor,reader,writer都有对应的基类,每个batch下对应的模块都需要继承对应的基类。

该项目会不断完善,如有意见或建议,欢迎提出。

posted @ 2017-02-28 16:27  小小架构师  阅读(1548)  评论(0编辑  收藏  举报