yexuejc-base

Java 常用工具包，支持 Java 8 / 11 / 21 多版本适配

特性

• 开箱即用 — 基于 Spring Boot 提取，适用于所有 Java 工程
• 多版本适配 — 同步维护 jre8 / jre11 / jre21 三个分支
• 零外部依赖 — 核心模块仅依赖 Jackson，其余均为 Java 原生实现
• 生产可用 — 经过多个商业项目验证

快速开始

Maven 引入

<dependency>
    <groupId>top.yexuejc</groupId>
    <artifactId>yexuejc-base</artifactId>
    <version>1.6.0-jre21</version>
</dependency>

版本选择

Java 版本	推荐版本号	分支
Java 21（推荐）	1.6.0-jre21	jre21
Java 11	1.5.0-jre11	jre11
Java 8	1.5.0-jre8	jre8

功能模块

加密

组件	说明
AES	CBC / GCM / CFB / OFB / PCBC 模式
DES3	3DES 加解密（已标记废弃，推荐使用 AES-GCM）
RSA	支持 PKCS1 / OAEP 填充，密钥生成与证书模式
签名	MD5withRSA / SHA256withRSA

日期时间

组件	说明
DateTimeUtil	基于 java.time API（推荐）
DateUtil	基于 java.util.Date（已标记废弃）

数据处理

组件	说明
JsonUtil	Jackson 封装，内置 LocalDate/LocalDateTime/Timestamp 序列化
StrUtil	UUID、MD5、SHA256、驼峰转换、URL 编解码、空值判断
ObjUtil	驼峰↔下划线字段映射、Bean 复制、深度克隆
CsvUtil	CSV 文件写入，支持 Bean 转 CSV、自定义编码/BOM/分隔符/换行符

文件操作

组件	说明
FileUtil	类型判断、MD5/SHA1/CRC32 摘要、大文件分段读取、通用 digest
ZipUtil	ZIP 压缩与解压
CSV	@CsvHeader 注解驱动，CSV ↔ Bean 转换

网络通信

组件	说明
HTTP 响应	BasicResponse / ListResponse / ObjectResponse / SignResponse
JWT	HS512 签名，支持过期时间配置
签名请求	SignRequest / SignResponse 签名体系

工具类

组件	说明
IdcardValidator	身份证号校验（18位 + 出生日期验证）
MoneyUtil	金额转换（分 ↔ 元）
SysUtil	系统线程、JVM 内存信息（无外部依赖）
MessageService	SPI 机制，支持多语言消息（zh_CN/en_US/ja_JP/ko_KR/zh_TW）

异常体系

组件	说明
BaseException	受检异常基类
BaseRuntimeException	非受检异常基类
ExpCode	统一异常码枚举

POJO

BaseVO / PagerVO / RequestHeader / CreateZipFileBean 等通用数据对象。

文档

文档	说明
功能说明	各模块详细功能文档
更新记录	版本变更日志
全功能列表	三分支功能对比

贡献

欢迎提交 Issue 和 Pull Request。

1. Fork 本仓库
2. 创建特性分支 (git checkout -b feature/xxx)
3. 提交改动 (git commit -m 'feat: xxx')
4. 推送分支 (git push origin feature/xxx)
5. 创建 Pull Request

License

本项目基于 MIT License 开源。

Copyright © 2024 yexuejc