一、开源项目简介

Spring-boot-holiday-starter v1.0.0

一个轻量级节假日判断的小工具！

Spring-boot-holiday-starter 一个轻量级节假日判断的小工具，主要解决：获取节假日数据 和 判断是否是节假日。

二、开源协议

使用Apache-2.0开源协议

三、界面展示

四、功能概述

前言

由于项目原因，服务器无网络访问权限，在一些场景下需要判断是否是节假日，所以写了一个工具类，方便使用。

Spring-boot-holiday-starter：一个轻量级节假日判断的小工具！日期判断 工作日，补班日，节假日，周末。

五、技术选型

Spring-boot-holiday-starter 一个轻量级节假日判断的小工具，主要解决：获取节假日数据 和 判断是否是节假日。

• 支持说明

• spirngboot 2.7 +

• jdk17 +

使用

• yml 配置

holiday:
  ## 节假日数据源方式获取配置：network 在线模式，通过百度日历接口获取；local 本地模式，通过本地JSON文件获取
  type: network
  ## 在线模式配置下，通过设置 years 来进行初始化缓存的日历数据
  years:
    - 2020
    - 2021
  ## 节假日数据源地址，优先获取系统路径，不存在情况下，再使用 resources 路径
  path: /config/holiday.json

• HolidayService 接口（用于 获取日历数据 及 节假日/工作日/补班/周末 判断）

• getDate 方法：获取日历数据

• isHoliday 方法：是否是节假日

• isWorkDay 方法：是否是工作日或补班

• isWeekend 方法：是否是周末

• HolidayFixService 接口 （用于修复日历数据及本地模式下更新JSON文件）

• reset 方法：数据重置并刷新

• fix 方法：修复缓存数据

• updateFile 方法：更新JSON文件数据

注：JSON文件可通过 GenerateHolidayTest 进行生成, 示例可参考 HolidayTest

计划

springboot

• 自动解析官方《节假日安排的通知》，提供多种在线解析方式

• 支持redis

• 支持mysql

• 支持minio

• 支持mongodb

solon

• 支持solon