频道栏目
首页 > 程序开发 > 综合编程 > 其他综合 > 正文
Apollo的Oracle适配改动
2019-01-29 14:43:07         来源:万有引力的向下力  
收藏   我要投稿

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-common的application.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属性都要加上GeneratedValue和SequenceGenerator的配置。Apollo的代码中大部分的Entity类是继承自一个BaseEntity基类的,所以要修改的地方并不多。 这几个类需要修改:BaseEntity、ReleaseMessage、InstanceConfig、Instance、UserPO、ConsumerAudit 如下添加GeneratedValue和SequenceGenerator两行:

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-commom的application-properties配置中加上:
spring.jpa.hibernate.globally_quoted_identifiers=true
spring.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修改或者升级也会更新上去。

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

点击复制链接 与好友分享!回本站首页
相关TAG标签 Apollo Oracle
上一篇:爬虫之使用scrapy爬取糗事百科并在txt文件中持久化存储
下一篇:C#高级编程序章
相关文章
图文推荐
点击排行

关于我们 | 联系我们 | 广告服务 | 投资合作 | 版权申明 | 在线帮助 | 网站地图 | 作品发布 | Vip技术培训 | 举报中心

版权所有: 红黑联盟--致力于做实用的IT技术学习网站