# hutool-plus

**Repository Path**: yzd_org/hutool-plus

## Basic Information

- **Project Name**: hutool-plus
- **Description**: 🔥🔥🔥Hutool最佳搭档，只做增强不做改变，为简化开发、提高效率而生。
- **Primary Language**: Unknown
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-12-19
- **Last Updated**: 2025-12-26

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

<p align="center">
	<img src="https://raw.gitcode.com/yzd1206/hutool-plus/raw/master/docs%2Fimages%2Fplus-logo.png" width="45%">

</p>
<p align="center">
	<strong>🍬Hutool最佳搭档，只做增强不做改变，为简化开发、提高效率而生</strong>
</p>

-------------------------------------------------------------------------------

## 📚简介 
 
`hutool-plus`是基于[Hutool](https://hutool.cn/)的增强工具包，秉承"Hutool最佳搭档，只做增强不做改变"的设计理念，致力于进一步简化Java开发，提升开发效率。

本项目在Hutool的基础上进行了功能增强和扩展，保留了Hutool原有的所有优秀特性，同时增加了更多实用的功能模块，特别是在Spring生态集成方面做了大量工作。

GitCode源码仓库地址：[https://gitcode.com/yzd1206/hutool-plus](https://gitcode.com/yzd1206/hutool-plus)

Gitee源码仓库地址：[https://gitee.com/yzd_org/hutool-plus](https://gitee.com/yzd_org/hutool-plus)

Maven仓库地址(网页1)：[https://repo1.maven.org/maven2/io/github/yzd1206](https://repo1.maven.org/maven2/io/github/yzd1206)

Maven仓库地址(网页2)：[https://mvnrepository.com/artifact/io.github.yzd1206](https://mvnrepository.com/artifact/io.github.yzd1206)

### ⚙️环境要求

- 最低支持 JDK 8

### 🎯核心理念

- **只做增强不做改变**：完全兼容Hutool原有API，用户可以无缝迁移
- **简化开发**：提供更多开箱即用的工具类和组件
- **提高效率**：减少重复代码编写，专注业务逻辑实现
- **易于集成**：特别针对Spring生态系统进行了优化

-------------------------------------------------------------------------------

## 🛠️功能模块

| 模块                 | 进度   |     介绍                                                                          |
|--------------------|------|----------------------------------------------------------------------------------|
| [hutool-plus-spring](./hutool-plus-spring/README.md) | 100% |     Spring生态集成封装，提供更便捷的Spring整合支持，包括缓存管理、配置处理、工具类增强等，简化Spring应用开发                                      |
| [hutool-plus-web](./hutool-plus-web/README.md)    | 100% |     Web开发增强模块，提供Web相关工具和功能，包括异常处理、全局异常处理器、统一响应结果封装等，简化Web开发流程                                              |
| [hutool-plus-file](./hutool-plus-file/README.md)   | 0%   |     文件处理模块，提供更强大的文件操作功能，包括文件上传、下载、存储管理等，支持多种存储后端，简化文件处理流程                                            |
| [hutool-plus-test](./hutool-plus-test/README.md)   | 10%  |     测试支持模块，集成了常用的测试依赖和工具，包括数据库连接器、测试框架等，提供完整的测试环境支持                                            |
| [hutool-plus-tools](./hutool-plus-tools/README.md)  | 99%  |     工具集模块，提供各种通用工具类，包括JVM监控工具、网络端口探测、字符串常量池、集合操作工具等，增强原生Hutool功能                           |
| [hutool-plus-undertow](./hutool-plus-undertow/README.md) | 100% |   Undertow服务器集成模块，使用Undertow作为Web服务器替代Tomcat，提供更优的性能和更低的资源消耗，支持高性能Web应用部署                           |
| [hutool-plus-ws](./hutool-plus-ws/README.md)     | 60%  |     WebSocket封装模块，提供WebSocket通信功能，支持实时双向通信，简化WebSocket应用开发                                              |
| [hutool-plus-monitor](./hutool-plus-monitor/README.md) | 100% |    应用监控模块，集成Spring Boot Actuator和Prometheus监控组件，提供应用运行时监控、健康检查、性能指标收集等功能，支持微服务环境下的应用可观测性                    |
| [hutool-plus-logstash](./hutool-plus-logstash/README.md) | 100% |   Logstash日志推送模块，集成Logstash日志处理系统，提供结构化日志输出、日志集中收集和处理功能，支持日志格式化和远程推送，便于日志分析和运维监控                         |
| [hutool-plus-skylog](./hutool-plus-skylog/README.md) | 100% |     SkyWalking日志收集模块，集成Apache SkyWalking分布式链路追踪系统，提供分布式环境下请求链路追踪、性能分析、日志收集等功能，支持微服务架构下的全链路监控                      |
| [hutool-plus-continew](./hutool-plus-continew/README.md) | 90%  |   基于Continew的Web开发模块，提供约定优于配置的解决方案，简化Spring Boot Web开发，包含安全加密、API文档、验证、限流、幂等等功能           |
| [hutool-plus-all](./hutool-plus-all/README.md)    | 100% |     包含所有模块的完整版本，方便一次性引入所有功能，适合需要完整功能集的项目                                       |
| [hutool-plus-bom](./hutool-plus-bom/README.md)    | 100% |     Bill of Materials（BOM）模块，用于统一管理依赖版本，确保项目中所有hutool-plus模块版本一致性，简化依赖管理                                  |

-------------------------------------------------------------------------------

## 📦安装

### 🍊Maven-全部引入
在项目的pom.xml的dependencies中加入以下内容:

```xml
<dependency>
    <groupId>io.github.yzd1206</groupId>
    <artifactId>hutool-plus-all</artifactId>
    <!-- 0.0.x-jdk8；0.0.x-jdk11；0.0.x-jdk17；0.0.x-jdk21 -->
    <version>0.0.x-jdk</version>
</dependency>
```

### 📥Maven-模块化引入

根据需要引入特定模块:

```xml
<dependencyManagement> 
    <dependencies>
        <dependency>
            <groupId>io.github.yzd1206</groupId>
            <artifactId>hutool-plus-bom</artifactId>
            <!-- 0.0.x-jdk8；0.0.x-jdk11；0.0.x-jdk17；0.0.x-jdk21 -->
            <version>0.0.x-jdk</version>
            <type>pom</type>
            <scope>import</scope>
        </dependency>
    </dependencies>
</dependencyManagement>
<!-- 具体模块引入 -->
<dependencies>
    <dependency>
        <groupId>io.github.yzd1206</groupId>
        <artifactId>hutool-plus-xx</artifactId> 
    </dependency>
</dependencies> 
```

-------------------------------------------------------------------------------

## 🎯主要特性

### Spring集成增强
hutool-plus-spring模块提供了与Spring框架的深度集成：
- 更便捷的缓存管理
- 数据库操作增强
- JVM工具类增强
- 线程池可视化监控

### 兼容性保证
- 完全兼容Hutool的所有功能和API
- 无需修改现有代码即可享受增强功能
- 提供平滑升级路径

-------------------------------------------------------------------------------

## 🏗️参与贡献

欢迎任何形式的贡献，包括但不限于：
- 提交bug报告
- 提交Pull Request
- 文档完善
- 功能建议

### 开发指南
1. Fork项目到自己的仓库
2. Clone到本地开发环境
3. 创建feature分支进行开发
4. 提交代码并发起Pull Request

-------------------------------------------------------------------------------

## 📄许可证

本项目遵循Apache License 2.0开源协议。

-------------------------------------------------------------------------------

## 💌联系方式

如有任何问题或建议，请联系项目维护者。

- 个人网站：https://yzd1206.blog.csdn.net
- QQ：121665820


-------------------------------------------------------------------------------

## ⭐Star Hutool-Plus

[![Stargazers over time](https://starchart.cc/chinabugotech/hutool.svg)](https://starchart.cc/chinabugotech/hutool)