# alarmClockFx

**Repository Path**: lyforvue/alarm-clock-fx

## Basic Information

- **Project Name**: alarmClockFx
- **Description**: javaFX闹钟
- **Primary Language**: Java
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-07-08
- **Last Updated**: 2025-07-09

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README



# alarmClockFx

一个基于 JavaFX 和 Spring Boot 的闹钟应用程序。

## 介绍
alarmClockFx 是一个简单但功能齐全的闹钟应用程序。它结合了 JavaFX 的图形界面与 Spring Boot 的依赖注入和调度功能，提供了一个直观的界面用于设置和管理闹钟。

## 软件架构
该项目主要使用以下技术：
- **JavaFX**: 提供图形用户界面。
- **Spring Boot**: 用于依赖注入、应用上下文管理和定时任务调度。
- **FXML**: 界面布局文件。

主要模块包括：
- **AlarmApplication**: 应用的主类，负责启动 Spring Boot 和 JavaFX。
- **AlarmController**: 控制 JavaFX 界面的交互逻辑。
- **AlarmScheduler**: Spring 管理的定时任务类，负责检查当前时间是否匹配设置的闹钟时间。
- **SpringContextUtil**: 工具类，用于在非 Spring 管理的类中获取 Spring 应用上下文。

## 安装教程
1. 确保系统已安装 **Java 17 或更高版本**。
2. 下载或克隆仓库。
3. 使用 Maven 构建项目：
   ```
   mvn clean install
   ```
4. 运行应用程序：
   ```
   java -jar target/alarmClockFx.jar
   ```
## 启动说明

1.  首先得下载对应sdk版本的javafx的sdk，然后解压到指定位置
2.  需要提前配置VM参数，添加内容--module-path javafxsdk安装目录/lib --add-modules=javafx.controls,javafx.fxml,javafx.media到VM中
![输入图片说明](https://foruda.gitee.com/images/1752044903935364666/ccdbc482_2101999.png "屏幕截图")
3.  在clock-base目录下使用mvn clean javafx:run回车启动，或者使用idea的Run/Debug Configurations配置SpringBoot启动即可
![输入图片说明](image.png)

## 使用说明
1. 启动应用程序后，会显示一个简单的界面。
2. 在界面中设置闹钟的小时和分钟。
3. 点击 **Set** 按钮以激活闹钟。
4. 当系统时间到达设定的闹钟时间时，应用程序会：
   - 播放警报声音。
   - 闪烁窗口并显示警告。
5. 可以通过点击 **Pause** 按钮来暂停闹钟声音。

## 参与贡献
欢迎参与贡献！如果您有改进的想法或发现 bug，请：
1. Fork 仓库。
2. 创建新分支。
3. 提交 Pull Request。

## 特技
- **JavaFX 与 Spring Boot 集成**: 实现了现代化的 GUI 与强大的后端功能。
- **定时检查机制**: 使用 Spring 的定时任务功能每秒检查当前时间是否匹配闹钟时间。
- **界面动画**: 包括跑马灯效果和窗口闪烁/震动提醒。

## 许可证
本项目遵循 MIT 许可证，详情请查看 [LICENSE](LICENSE) 文件。