本篇介绍如何在 O2OA 平台把内置数据库切换为 MySQL 外部数据库。文中先列先决条件:安装包就绪、有改配置目录的权限、目标库已装且服务器能连通。随后按顺序说明把节点配置里内置数据库的开关关掉,再从样例目录复制外部数据源配置到 config 目录,填写连接地址、账号与口令后启用,注意数据库要先自建、编码按正文要求设置、文件名须去掉类型后缀,改完必须重启服务,并提示驱动不匹配时的处理方向。
O2OA 平台支持 Mysql、Oracle、SQLServer 等第三方数据库,也支持达梦、人大金仓、神州通用等国产数据库。本篇主要介绍如何在 O2OA 中配置第三方数据库。
O2OA 内置 H2 数据库,但系统正式上线运行时,建议改用性能更高的数据库。开发者可将 O2OA 数据库切换至 Mysql 等第三方商用级数据库。本文以 MySQL 数据库为例说明,其他数据库的操作方式类似。
1、下载 O2OA 安装部署程序包(下载地址:https://www.o2oa.net/download.html)或者获取源代码编译成为安装部署程序包(服务器编译请参考:《源码编译-O2Server 服务器源码编译教程》)
2、拥有通过文件系统修改 o2server 目录下文件的权限,因为配置过程中需要修改 O2OA 的配置文件。
3、指定的外部数据库已安装,且部署 O2OA 的服务器能够通过客户端正常访问并操作该数据库(非常重要,请保证网络与端口通畅)。(本文以 MySQL 数据库的配置为例,其他数据库的访问配置可参考 o2server/configSample 目录下相应后缀的配置文件,如 _Oracle、_SQLServer 等。)
下载和安装数据库的知识并不在本博客讲述的范围,请大家百度相关的技术文章完成 Mysql 数据库的安装。建议版本在 Mysql5.7+,推荐 Mysql8(如果使用 MySQL5.7需要替换系统默认的 MySQL 驱动包)。
Mysql 各版本下载请参见:https://blog.csdn.net/kerafan/article/details/78001849
Mysql 安装步骤请参见:http://www.cnblogs.com/sshoub/p/4321640.html
Mysql 修改数据库连接数:https://blog.csdn.net/zhya910702/article/details/48372433
配置文件路径:o2server/config/node_127.0.0.1.json
若没有该文件或 config 文件夹,请自行创建 config 文件夹,并从 o2server/configSample/ 目录中复制 node_127.0.0.1.json 到 o2server/config 目录下。
只有 config 目录下修改配置文件才会生效。
{
"enable": true,
...
"application": {
...
},
"web": {
...
},
"storage": {
...
},
"data": { #内置数据库相关配置,可以修改端口以及是否启用
"enable": true, #修改enable的值为false
"tcpPort": null,
"webPort": null,
"includes": [],
"excludes": []
},
"dumpData":{
...
},
"dumpStorage":{
...
}
}
配置文件路径:o2server/config/externalDataSources.json
若没有该文件,请从 o2server/configSample/ 目录中复制 externalDataSources.json 到 o2server/config 目录下。
只有 config 目录下修改配置文件才会生效。
将其中的 url、username、password 以及 enable 修改为上述 Mysql 的相关信息,例如:
[
{
"url": "jdbc:mysql://127.0.0.1:3306/X?autoReconnect=true&useSSL=false&useUnicode=true&characterEncoding=UTF-8&useLegacyDatetimeCode=false&serverTimezone=GMT%2B8",
"username": "root",
"password": "password",
"includes": [],
"excludes": [],
"enable": true
}
]URL 参数说明如下:
useUnicode: 是否使用Unicode字符集,如果参数characterEncoding设置为gb2312或gbk,本参数值必须设置为true false 1.1g
characterEncoding: 当useUnicode设置为true时,指定字符编码。比如可设置为gb2312或gbk false 1.1g
autoReconnect: 当数据库连接异常中断时,是否自动重新连接? false 1.1
autoReconnectForPools: 是否使用针对数据库连接池的重连策略 false 3.1.3
failOverReadOnly: 自动重连成功后,连接是否设置为只读? true 3.0.12
maxReconnects: autoReconnect设置为true时,重试连接的次数 3 1.1
initialTimeout: autoReconnect设置为true时,两次重连之间的时间间隔,单位:秒 2 1.1
connectTimeout: 和数据库服务器建立socket连接时的超时,单位:毫秒。 0表示永不超时,适用于JDK 1.4及更高版本 0 3.0.1
socketTimeout: socket操作(读写)超时,单位:毫秒。 0表示永不超时 0 3.0.1
serverTimezone: 服务器时区(避免数据与正确时间相关8小时的问题)
注:数据库连接 URL 中的数据库 X 需预先创建,O2Server 会自动创建数据表,但不会自动创建数据库。
数据库编码请设置为 utf8mb4
o2server/configSample 目录中也提供了一些常见数据库的连接示例,如下图所示:
开发者可将相应后缀的文件 COPY 到 config 目录中修改,但需注意配置文件名称要去掉数据库类型后缀才会生效,正确的外部数据库配置文件名称为 externalDataSources.json。
设置完成后,必须要重启 o2server 服务。
启动后,命令控制台显示数据库驱动类已经过期,如下图所示,Mysql8.0.22启动后显示。但是 MySQL Workbench 链接数据库是 OK 的:
Loading class `com.mysql.jdbc.Driver'. This is deprecated. The new driver class is `com.mysql.cj.jdbc.Driver'. The driver is automatically registered via the SPI and manual loading of the driver class is generally unnecessary.
或者报错:
Loading class `com.mysql.jdbc.Driver'. This is deprecated. The new driver class is `com.mysql.cj.jdbc.Driver'. The driver is automatically registered via the SPI and manual loading of the driver class is generally unnecessary.九月 01, 2020 10:22:44 上午 com.alibaba.druid.pool.DruidDataSource error严重: init datasource error, url: jdbc:mysql://127.0.0.1:3306/X?autoReconnect=true&useUnicode=true&characterEncoding=UTF-8&useLegacyDatetimeCode=false&serverTimezone=GMT%2B8java.sql.SQLNonTransientConnectionException: Could not create connection to database server. Attempted reconnect 3 times. Giving up. at com.mysql.cj.jdbc.exceptions.SQLError.createSQLException(SQLError.java:110) at com.mysql.cj.jdbc.exceptions.SQLError.createSQLException(SQLError.java:97) at com.mysql.cj.jdbc.exceptions.SQLError.createSQLException(SQLError.java:89) at com.mysql.cj.jdbc.exceptions.SQLError.createSQLException(SQLError.java:63) at com.mysql.cj.jdbc.exceptions.SQLError.createSQLException(SQLError.java:73) at com.mysql.cj.jdbc.ConnectionImpl.connectWithRetries(ConnectionImpl.java:905) at com.mysql.cj.jdbc.ConnectionImpl.createNewIO(ConnectionImpl.java:830) at com.mysql.cj.jdbc.ConnectionImpl.<init>(ConnectionImpl.java:455) at com.mysql.cj.jdbc.ConnectionImpl.getInstance(ConnectionImpl.java:240) at com.mysql.cj.jdbc.NonRegisteringDriver.connect(NonRegisteringDriver.java:199) at com.alibaba.druid.filter.FilterChainImpl.connection_connect(FilterChainImpl.java:156) at com.alibaba.druid.filter.stat.StatFilter.connection_connect(StatFilter.java:218) at com.alibaba.druid.filter.FilterChainImpl.connection_connect(FilterChainImpl.java:150) at com.alibaba.druid.pool.DruidAbstractDataSource.createPhysicalConnection(DruidAbstractDataSource.java:1646) at com.alibaba.druid.pool.DruidAbstractDataSource.createPhysicalConnection(DruidAbstractDataSource.java:1710) at com.alibaba.druid.pool.DruidDataSource.init(DruidDataSource.java:939
可以修改 Mysql 连接的数据库驱动类名。
可在 externalDataSources.json 文件中添加 driverClassName 属性,修改数据库驱动类名。以 Mysql8 为例:
[
{
"url": "jdbc:mysql://127.0.0.1:3306/X?useUnicode=true&characterEncoding=UTF-8&serverTimezone=UTC",
"username": "root",
"password": "password",
"driverClassName": "com.mysql.cj.jdbc.Driver",
"includes": [],
"excludes": [],
"enable": true
}
]设置完成后,重启 o2server 即可。
如果使用低版本的 MySQL,需要手工替换驱动程序。
1、在 o2server/commons/ext 目录(根据 O2OA 版本不同,该目录可能名为 ext_java11)下删除 mysql 驱动程序 jar 包,例如 mysql-connector-java-8.0.15.jar,它是系统自带的驱动程序包。
2、将低版本的驱动程序 jar 包(例如 mysql-connector-java-5.1.43.jar)拷贝到 o2server/custom/jars 目录下。
3、修改 o2server/commons/ext 目录(根据 O2OA 版本不同,该目录可能名为 ext_java11)中的 jar 包注册文件,如下图所示:
修改 mainifest.cfg 文件内容,删除原有的 jar 包名称,添加新的 jar 包名称并保存。
如下图所示:
若不修改 mainifest.cfg,刚放入 ext 目录中的文件会在系统启动时被系统文件检查机制删除,导致系统启动时找不到指定的 jar 包而报错。
4、在externalDataSources.json配置文件中标识使用的驱动程序类,MySQL5使用 com.mysql.jdbc.Driver,按指定版本数据库的 JDBC 连接要求修改好配置文件。如果数据库连接字符串不知道怎么写,可以百度一下。
[
{
"url": "jdbc:mysql://127.0.0.1:3306/X?autoReconnect=true&useSSL=false&useUnicode=true&characterEncoding=UTF-8&useLegacyDatetimeCode=false&serverTimezone=GMT%2B8",
"username": "root",
"password": "password",
"includes": [],
"excludes": [],
"enable": true,
"driverClassName": "com.mysql.jdbc.Driver"
}
]5、重启服务器,使用旧版本驱动包。
相关问题讨论
如何在 O2OA 中使用 Mysql 等数据库?
O2OA 平台支持第三方数据库,如 Mysql,Oracle,SQLServer 以及国产达梦,人大金仓,神州通用数据库等。
查看原帖讨论 · 9,407 次浏览
o2oa 连接 mysql 数据时报 com.mysql.cj.jdbc.Driver 的问题求解
4、在 externalDataSources.json 配置文件中标识使用的驱动程序类,MySQL5使用 com.mysql.jdbc.Driver,按指定版本数据库的 JDBC 连接要求修改好配置文件。
查看原帖讨论 · 18,599 次浏览
相关内容