Apollo的Oracle适配改动

这几天工作需要使用Apollo配置中心。Apollo唯一的依赖是MySQL数据库,然而公司只有Oracle数据库资源。这里有一个Oracle适配改动的分支,但是它是基于0.8.0版本的Apollo。看着Apollo官方文档上各种特性都只有1.0.0以上版本才有,我决定基于当前最新版本(1.2.0)自己改一波。

基础

在开始改动前我们需要了解Apollo工程的整体结构,以及调试启动的方法。建议本地先搭建个MySQL库,然后把Apollo跑起来看看。官方对此有详细的文档

另外,从MySQL到Oracle,一个比较大的问题是Apollo中很多表名、字段名和Oracle的关键字有冲突,导致无法在Oracle建表。这个问题可以使用双引号来解决。我们知道,Oracle的SQL语句在解释时会把所有的字符都转为大写(字符串常量除外),所以我们一般认为Oracle的SQL语法不区分大小写。比如说我可以用如下SQL建表:

create TaBle aPplicAtiOn(...);

最终我们会得到一张名为APPLICATION的表。在一些情况下,我们会需要区分大小写的表名,这时候我们可以在建表时用双引号将表名括起来:

create TaBle ‘aPplicAtiOn‘(...);

这样,我们就真正得到了名为aPplicAtiOn的表了。同理,字段名、同名等Oracle对象也都可以用双引号来区分大小写。关于Oracle双引号,这里有更多的讲解。

Oracle适配改动

下面的改动大部分是参考已有的vanpersl/apollo基于0.8.0的Oracle版本的代码。这里是他的修改内容。

总体来说改动量不大。我大约花了一天的时间完成了整个改动。下面是改动步骤。

准备数据库用户

  • 准备两个Oracle用户(Oracle用户相当于MySQL的库),分别用于存放配置数据(假设这个用户叫ApolloConfig)和管理数据(假设这个用户叫ApolloPortal)。配置数据和管理数据有很多表名是相同的,所以必须使用两个用户。你也可以使用两个现有的用户,但是要注意不要和现有的表冲突了。
  • 使用Oracle的SQL脚本建表。这里是我整理后的两个SQL脚本,ApolloConfig用户执行apolloconfigdb.sql脚本,ApolloPortal用户执行apolloportaldb.sql脚本。

Apollo工程加入ojdbc的依赖

  • 我测试了ojdbc6和ojdbc7是可以使用的,而ojdbc12则会报版本太低的错误。我最后使用的ojdbc6,因为我最后测试的是ojdbc6就懒得再换了。
  • 另外,我在做这一步的时候发现使用Maven源的ojdbc包是无法启动项目的。只能到Oracle官网下载jar包,然后本地引用。ojdbc的依赖添加到parent项目和apollo-common项目。

修改数据库连接配置

  • 新建好Oracle的库后,将Apollo配置中原本MySQL的连接配置改为Oracle的连接配置——注意,根据你的部署方式,可能需要修改两处或者三处的连接配置。
spring.datasource.url=jdbc:oracle:thin:@{ip}:{port}:{db}spring.datasource.username={ApolloConfig|ApolloPortal}spring.datasource.password={password}

添加Oracle配置。

这些配置改动在apollo-commonapplication.properties配置文件。

  • 添加配置spring.datasource.driver-class-name=oracle.jdbc.driver.OracleDriver指定使用Oracle驱动
  • 如果你的Oracle版本在11c以下(比如10g或者11g),那么还需要添加spring.jpa.properties.hibernate.dialect=org.hibernate.dialect.Oracle10gDialect。否则Hibernate会生成fetch first ? rows only之类的11c才支持的语句导致SQL执行错误。
  • 其他的连接池之类的配置。

Sequence

  • Apollo的表使用的自增ID作为主键。Oracle没有直接支持自增ID的功能,必须通过Sequence实现。在建表的SQL里已为两个库分别建了名为ID_SEQ的Sequence。代码中所有的Entity类的id属性都要加上GeneratedValueSequenceGenerator的配置。Apollo的代码中大部分的Entity类是继承自一个BaseEntity基类的,所以要修改的地方并不多。
    • 这几个类需要修改:BaseEntityReleaseMessageInstanceConfigInstanceUserPOConsumerAudit
    • 如下添加GeneratedValueSequenceGenerator两行:
public abstract class BaseEntity {    @Id    @GeneratedValue(strategy = GenerationType.SEQUENCE, generator = ‘sequence‘)    @SequenceGenerator(name = ‘sequence‘, sequenceName = ‘ID_SEQ‘, allocationSize = 1)    @Column(name = ‘Id‘)    private long id;    ...}

Oracle关键字的问题

这部分的改动最多,也最枯燥。合理利用IDE的replace功能可以极大的提高修改效率。

  • 由于原本MySQL的表名列名用了很多Oracle的关键字,所以转到Oracle时所有的表名列名都用双引号括起来。可在apollo-commomapplication-properties配置中加上:
spring.jpa.hibernate.globally_quoted_identifiers=truespring.jpa.properties.hibernate.globally_quoted_identifiers=true

这样Hibernate的ORM生成SQL语句时就会自动给表名列名都加上双引号。

  • 另外,一些在注解里的类SQL语句用到的字段要手工加上双引号。大概有以下这些地方:
    • @SQLDelete和@Where的地方
    • AuthConfiguration.java中有一堆直接写SQL的
    • 所有的isDeleted和id都要改首字母大写
    • Namespace有个appId,Item有个key、value、comment,GreyReleaseRule有appId和releaseId
    • 其他我还没发现的犄角旮旯

成果

我最后修改的结果上传在这里:https://github.com/sKabYY/apollo
目前已经平稳运行。后面如果有bug修改或者升级也会更新上去。

和原代码的对比可以看这里

Apollo的Oracle适配改动

上一篇:mysql8.0安装与配置


下一篇:windows和linux删除文件方法