skrstop-components工具库兵器谱:线程池重试、事件总线、压缩等5大杀器完全清单

原创2026-10-15 18:43:051,667 阅读

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:

日期处理是最香的隐藏福利

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,本地并发实验基本不缺工具。

快速上手:如何引入这些工具?

  1. 确认 JDK 版本:最低要求见 README.md——JDK 17 起步,低版本请使用 1.2.x 版本线;
  2. 按需引依赖:模块拆分极细,只用压缩就只引 components-util-compression,避免胖依赖:
<dependency>
    <groupId>com.skrstop.framework</groupId>
    <artifactId>components-util-compression</artifactId>
    <version>${skrstop.version}</version>
</dependency>
  1. 参考样例工程:components-example/ 下提供了简单样例(simple)和 Feign 样例(cloud-feign),克隆后直接跑,抄配置不迷路;
  2. 版本跟进:升级前翻一眼 CHANGELOG.md,1.3.x 版本线迭代活跃,多数据源、监控、对象存储等能力都在持续增强。

小结:按需取用,别贪多

skrstop-components 的设计哲学是"模块极细、按需组合":

  • 要异步稳定性 → 线程池重试(executor)
  • 要业务解耦 → 进程内事件总线(event)
  • 要文件归档 → 压缩工具(compression)
  • 要数据转换 → 序列化工具(serialization)
  • 要性能摸底 → 本地压测(stress)

每个模块都是独立 Maven 依赖,互不强绑。从兵器谱里挑你需要的几件武器,剩下的配置样板代码就可以从你的 TODO 列表里删掉了。

登录后查看全文
skrstop-components