项目使用手册

快速开始

一、打包项目

在项目根目录执行：

mvn clean package -DskipTests

执行成功后，会在 target 目录生成 simple.jar 文件。

二、部署应用

将以下文件复制到部署服务器：

部署目录/
├── simple.jar          (从 target 目录复制)
└── startup.bat         (从项目根目录复制)

三、修改数据库配置

用文本编辑器打开 startup.bat，修改以下配置：

REM 数据库连接配置
set DB_URL=jdbc:sqlserver://你的数据库IP:端口;databaseName=数据库名;encrypt=true;trustServerCertificate=true
set DB_USERNAME=数据库用户名
set DB_PASSWORD=数据库密码

配置示例：

REM 示例1：本地数据库
set DB_URL=jdbc:sqlserver://localhost:1433;databaseName=TEST_MES;encrypt=true;trustServerCertificate=true
set DB_USERNAME=sa
set DB_PASSWORD=123456

REM 示例2：远程数据库
set DB_URL=jdbc:sqlserver://192.168.1.100:1433;databaseName=MES_PROD;encrypt=true;trustServerCertificate=true
set DB_USERNAME=mesuser
set DB_PASSWORD=P@ssw0rd

四、初始化数据库

在SQL Server中执行建表脚本（首次部署）：

-- 1. 创建数据库（如果不存在）
CREATE DATABASE TEST_MES;
GO

USE TEST_MES;
GO

-- 2. 执行建表脚本
-- 运行项目中的 MES_SIMPLE_CREATE_TABLE.sql
-- 运行项目中的 MES_SIMPLE_CCB_CREATE_TABLE.sql

五、启动应用

双击运行 startup.bat 即可启动应用。

启动成功后，应用会监听 9091 端口。

六、验证应用

在浏览器访问：

http://localhost:9091/simple/getTree

或使用Postman发送POST请求测试：

POST http://localhost:9091/simple/getTree
POST http://localhost:9091/simple/list

配置说明

数据库连接参数说明

参数	说明	示例
服务器地址	SQL Server的IP或域名	`192.168.0.51` 或 `localhost`
端口	默认1433	`1433`
数据库名	要连接的数据库	`TEST_MES`
用户名	数据库登录用户	`sa`
密码	数据库登录密码	`LanBao@2025`

Java环境要求

如果服务器没有安装Java 17，需要在 startup.bat 中指定Java路径：

REM 修改为实际的Java安装路径
set JAVA_HOME=C:\Program Files\Java\jdk-17

常见问题

1. 启动失败：找不到JAR文件

错误信息：
[ERROR] JAR文件不存在: target\simple.jar

解决方法：
- 确保 simple.jar 和 startup.bat 在同一目录
- 或者在项目根目录运行 startup.bat

2. 数据库连接失败

错误信息：
Cannot create PoolableConnectionFactory

解决方法：
1. 检查数据库服务是否启动
2. 检查数据库IP、端口、用户名、密码是否正确
3. 检查防火墙是否开放1433端口
4. 检查SQL Server是否允许TCP/IP连接

3. 端口被占用

错误信息：
Web server failed to start. Port 9091 was already in use.

解决方法：

修改 startup.bat，添加端口配置：

java -jar ^
  -Dserver.port=8080 ^
  -Dspring.datasource.url="%DB_URL%" ^
  -Dspring.datasource.username=%DB_USERNAME% ^
  -Dspring.datasource.password="%DB_PASSWORD%" ^
  simple.jar

4. 内存不足

解决方法：

在 startup.bat 中添加JVM内存配置：

java -jar ^
  -Xms512m -Xmx1024m ^
  -Dspring.datasource.url="%DB_URL%" ^
  -Dspring.datasource.username=%DB_USERNAME% ^
  -Dspring.datasource.password="%DB_PASSWORD%" ^
  simple.jar

API接口列表

1. 获取菜单树

接口：POST /simple/getTree

说明：获取树形结构的菜单数据

响应示例：
json { "code": 200, "message": "success", "data": [ { "id": 1, "title": "系统管理", "field": "system", "spread": true, "children": [ { "id": 2, "title": "菜单管理", "field": "menu", "href": "/menu/list" } ] } ], "count": 2 }

2. 获取菜单列表

接口：POST /simple/list

说明：获取平铺的菜单列表

响应示例：
json { "code": 200, "message": "success", "data": [ { "id": 2, "isTop": 1, "fid": 1, "title": "菜单管理", "field": "menu", "href": "/menu/list", "spread": 0, "disabled": 0 } ], "count": 5 }

停止应用

按 Ctrl + C 停止运行中的应用。

技术支持

项目版本：1.0.2-SNAPSHOT
Spring Boot版本：3.1.5
Java版本：17
数据库：SQL Server 2019

运行端口：9091

日志位置：控制台输出（可在startup.bat中配置日志文件）

高级配置（可选）

后台运行

如需后台运行，可以修改 startup.bat：

@echo off
start /B java -jar ^
  -Dspring.datasource.url="%DB_URL%" ^
  -Dspring.datasource.username=%DB_USERNAME% ^
  -Dspring.datasource.password="%DB_PASSWORD%" ^
  simple.jar > app.log 2>&1

日志文件输出

java -jar ^
  -Dspring.datasource.url="%DB_URL%" ^
  -Dspring.datasource.username=%DB_USERNAME% ^
  -Dspring.datasource.password="%DB_PASSWORD%" ^
  simple.jar > logs\application.log 2>&1

开机自启动

将 startup.bat 的快捷方式放到：
C:\ProgramData\Microsoft\Windows\Start Menu\Programs\StartUp
或使用Windows任务计划程序设置开机启动任务。