skrstop-components工具库兵器谱:线程池重试、事件总线、压缩等5大杀器完全清单
skrstop-components工具库兵器谱:线程池重试、事件总线、压缩等5大杀器完全清单
skrstop-components 是一个基于 Spring Boot 的常用功能封装工具库,涵盖通用响应、通用异常、数据库、Redis、远程存储、多数据源等能力,开箱即用,支持 JDK 8+ 与 JDK 17+。本文带你走进它的"兵器谱",快速盘点 5 大核心工具杀器:线程池与重试、进程内事件总线、压缩工具、序列化、本地压测,帮你少写配置、直接抄作业。
💡 工具类位于 components-utils/ 模块下,Maven 坐标为
com.skrstop.framework,按需引入对应components-util-xxx依赖即可,版本日志见 CHANGELOG.md。
兵器谱总览:5 大杀器一图速查
| 兵器 | 模块 | 一句话定位 | 源码入口 |
|---|---|---|---|
| ⚔️ 线程池 + 重试 | components-util-executor |
固定/定时线程池、指数退避重试 | ThreadPoolUtil.java |
| 📡 进程内事件总线 | components-util-event |
发布/订阅模型,解耦业务逻辑 | EventBus.java |
| 📦 压缩工具 | components-util-compression |
ZIP/TAR/GZIP/BZ2 等 11 种格式互转 | CompressUtil.java |
| 🧬 序列化工具 | components-util-serialization |
JSON/Protostuff 统一封装,日期处理零踩坑 | JsonUtil.java |
| 🏋️ 本地压测 | components-util-stress |
指定并发和请求数,跑完直接出报告 | StressStoreUtil.java |
杀器一:线程池 + 指数退避重试,异步任务稳如老狗
components-util-executor 模块把最让人头疼的"线程池怎么建、失败要不要重试、重试等多久"一次打包解决。
1 行代码创建固定线程池
ThreadPoolUtil.java 在 hutool ThreadUtil 基础上增强了带任务优先级的线程池创建能力,固定大小、自定义队列、定时调度都有现成方法,还支持 THREAD_PRIORITY_NORMAL(0)、THREAD_PRIORITY_HIGH(10)等优先级常量,高优任务不再被普通任务"插队"。
重试三件套:执行器 + 退避策略 + 监听器
重试能力在 retry/ 包下,结构清晰:
- 执行器:RetryExecutor.java 定义
execute(Callable)接口,重试耗尽抛RetriesExhaustedException,非重试异常抛UnexpectedException,异常语义非常明确; - 退避策略:7 种策略可选,最经典的是指数退避 ExponentialBackoffStrategy.java——等待时间按
2^(n-1) × 基础延迟翻倍增长,远程调用抖动时既不打死对端又能及时恢复; - 监听器:RetryListener 可在每次重试前后插入日志、监控埋点。
🎯 典型场景:Feign 调用偶发超时、消息发送失败重发,把
Callable丢给RetryExecutor,配上指数退避,一行样板代码不用写。
杀器二:进程内事件总线,业务解耦不用上 MQ
components-util-event 模块实现了轻量级发布-订阅模型,核心就是 EventBus.java。
为什么用进程内事件总线?
有些解耦场景上 Kafka、RabbitMQ 太重(比如同一服务内的审计日志、指标埋点、缓存失效通知)。EventBus 直接在 JVM 内完成事件投递,零依赖、零网络开销,同时保留了 MQ 式"发布方不知道订阅方是谁"的松耦合特性。
使用三步走
// 1. 定义事件:继承 EventTemplate,实现 init/before/execute/after/finish 生命周期
public class OrderEvent extends EventTemplate<String> { ... }
// 2. 注册订阅者:传 false 表示异步处理,默认同步
EventBus.register(OrderEvent.class, new SubscriberTemplate(false));
// 3. 投递事件,所有订阅者都会收到
EventBus.postAll(new OrderEvent("订单已创建"));
完整示例可参考 EventBusTest.java。
订阅者自带完整生命周期回调
SubscriberTemplate.java 会按 init → before → execute → after → finish → onSuccess 的顺序驱动事件,执行失败还会回调 onFailure 并记录日志——订阅者只需关心业务逻辑,流程控制全部托管。另外 EventBus 支持通过 event.bus.enable 系统属性一键关闭,性能敏感场景可以"拔线"。
杀器三:压缩工具,11 种格式通吃
CompressUtil.java 是压缩包操作的"瑞士军刀",processor/ 目录下内置了 11 种处理器:
| 格式类别 | 处理器 | 常见场景 |
|---|---|---|
| 主流压缩 | ZIP、GZIP、Bzip2、Xz、SevenZip | 日志归档、文件传输 |
| 归档打包 | TAR、TarGz、TarBz2、Cpio | 服务器部署包制作 |
| Java 生态 | AR、JAR | 依赖分析、制品处理 |
亮点细节:
- 独立实现的 tar 引擎:tar/ 包下自带
TarInputStream/TarOutputStream等类,不依赖第三方库也能处理 tar 包,权限、八进制头解析都有封装; - 压缩级别可配:ZipLevel、GzipLevel 等 Bean 让你按"速度优先还是体积优先"选级别;
- Builder 风格 API:
FileCompressor用链式调用指定源文件、目标路径、类型和级别,可读性远超原生java.util.zip写法。
📦 典型场景:定时把日志目录打成 tar.gz 上传对象存储,
compressTar+FileCompressor两行搞定。
杀器四:序列化工具,日期序列化零踩坑
components-util-serialization 统一封装了 JSON 三件套 + Protostuff:
- JSON:JsonUtil.java(hutool 增强版)、FastJsonUtil.java、JacksonUtil.java、GsonUtil.java,同一个业务在不同链路用不同 JSON 库也不用各写一遍工具方法;
- Protostuff:ProtostuffUtil.java 提供高性能二进制序列化,配合
components-starter-feign-protostuff模块可直接给 Feign 接口开启二进制传输,比 JSON 省带宽、省 CPU。
日期处理是最香的隐藏福利
format/ 目录下有 24 个日期序列化器/反序列化器,覆盖 Date、LocalDate、LocalDateTime、LocalTime、MonthDay、YearMonth 等全家族,Jackson 和 Fastjson 两套都有。Jackson 反序列化 LocalDateTime 时格式不匹配的坑,这里直接帮你填平。
杀器五:本地压测包,发版前先自测一轮
上线前想验证"我的接口 200 并发扛不扛得住"?不必上 JMeter——StressStoreUtil.java 提供声明式压测 API:
test(并发数, 总请求数, 任务):跑压测并返回 StressResult 结果对象,可程序化处理;testAndPrint(...):跑完自动打印性能报告,QPS、耗时分布一目了然;- 支持指定预热次数(warmUpTime),规避 JIT 未预热导致的失真数据。
配合 components-util-executor 的 AsyncRuntimeExecutor 和 CompletableFutureUtil,本地并发实验基本不缺工具。
快速上手:如何引入这些工具?
- 确认 JDK 版本:最低要求见 README.md——JDK 17 起步,低版本请使用 1.2.x 版本线;
- 按需引依赖:模块拆分极细,只用压缩就只引
components-util-compression,避免胖依赖:
<dependency>
<groupId>com.skrstop.framework</groupId>
<artifactId>components-util-compression</artifactId>
<version>${skrstop.version}</version>
</dependency>
- 参考样例工程:components-example/ 下提供了简单样例(simple)和 Feign 样例(cloud-feign),克隆后直接跑,抄配置不迷路;
- 版本跟进:升级前翻一眼 CHANGELOG.md,1.3.x 版本线迭代活跃,多数据源、监控、对象存储等能力都在持续增强。
小结:按需取用,别贪多
skrstop-components 的设计哲学是"模块极细、按需组合":
- 要异步稳定性 → 线程池重试(executor)
- 要业务解耦 → 进程内事件总线(event)
- 要文件归档 → 压缩工具(compression)
- 要数据转换 → 序列化工具(serialization)
- 要性能摸底 → 本地压测(stress)
每个模块都是独立 Maven 依赖,互不强绑。从兵器谱里挑你需要的几件武器,剩下的配置样板代码就可以从你的 TODO 列表里删掉了。