# chineses-days

**Repository Path**: lengton/chineses-days

## Basic Information

- **Project Name**: chineses-days
- **Description**: Java获取法定节假日数据，每年自动更新数据
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 0
- **Created**: 2025-04-08
- **Last Updated**: 2026-04-10

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README



根据项目代码结构和组件信息，我将为您生成一个README.md文件。以下是该文件的完整内容：

```markdown
# ChineseDays 项目说明

这是一个基于 Spring Boot 的 Java 项目，主要用于获取和解析中国节假日及调休信息，并将数据存储到数据库中以供查询。

## 项目功能

- 从网络获取节假日数据
- 解析节假日数据并提取日期范围及调休信息
- 将解析后的数据写入数据库
- 提供 REST API 查询特定年份、月份或具体日期的节假日信息

## 技术栈

- Java 8+
- Spring Boot
- MyBatis Plus
- HTTPClient
- Gson
- Gitee（代码托管）

## 主要组件

- `ChineseDaysApplication`: Spring Boot 主启动类，启用定时任务和 MyBatis Mapper 扫描。
- `ChineseDayController`: REST 控制器，提供对外接口，支持按年、月、日查询节假日。
- `IChineseDayService` 和 `ChineseDayServiceImpl`: 服务接口和实现，处理业务逻辑。
- `ChineseDayMapper`: 数据库访问接口，用于操作节假日数据。
- `HolidayFetcher`: 工具类，负责从网络获取节假日数据。
- `HolidayParser`: 工具类，解析节假日文本为结构化数据。
- `getDaysAndWriteFile`: 负责获取数据并写入数据库，包含事务管理。
- `getHolidaysTask`: 定时任务类，定期获取节假日数据并更新数据库。

## 数据结构

- `ChineseDay`: 数据库实体类，表示节假日信息，包含日期、备注、是否工作日等字段。
- `DateRangeDTO`: 数据传输对象，用于封装节假日日期范围。
- `chineseDaysVO`: 视图对象，用于向前端返回格式统一的数据。

## 使用方法

1. 克隆仓库：
   ```bash
   git clone https://gitee.com/your-username/your-repo-name.git
   ```

2. 修改配置：
   - 在 `application.yml` 中配置数据库连接和节假日 API 的地址。

3. 启动项目：
   ```bash
   ./mvnw spring-boot:run
   ```

4. 访问接口：
   - `GET /chinese-days/{year}`: 获取某年的所有节假日。
   - `GET /chinese-days/{year}/{month}`: 获取某年某月的节假日。
   - `GET /chinese-days/{year}/{month}/{day}`: 获取某年某月某日的节假日信息。

## 许可证

本项目使用 MIT 许可证，详情请参考 [LICENSE](LICENSE) 文件。

## 贡献指南

欢迎提交 Pull Request 或提出 Issue。请遵循项目的代码规范并确保测试通过。

## 联系方式

如有任何问题或建议，请联系 [your-email@example.com](mailto:your-email@example.com)。
```
```