SpringBoot+达梦+Vue实现档案管理系统国产化改造全流程

一、国产化环境准备与基础组件安装

本文档基于银河麒麟V10服务器版进行实操演示,旨在将现有的档案管理系统平滑迁移至国产化技术栈。我们需要在服务器上配置好基础运行环境,包括JDK、Redis和Nginx。

1.1 JDK环境配置

档案管理系统后端通常基于Spring Boot,依赖Java环境。麒麟系统默认自带OpenJDK,但为了稳定性,建议手动安装JDK 1.8。

执行以下命令进行安装和环境变量配置:

 安装 JDK 1.8
yum install -y java-1.8.0-openjdk java-1.8.0-openjdk-devel
验证安装版本
java -version
配置全局环境变量
echo 'export JAVA_HOME=/usr/lib/jvm/java-1.8.0-openjdk' >> /etc/profile
echo 'export PATH=$JAVA_HOME/bin:$PATH' >> /etc/profile
source /etc/profile

1.2 Nginx与Redis服务部署

前端静态资源需要Nginx托管,后端缓存依赖Redis。使用yum直接安装:

 安装 Nginx 和 Redis
yum install -y nginx redis
启动并设置开机自启
systemctl start redis
systemctl enable redis
systemctl start nginx
systemctl enable nginx
测试 Redis 连接
redis-cli ping
返回 PONG 则表示正常

二、达梦数据库安装与初始化

数据库国产化改造的核心是将MySQL/Oracle替换为达梦数据库(DM8)。达梦数据库在语法上高度兼容Oracle,适配相对平滑。

2.1 达梦数据库安装部署

将达梦数据库安装包(如dm8_setup.rpm)上传至服务器/opt目录下。执行以下命令进行静默安装:

 进入安装包目录
cd /opt
执行安装命令,默认安装路径为/opt/dmdbms
rpm -ivh dm8_setup.rpm
初始化环境变量
source /etc/profile

安装完成后,需要使用DM提供的初始化工具来创建数据库实例。假设我们将数据存放在/data/dmdata目录:

 创建数据目录
mkdir -p /data/dmdata
执行初始化脚本(路径根据实际安装情况可能微调)
cd /opt/dmdbms/bin
./dminit path=/data/dmdata page_size=16 charset=1 case_sensitive=0
注册并启动服务
./dm_service_installer.sh -t dmserver -p DMSERVER -i /data/dmdata/dm.ini
systemctl start DmServiceDMSERVER
systemctl enable DmServiceDMSERVER

2.2 数据库实例创建与表结构导入

使用达梦自带的管理工具disql连接数据库并创建专用表空间和用户。注意:达梦默认端口号为5236。

 连接数据库
./disql sysdba/SYSDBA
在 disql 命令行中执行以下 SQL:
创建表空间
CREATE TABLESPACE ARCHIVE_TB DATAFILE '/data/dmdata/ARCHIVE_TB.DBF' SIZE 128 AUTOEXTEND ON NEXT 32 MAXSIZE UNLIMITED;
创建档案管理专用用户
CREATE USER ARCHIVE_USER IDENTIFIED BY "Archive@2024" DEFAULT TABLESPACE ARCHIVE_TB;
授权
GRANT RESOURCE, PUBLIC, VTi TO ARCHIVE_USER;
GRANT CREATE VIEW TO ARCHIVE_USER;
exit;

接下来,将原有的MySQL建表SQL转换为达梦语法。大部分标准SQL无需修改,主要调整自增主键和特定函数。建议使用达梦自带的DM数据迁移工具(DTS)进行图形化迁移,或者手动执行转换后的SQL脚本:

 再次登录以执行业务脚本
./disql ARCHIVE_USER/Archive@2024
执行建表脚本(示例)
start /opt/archive_schema.sql
exit;

三、后端服务国产化适配改造

后端改造主要集中在Maven依赖和数据库配置文件上,无需修改大量业务代码。

3.1 Maven依赖与驱动替换

