# yexuejc-base

**Repository Path**: jzsw-it/yexuejc-base

## Basic Information

- **Project Name**: yexuejc-base
- **Description**: 基于jdk8常用工具包
- **Primary Language**: Java
- **License**: MIT
- **Default Branch**: master
- **Homepage**: https://gitee.com/jzsw-it/yexuejc-base
- **GVP Project**: No

## Statistics

- **Stars**: 2
- **Forks**: 2
- **Created**: 2018-03-19
- **Last Updated**: 2026-04-20

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# yexuejc-base

[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)
[![Maven Central](https://img.shields.io/badge/Maven-Central-green.svg)](https://search.maven.org/artifact/top.yexuejc/yexuejc-base)

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

## 特性

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

## 快速开始

### Maven 引入

```xml
<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 复制、深度克隆 |

### 文件操作

| 组件 | 说明 |
|------|------|
| 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` 等通用数据对象。

## 文档

| 文档 | 说明 |
|------|------|
| [功能说明](doc/) | 各模块详细功能文档 |
| [更新记录](CHANGELOG.md) | 版本变更日志 |
| [全功能列表](FEATURE_LIST.md) | 三分支功能对比 |

## 贡献

欢迎提交 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](LICENSE) 开源。

Copyright © 2024 yexuejc