关键词:平台配置,O2OA,开源办公系统,第三方数据库,Mysql ,外部数据库,国产数据库

O2OA开发平台支持第三方数据库,如Mysql,Oracle,SQLServer以及国产达梦,人大金仓,神州通用数据库等。本篇主要介绍如何在O2OA中配置第三方数据库。


O2OA内置H2数据库,但系统真正上线使用时,需要更高的数据库性能。此时,可以将O2OA数据库切换到第三方商用级数据库,如Mysql等。本文以MySQL数据库为例进行说明。

一、数据库准备工作 - Mysql数据库安装

下载和安装数据库的知识并不在本博客讲述的范围,请大家百度相关的技术文章完成Mysql数据库的安装。建议版本在Mysql5.7+,推荐Mysql8。
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

二、O2OA配置修改

1、关闭内置数据库

配置文件路径:o2server/config/node_127.0.0.1.json
如果没有该文件,请从目录o2server/configSample/中复制node_127.0.0.1.json文件到o2server/config目录下。
直接在configSample目录下修改配置文件将不会生效。

{
  "enable": true,
  "port":null,
  "sslEnable":false,
  "logLevel":"info",
  "isPrimaryCenter": true,
  "nodeAgentEnable": true,
  "application": {
    "enable": true,
    "port": null,
    "sslEnable": false,
    "proxyHost": "",
    "proxyPort": null,
    "forceRedeploy": true,
    "scanInterval":5,
    "includes":[],
    "excludes":[]
  },
  "web": {
    "enable": true,
    "port": null,
    "sslEnable": false,
    "proxyHost": "",
    "proxyPort": null,
    "forceRedeploy": true
  },
  "storage": {
    "enable": true,
    "port": null,
    "sslEnable": false,
    "name" : ""
  },
  "data": {             #内置数据库相关配置,可以修改端口以及是否启用
    "enable": true,     #修改enable的值为false
    "tcpPort": null,
    "webPort": null,
    "includes": [],
    "excludes": []
  },
  "dumpData":{
    "cron" : "0 0 21 * * ?",
    "size" : 14
  },
  "dumpStorage":{
    "cron" : "0 0 21 * * ?",
    "size" : 14
  }
}

2、开启和配置外部数据库信息

配置文件路径:o2server/config/externalDataSources.json
如果没有该文件,请从目录o2server/configSample/ 中复制externalDataSources.json文件到o2server/config目录下。
直接在configSample目录下修改配置文件将不会生效。
将其中的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会自动创建数据表,但不会自动创建数据库。

设置完成后,重启o2server即可。

3、驱动不匹配问题

启动后,命令控制台显示数据库驱动类已经过期,如下图所示,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%2B8
java.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.(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即可。

4、使用旧版本MySQL(MySQL5.7+)

如果使用低版本的MySQL那么需要手工替换驱动程序.
1.在o2server/commons/ext目录下删除mysql驱动程序jar包比如:mysql-connector-java-8.0.15.jar,这个是系统自带的驱动程序包.
2.将低版本的驱动程序jar包比如mysql-connector-java-5.1.43.jar拷贝到o2server/custom/jars目录下.
3.在externalDataSources.json配置文件中标识使用的驱动程序类,MySQL5使用com.mysql.jdbc.Driver

[
    {
        "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"
    }
]

4.重启服务器使用旧版本驱动包.

推荐文章:

开发知识-神通数据库安装
2021-02-07
一、安装配置界面上:勾选择“兼容Oracle模式”,库字符集“UTF8”,页大小"32K"成功创建神通数据库实例后,系统通常为该实例默认创建三个用户:SYSDB
流程设计-流程数据字典配置介绍
2021-03-23
O2OA提供数据字典来管理业务中的常用配置,让配置可以脱离业务代码或者配置项。本文主要介绍如何在O2OA中进行数据字典配置。
系统安全-启用HTTPS(百度云版)
2021-02-25
为增加系统和用户的安全性,平台支持启用HTTPS,使用SSL对网络流量进行证书加密传输。本篇主要介绍如何将在O2OA中启用HTTPS。
系统维护-如何压缩过大的H2数据库文件
2021-02-25
平台自带的H2数据库在使用过程中会随着数据量的增加而增长,但是并不会在删除数据后自动缩小。所以O2OA提供了数据库压缩命令用于缩小数据库占用的空间。
开发知识-平台中使用Druid数据库连接及监控
2021-02-07
一、o2oa数据库连接及使用原理o2oa使用阿里的druid与数据库进行连接及管控,在平台启动时druid管控了一个共享数据库连接池,默认的最大连接数是50(如
业务开发-组织架构-组织职位信息管理
2021-02-26
O2OA提供多级组织架构设置能力,用户可以在系统内设置集团、分公司、部门、小组等多级企业组织结构来满足办公需要,可以为组织设置不同的职务来实现配置和人员的解耦。
考勤管理
2021-02-19
O2OA考勤管理提供了一个通用的考勤管理,企业可以使用它实现手机打卡,数据导入,数据分析,数据统计。员工可以对考勤分析结果提起申诉,每个考勤周期系统均会出具相关
企业办公首页使用说明
2021-02-19
O2OA企业办公首页的导航栏中,有直观清爽的界面、功能丰富的应用。根据企业办公需求随心使用,包含流程管理、会议管理、组织管理、日程管理等等。
移动办公-将平台集成到企业微信(WeChat)
2021-02-25
O2OA平台拥有配套的原生开发的安卓和IOS移动APP,可以以自建应用的方式集成到企业微信,同步企业微信的企业通讯录作为本地组织人员架构,并且可以将待办等通知直
服务集成-发送用户账号密码进行登录认证
2021-03-02
O2OA提供多种SSO单点认证方式,比如约定密钥,OAuth2,SMAP等等。本文主要演示如何发送用户账号密码进行登录认证。

results matching ""

    No results matching ""