# jtool-plus

**Repository Path**: ccbx/jtool-plus

## Basic Information

- **Project Name**: jtool-plus
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-04-13
- **Last Updated**: 2026-07-30

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# JTool Plus

Java 21 工具集，包含 JavaFX 桌面应用框架与通用工具模块，采用模块化设计，按需引入。

## 模块总览

| 模块 | 说明 | 详细文档 |
|------|------|----------|
| **core** | 公共基础工具：文件/IO、磁盘、系统信息、数据单位格式化、集合、日志、关闭钩子、反射 | [core/README.md](core/README.md) |
| **json** | 基于 Jackson 的 JSON 工具：对象/JSON 互转、美化、深合并覆盖、字段修改、深拷贝 | [json/README.md](json/README.md) |
| **cache** | 基于 Caffeine 的缓存工厂 + 软引用轻量缓存 + 驱逐监听器基类 | [cache/README.md](cache/README.md) |
| **compress** | 基于 Apache Commons Compress：ZIP/GZ/TAR/TAR.GZ 压缩解压，进度回调，工厂分发 | [compress/README.md](compress/README.md) |
| **shell** | 跨平台命令/脚本执行：同步异步、超时控制、进程缓存管理 | [shell/README.md](shell/README.md) |
| **smbj** | 基于 smbj 的 SMB/CIFS 文件共享客户端：连接管理、文件操作、进度回调 | [smbj/README.md](smbj/README.md) |
| **minio-spring** | MinIO 对象存储 Spring Boot 自动配置集成：桶管理、上传下载、预签名 URL | [minio-spring/README.md](minio-spring/README.md) |
| **jfx** | JavaFX 核心框架：窗口生命周期、事件总线、国际化、流畅 UI 构建、异步任务 | [jfx/README.md](jfx/README.md) |
| **jfx-spring** | Spring Boot 集成层：自动配置、依赖注入、外部化配置 | [jfx-spring/README.md](jfx-spring/README.md) |

## 目录结构

```
jtool-plus (父工程)
├── core/              公共基础工具
├── json/              JSON 工具
├── cache/             缓存工具
├── compress/          压缩工具
├── shell/             命令执行工具
├── smbj/              SMB 客户端
├── minio-spring/      MinIO Spring 集成
├── jfx/               JavaFX 核心框架
├── jfx-spring/        JavaFX Spring 集成
├── pom.xml            父工程配置
└── README.md          本文件
```

## 模块依赖关系

```
core (基础模块，无内部依赖)
  ▲
  ├── json          (基于 Jackson)
  ├── cache         (基于 Caffeine)
  ├── compress      (基于 Commons Compress)
  ├── shell         (基于 JDK Runtime)
  ├── smbj          (基于 smbj)
  └── minio-spring  (基于 MinIO + Spring Boot)

jfx (JavaFX 核心框架，零 Spring 依赖)
  ▲
  └── jfx-spring    (Spring Boot 集成层)
```

- `core` 是 6 个工具模块的共同基础依赖
- 工具模块之间互不依赖，可独立引入
- 仅 `minio-spring` 和 `jfx-spring` 依赖 Spring Boot，其余模块均可独立使用

## 技术栈

| 技术 | 版本 | 用途 | 使用模块 |
|------|------|------|----------|
| Java | 21 | 运行时 | 全部 |
| SLF4J | 2.0.12 | 日志门面 | 全部 |
| Hutool | 5.8.39 | 通用工具（core 继承扩展） | core |
| Jackson | 2.17.2 | JSON 处理 | json |
| Caffeine | 3.1.8 | 缓存引擎 | cache |
| Apache Commons Compress | 1.26.1 | 压缩/解压 | compress |
| smbj | 0.14.0 | SMB/CIFS 协议 | smbj |
| MinIO | 8.5.17 | 对象存储 | minio-spring |
| JavaFX | 21 | UI 框架 | jfx、jfx-spring |
| Spring Boot | 3.2.5 | 自动配置与依赖注入 | jfx-spring、minio-spring |
| Logback | 1.4.14 | 日志实现（仅测试作用域） | - |
| JUnit 5 | 5.10.2 | 单元测试（测试作用域） | - |

## 构建与安装

```bash
# 完整构建并安装到本地仓库
mvn clean install

# 仅编译
mvn clean compile

# 运行测试
mvn test
```

> 框架尚未发布到 Maven 中央仓库，需通过 `mvn clean install` 安装到本地仓库后引用。各模块依赖坐标见对应 README。

## 项目信息

- **GroupId**: `com.jtoolplus`
- **ArtifactId**: `jtool-plus`
- **Version**: `1.0.3`
- **Java 版本**: 21
- **编码**: UTF-8