nacos 达梦 dameng 数据源 插件 开发(不用改源码,仅扩展插件包)

1,458 阅读2分钟

本文涉及源码地址:gitee.com/tangjingsha…


一、快速白嫖

1)配置达梦数据库

1.1 创建名称为:NACOS,的模式/用户

1.2 导入以下表结构

此表结构未用引号括起来,不区分大小写

📎NACOS2.2.0的DM表结构.sql

或从以下链接下载:gitee.com/tangjingsha…

2)导出旧数据

2.1 导出旧数据压缩包

3)配置nacos

3.1 切换到nacos根目录

cd /home/shsnc/snc_product/nacos

3.2 新建文件夹:plugins

mkdir plugins

3.3 上传以下插件包到plugins目录下

gitee.com/tangjingsha…

3.4 修改配置文件application.properties

vim ./conf/application.properties

新增以下配置,注意修改DM数据库相关配置,与【步骤1.1保】持一致。其他不用改

#指定数据源为dm
spring.sql.init.platform=dm
#指定数据源驱动
db.pool.config.driverClassName=dm.jdbc.driver.DmDriver
db.num=1

#DM数据库相关配置
db.url.0=jdbc:dm://127.0.0.1:5236/NACOS?characterEncoding=utf8&connectTimeout=1000&socketTi
meout=3000&autoReconnect=true&useUnicode=true&useSSL=false&serverTimezone=UTC
db.user.0=xxx
db.password.0=xxx

3.5 重启nacos

sh ./bin/startup.sh -m standalone

4)导入旧数据

4.1 登录【步骤3.5】启动的达梦nacos

4.2 新建命名空间:xxx

4.3 切换到xxx命名空间

4.4 导入【步骤2.1】的旧数据压缩包

5)验证

5.1 查看【步骤1.1】的DM数据库中的CONFIG_INFO表,是否有刚刚导入的数据

5.2 查看【服务管理-服务列表】菜单是否有服务实例信息

5.3 登录我们系统,验证基础流程是否正常

二、核心原理

1)如何加载插件jar包(loader.path机制)

启动脚本会指定插件包位置为:-Dloader.path=${BASE_DIR}/plugins

loader.path机制为打包插件spring-boot-maven-plugin提供的,该机制下实际启动类会变成org.springframework.boot.loader.PropertiesLauncher#main,且类会由org.springframework.boot.loader.LaunchedURLClassLoader这个类加载器加载

2)如何低耦合扩展不同数据源(SPI机制)

a. 抽取各个表的sql接口,不同的数据源实现返回不同语法的sql

b. ServiceLoader加载插件包

源码位置:com.alibaba.nacos.plugin.datasource.MapperManager#loadInitial

c. 根据配置的数据源类型,获取当前表的Mapper实现类

源码位置:com.alibaba.nacos.plugin.datasource.MapperManager#findMapper

三、插件编写

具体源码见:gitee.com/tangjingsha…

大致实现步骤如下:

1)新建一个项目,并实现xxxMapper接口

参考mysql的实现位置:com.alibaba.nacos.plugin.datasource.impl.mysql,去继承mysql的所有Mapper实现类extends xxxMapperByMySql implements ConfigInfoAggrMapper

继承mysql的原因:

  • DM与mysql语法大致一样,后续即使升级nacos,可能也不需要更改插件包(因为xxxMapperByMySql已经实现了)
  • DM有特殊语法的话,重写父类方法即可

2)编写SPI配置文件

文件位置:/src/main/resources/META-INF/services/com.alibaba.nacos.plugin.datasource.mapper.Mapper

3)引入DM数据源驱动

<dependency>
    <groupId>com.dameng</groupId>
    <artifactId>DmJdbcDriver18</artifactId>
    <version>${dm-connector-java.version}</version>
</dependency>  

4)打包包含驱动依赖的jar包

四、FAQ

1)如何启动nacos源码

2)更改插件代码后,如何重新打包

3)IDEA指定loader.path 无效

IDEA直接启动nacos不会用到org.springframework.boot.loader.PropertiesLauncher#main来启动程序,如果要支持,需要额外的配置,暂不深究

解压nacos-server.jar可以发现PropertiesLauncher才存在

  • 如何调试本地插件模块

4)windows本地启动nacos可能会报错

  • 报错截图
  • 解决

下载www.microsoft.com/zh-cn/downl…并安装即可