背景

XXL-Job 默认支持 MySQL 数据库，为了解决多数据库兼容问题，上周做了 Oracle 和 Postgre 的验证测试，本文记录改造 Oracle 的过程及问题。

难料的问题有两个：

1. Oracle 区分大小写，而 MySQL 不区分，直接将数据从 MySQL 数据库传输到 Oracle 连接库中，所有的查询会失效。一直用 MySQL ，把 Oracle 这个基础特性给忘记了。
2. Oracle 数据库所在的服务器时间和 Executor 部署机时间不同步，会导致自动检测上下线失效，时钟同步是分布式系统的一个基本保证。

第一，数据传输

首先，数据传输。还是选择用 Navicat 的数据传输功能，好处是可以保证建表语句与当前的 XXL-Job 版本一致。虽然网上有很多改造 XXL-Job 支持其他数据库的案例，但是版本不一致，最新版本是 2.3.0 ，我选择的也是这个版本，所以还是自己整理初始化 SQL 语句比较保险。

其次，从 Oracle 中导出数据库的建表语句，命名为 xxl-job-oracle.sql。查看 Oracle 的表，看到由于从 MySQL 数据库导入的，所有的表和字段名称都是小写，到了 Oracle 中都被默认加上了转义符号 "" ，会导致查询报 SQL 异常，表或视图不存在。

第三，格式化 xxl-job-oracle.sql，文件，用 EditPlus 打开后直接编辑替换为大写。所有的字段和表名大写后，项目中的 MyBatis 映射查询虽然都是小写，但是会默认转成大写，程序就能正确运行。

第四，还原两条初始化语句 XXL_JOB_GROUP 表中的 APP_NAME 字段，插入数据的内容还是小写，另外一条是 XXL_JOB_USRR 表的数据。

第五，编辑每个表，有几个数值字段，且标识为 Not null 的字段，必须设置默认值。官方给出的 MySQL 建表语句中设置了默认值，但是数据传输到其他数据库时，这项信息就缺失了，所以必须自己调整。

第六，创建自增序列，有 7 张表，需要 7 个下面的序列语句。

create sequence XXL_JOB_GROUP_ID
minvalue 1
maxvalue 999999999999
start with 2
increment by 1
cache 20
cycle;

弄好了建表语句，后面基本上就简单了。

第二步，MyBatis 的 XML 映射

接着是修改 MyBatis 的映射文件，支持 Oracle 的语法，主要体现在：

1. 表别名 AS t 需要替换成 t。
2. MySQL 转义字符 ` 替换成空格。
3. findLogReport 中的包含小写字母别名的字段，需要用双引号转义，保证 SQL 语句正确。
4. 所有的 update 语句中，为字段设置 jdbcType 属性。
5. 所有的 insert 语句中的自增 ID，插入列加 ID，值为序列值，以 Group 为例：

<insert id="save" parameterType="com.xxl.job.admin.core.model.XxlJobGroup" useGeneratedKeys="true" keyColumn="id" keyProperty="id" >
		INSERT INTO xxl_job_group (id, app_name, title, address_type, address_list, update_time)
		values ( XXL_JOB_GROUP_SEQ.NEXTVAL,#{appname}, #{title}, #{addressType}, #{addressList}, #{updateTime} )
	</insert>

6. RegistryMapper 的时间操作，MySQL 的 DATE_ADD 换成 Oracle 的 to_char。

    <select id="findDead" parameterType="java.util.HashMap" resultType="java.lang.Integer" >
		SELECT t.id
		FROM xxl_job_registry t
		WHERE to_char(t.update_time,'yyyy-mm-dd HH24:MI:SS') <![CDATA[ < ]]>to_char(sysdate-#{timeout} /24/60/60,'yyyy-mm-dd HH24:MI:SS')
	</select>
	
	<select id="findAll" parameterType="java.util.HashMap" resultMap="XxlJobRegistry">
		SELECT <include refid="Base_Column_List" />
		FROM xxl_job_registry t
		WHERE to_char(t.update_time,'yyyy-mm-dd HH24:MI:SS') <![CDATA[ > ]]>to_char(sysdate-#{timeout} /24/60/60,'yyyy-mm-dd HH24:MI:SS')
	</select>

7. 分页查询前面包裹一层，例如 Group 表的 pageList

		SELECT * FROM (
		select row_number() over(ORDER BY id DESC) r,<include refid="Base_Column_List" />
		FROM xxl_job_group t
		<trim prefix="WHERE" prefixOverrides="AND | OR" >
			<if test="appname != null and appname != ''">
				AND t.app_name like CONCAT(CONCAT('%', #{appname}), '%')
			</if>
			<if test="title != null and title != ''">
				AND t.title like CONCAT(CONCAT('%', #{title}), '%')
			</if>
		</trim>
		) where r between #{offset}+1 and #{offset}+#{pagesize}

第三步，JDBC 连接修改

首先，pom.xml 添加 Oracle 驱动依赖：

<dependency>
	<groupId>com.oracle</groupId>
	<artifactId>ojdbc6</artifactId>
	<version>11.2.0.3</version>
</dependency>

其次，修改 application.properties 配置，主要是连接地址和 Query 语句：

spring.datasource.url=jdbc:oracle:thin:@IP:1521:orcl
spring.datasource.username=username
spring.datasource.password=password
spring.datasource.driver-class-name=oracle.jdbc.driver.OracleDriver
spring.datasource.hikari.connection-test-query=SELECT 1 FROM DUAL

至此，改造完成，完整的 xml 和 建表语句已经上传 CSDN 资源，单机下载。

启示录

兼容性改造，过程其实很简单，但是涉及到的方方面面也不少，需要逐个检查并修正。还碰到一个低级错误，改造 SQL 的时候，没有删掉原来的 SQL ，随手用 IDEA 的注释，结果还引起了意想不到的的问题。

昨天跟踪了一遍 XXL-Job 自动感应执行器上下线的问题，发现是时钟不一致导致的。自动注册和心跳检测的代码相当简洁，有空会继续分析下它的 JobRegistryHelper 类是如何实现的，只有短短的两百多行，但是值得一看。

整理成本文，希望给需要改造的同行一些启示。