服务器配置与管理-​如何在O2OA中使用MySQL数据库？

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安装过程：

下载和安装数据库的知识并不在本博客讲述的范围，请大家百度相关的技术文章完成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

二、O2OA配置修改

1、停用内置H2数据库

配置文件路径：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":{
   ...
  }
}

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

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

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.<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即可。

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

[
	{
		"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.重启服务器使用旧版本驱动包.