校园绿色能源监测与管理MIS系统 - 部署和运行指南
系统要求
硬件要求
- 处理器：Intel Core i3 或同等性能的处理器
- 内存：至少 2GB 可用内存
- 硬盘空间：至少 100MB 可用空间
- 显示器：支持 1024x768 或更高分辨率
软件要求
- 操作系统：Windows 10/11, macOS 10.14+, Linux (Ubuntu 18.04+)
- Java环境：Java Development Kit (JDK) 17 或更高版本
- 构建工具：Apache Maven 3.6+ (仅开发环境需要)
环境准备
1. 安装Java运行环境
Windows系统
- 访问 Oracle JDK下载页面
- 下载适用于Windows的JDK 17安装包
- 运行安装程序，按照提示完成安装
- 设置JAVA_HOME环境变量：
setx JAVA_HOME "C:\\Program Files\\Java\\jdk-17" setx PATH "%PATH%;%JAVA_HOME%\\bin"
macOS系统
- 使用Homebrew安装：
brew install openjdk@17 - 或从Oracle官网下载macOS版本的JDK安装包
Linux系统 (Ubuntu为例)
# 更新包管理器
sudo apt update# 安装OpenJDK 17
sudo apt install openjdk-17-jdk# 验证安装
java -version
2. 验证Java环境
安装完成后，在命令行中执行以下命令验证：
java -version
javac -version
应显示类似以下信息：
java version "17.0.1" 2021-10-19 LTS
Java(TM) SE Runtime Environment (build 17.0.1+12-LTS-39)
Java HotSpot(TM) 64-Bit Server VM (build 17.0.1+12-LTS-39, mixed mode, sharing)
项目部署
方式一：使用预编译的JAR包（推荐）
-
获取JAR文件
- 项目已预编译生成可执行JAR包：
target/green-campus-mis-1.0.0.jar
- 项目已预编译生成可执行JAR包：
-
运行应用程序
java -jar green-campus-mis-1.0.0.jar -
创建桌面快捷方式 (Windows)
- 右键点击桌面 → 新建 → 快捷方式
- 输入：
java -jar "C:\\path\\to\\green-campus-mis-1.0.0.jar" - 命名快捷方式为"校园绿色能源MIS系统"
方式二：从源代码构建
-
安装Maven
- 下载Maven：https://maven.apache.org/download.cgi
- 解压到合适目录
- 设置MAVEN_HOME环境变量
-
构建项目
# 进入项目根目录 cd /path/to/green-campus-mis# 清理并构建项目 mvn clean compile# 打包生成可执行JAR mvn package -
运行应用程序
# 运行打包后的JAR文件 java -jar target/green-campus-mis-1.0.0.jar
系统启动流程
1. 应用程序启动
- 双击JAR文件或运行启动命令
- 系统加载Java运行环境
- 初始化Swing界面框架
- 显示登录界面
2. 用户登录
- 在登录界面输入用户名和密码
- 系统验证用户凭据
- 登录成功进入主界面
- 登录失败显示错误信息
3. 主界面功能
- 顶部菜单栏：系统功能导航
- 左侧工具栏：快速访问功能
- 中央内容区：显示当前功能模块
- 底部状态栏：系统状态信息
配置文件说明
application.properties
位于 src/main/resources/application.properties
# 数据库配置（预留扩展）
# database.url=jdbc:mysql://localhost:3306/green_campus
# database.username=root
# database.password=123456# 系统配置
system.name=校园绿色能源监测与管理MIS系统
system.version=1.0.0
system.theme=green
数据初始化
示例数据
系统启动时会自动生成示例数据：
用户数据
- 用户名：admin，密码：admin123（管理员）
- 用户名：teacher，密码：teacher123（教师）
- 用户名：student，密码：student123（学生）
设备数据
- 太阳能板、节能灯具、智能插座等设备信息
- 分布在教学楼、宿舍楼、图书馆等区域
申请数据
- 15条示例申请记录
- 包含设备更换、建议、异常反馈等类型
常见问题解决
问题1：无法启动JAR文件
症状：双击JAR文件无反应
解决方案：
- 检查Java环境是否正确安装
- 使用命令行运行：
java -jar 文件名.jar - 查看错误信息并相应处理
问题2：内存不足错误
症状：java.lang.OutOfMemoryError
解决方案：
# 增加JVM内存分配
java -Xmx512m -jar green-campus-mis-1.0.0.jar
问题3：界面显示异常
症状：界面布局混乱或字体显示异常
解决方案：
- 检查屏幕分辨率设置
- 尝试调整系统显示缩放比例
- 重新启动应用程序
问题4：数据无法保存
症状：操作后数据丢失
解决方案：
- 检查应用程序运行权限
- 确保有足够的磁盘空间
- 重启应用程序
系统维护
日常维护
- 定期备份：备份重要数据文件
- 日志检查：查看系统运行日志
- 性能监控：监控内存和CPU使用情况
数据维护
- 数据清理：定期清理过期数据
- 数据备份：重要数据定期备份
- 数据恢复：掌握数据恢复流程
安全维护
- 权限管理：定期检查用户权限
- 密码策略：强制定期更换密码
- 安全更新：及时应用安全补丁
故障排除指南
启动故障
- 检查Java环境变量设置
- 验证JAR文件完整性
- 查看系统日志文件
运行故障
- 检查系统资源使用情况
- 查看应用程序日志
- 重启应用程序
数据故障
- 检查数据文件权限
- 验证数据文件完整性
- 恢复备份数据
技术支持
获取帮助
- 查看系统内置帮助文档
- 联系系统管理员
- 查看项目文档
问题反馈
- 记录问题发生时的操作步骤
- 保存错误截图和日志信息
- 及时向技术支持人员反馈
文档生成时间：2025-12-28
系统版本：1.0.0