在项目的pom.xml中,移除MySQL或Oracle的驱动依赖,添加达梦JDBC驱动。如果本地Maven仓库没有达梦驱动,需要手动安装DM安装包下drivers/jdbc/DmJdbcDriver18.jar到本地仓库。




com.dameng
DmJdbcDriver18
8.1.2.192

3.2 数据源配置与代码兼容性调整

修改application.ymlapplication.properties,将数据源信息替换为达梦数据库的配置。

SpringBoot+达梦+Vue实现档案管理系统国产化改造全流程

spring:
datasource:
达梦驱动类名
driver-class-name: dm.jdbc.driver.DmDriver
URL格式:jdbc:dm://ip:port
url: jdbc:dm://127.0.0.1:5236?ARCHIVE_USER
username: ARCHIVE_USER
password: Archive@2024

代码兼容性注意点:

  • 如果使用了MyBatis-Plus,需确保分页插件配置正确,达梦支持标准的分页语法。
  • 检查代码中的DATE_FORMAT等MySQL特有函数,达梦通常使用TO_CHAR或标准SQL语法。
  • 若实体类主键策略为IDENTITY,达梦同样支持自增,但建表时需指定IDENTITY(1,1)

配置完成后,使用Maven打包:

mvn clean package -Dmaven.test.skip=true

四、前端工程构建与Nginx反向代理配置

前端部分主要是调整接口请求地址,并通过Nginx进行高效部署。

4.1 前端环境构建

进入前端项目根目录,修改生产环境的接口配置地址(通常在.env.production文件中),将其指向后端服务地址。

 示例:.env.production
VUE_APP_BASE_API = 'http://192.168.1.100:8080'

执行构建命令生成静态资源:

npm install
npm run build

构建完成后,将dist目录下的所有文件上传至服务器的/usr/share/nginx/html/archive/目录(建议创建独立子目录)。

 在服务器上创建目录
mkdir -p /usr/share/nginx/html/archive
上传文件后,确保权限正确
chown -R nginx:nginx /usr/share/nginx/html/archive
chmod -R 755 /usr/share/nginx/html/archive

4.2 Nginx反向代理配置

编辑Nginx配置文件,设置反向代理解决跨域问题,并配置前端路由History模式支持。

vi /etc/nginx/conf.d/archive.conf

输入以下完整配置内容:

server {
listen       80;
server_name  localhost;
前端静态资源根目录
root /usr/share/nginx/html/archive;
index index.html;
后端接口代理
location /prod-api/ {
proxy_pass http://127.0.0.1:8080/;
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
}
Vue Router History模式配置,防止刷新404
location / {
try_files $uri $uri/ /index.html;
}
error_page   500 502 503 504  /50x.html;
location = /50x.html {
root   /usr/share/nginx/html;
}
}

测试配置文件语法并重载Nginx:

nginx -t
systemctl reload nginx

五、系统启动与功能验证

启动后端Java服务,并进行全链路功能验证。

5.1 后端服务启动

将打包好的Jar包上传至服务器/opt/app目录,使用nohup命令后台启动。

mkdir -p /opt/app
假设 jar 包名为 archive-system.jar
cd /opt/app
启动服务
nohup java -jar archive-system.jar --server.port=8080 > /opt/app/app.log 2>&1 &
查看启动日志,确保 "Started ArchiveApplication" 字样出现
tail -f /opt/app/app.log

5.2 功能验证

打开浏览器,访问服务器IP地址:http://服务器IP

  1. 登录验证:输入管理员账号密码,检查是否能成功请求后端接口并获取Token。
  2. 档案列表查询:进入档案管理模块,验证列表数据能否正常从达梦数据库读取并展示。
  3. 新增档案:执行新增操作,验证数据写入达梦数据库,且主键自增正常。
  4. 文件上传下载:测试附件上传功能,检查文件存储路径权限及下载流是否正常。

若所有功能测试通过,即表示档案管理系统已成功完成国产化版改造与部署。

AI咨询
热线电话

028-85154420

15388110056

全国售前咨询电话

扫码咨询
安答联动微信公众号二维码

微信扫码关注安答联动

申请试用
热线电话
申请试用

安答联动档案管理系统