别再手写工具类了!这个 Java 开源库内置 240+ 方法,一行代码搞定脱敏/加解密/日期计算,效率提升 10 倍!
📌 项目信息
- GitHub 地址:https://github.com/paohaijiao/jquick-transform-function
- 开源协议:Apache License 2.0
- JDK 要求:Java 8+
- 最新版本:1.3.0
Maven 坐标
<dependency>
<groupId>io.github.paohaijiao</groupId>
<artifactId>jquick-transform-function</artifactId>
<version>1.3.0</version>
</dependency>
Gradle 坐标
implementation 'io.github.paohaijiao:jquick-transform-function:1.3.0'
引言:为什么你还需要一个"工具方法库"?
写 Java 这么多年,你是不是经常遇到这些场景:
- 手机号、身份证、银行卡号要脱敏,每次都要手写正则或
substring拼接; - 身份证号里要解析生日、性别、年龄,一套
SimpleDateFormat+ 位运算模板背了 N 遍; - 字符串转驼峰、转蛇形、去重、统计字数……明明一句话的事,却要打开搜索引擎复制粘贴;
- 页面要展示随机测试数据、做AES/RSA 加解密、算标准差/中位数/排列组合,还得临时引入一堆大而全的工具框架。
JQuick(jquick-transform-function) 就是为解决这些痛点而生的——它内置了 240+ 个开箱即用的工具方法,覆盖字符串、日期、数学、集合、条件判断、业务校验(脱敏/身份证/手机号)、随机、加解密、JSON 等 20 大分类。核心设计是"方法即 SPI",让你既可以用一行代码调用,也可以像搭积木一样自由扩展属于自己的方法。
本文将从原理和用法两个维度,站在程序员视角带你彻底吃透这个库,建议收藏。
一、核心原理:大白话拆解
1.1 设计思想:方法即服务(SPI 扩展点)
JQuick 的核心抽象只有一个接口:
public interface JQuickMethodFunctionProvider {
String getMethodName(); // 方法名,如 "toUpper"
Object invoke(List<Object> args); // 方法体,接收参数列表返回结果
default String getDescription() {
return getMethodName(); } // 方法描述
default int getPriority() {
return 5000; } // 优先级
}
每一个工具方法 = 一个 JQuickMethodFunctionProvider 实现类。 比如"字符串转大写"就是 JQuickToUpperFunctionProvider,"手机号脱敏"就是 JQuickPhoneMaskFunctionProvider。这种"约定优于配置"的设计,让方法天然可插拔、可替换、可排序。
1.2 加载机制:基于 Java SPI + 按优先级排序
所有内置方法通过 Java SPI(Service Provider Interface) 机制注册:
- 在资源目录下维护一个 SPI 配置文件:
META-INF/services/com.github.paohaijiao.function.core.JQuickMethodFunctionProvider - 文件内容按分类逐行列出所有 Provider 全类名(
#开头是分类注释):
#字符串方法
com.github.paohaijiao.function.string.JQuickToUpperFunctionProvider
com.github.paohaijiao.function.string.JQuickLengthFunctionProvider
...
- 使用
com.github.paohaijiao.spi.ServiceLoader.loadServicesByPriority(...)一次性加载全部实现,并按@Priority注解或getPriority()排序。
1.3 调用路由:方法名 → 实现类
JQuickMethodInvocationManager 是一个单例,启动时会把所有 Provider 加载进一个 ConcurrentHashMap<String, JQuickMethodFunctionProvider>(key 为方法名),调用时直接按方法名路由:
JQuickMethodInvocationManager manager = JQuickMethodInvocationManager.getInstance();
Object result = manager.invoke("toUpper", "hello"); // "HELLO"
流程图如下:
Java SPI 配置文件(META-INF/services/...)
│ ServiceLoader.loadServicesByPriority()
▼
JQuickMethodInvocationManager(单例)
├── invokerRegistry: Map<方法名, Provider> ← 按方法名路由
└── groupedInvokers: Map<分组, 方法列表> ← 按分类管理
│ invoke("phoneMask", 参数...)
▼
对应 Provider.invoke(args) → 返回结果
由于使用
ConcurrentHashMap,方法注册和调用都是线程安全的,可放心在高并发场景使用。
1.4 三个关键设计亮点
| 亮点 | 说明 |
|---|---|
| 动态注册 | 运行期可通过 registerInvoker / registerOrReplaceInvoker 热添加、热替换方法 |
| Lambda 注册 | 无需写类,一个 Lambda 表达式即可注册新方法 |
| 优先级体系 | @Priority 注解 + getPriority() 双通道控制,同名方法可覆盖 |
二、五分钟快速开始
2.1 引入依赖
在你的 pom.xml 中加入(见文首坐标),Maven 会自动下载:
<dependency>
<groupId>io.github.paohaijiao</groupId>
<artifactId>jquick-transform-function</artifactId>
<version>1.3.0</version>
</dependency>
2.2 写第一行代码
import com.github.paohaijiao.function.manager.JQuickMethodInvocationManager;
public class QuickStart {
public static void main(String[] args) {
JQuickMethodInvocationManager manager = JQuickMethodInvocationManager.getInstance();
// 字符串转大写
System.out.println(manager.invoke("toUpper", "hello")); // HELLO
// 获取字符串长度
System.out.println(manager.invoke("length", "hello")); // 5
// 手机号脱敏
System.out.println(manager.invoke("phoneMask", "13800138000")); // 138****8000
// 当前时间戳
System.out.println(manager.invoke("timestamp")); // 1700000000000
}
}
不用写任何配置、不用注册任何东西,加依赖即用。
三、两种调用方式(必看)
JQuick 支持两种调用方式,按场景自由选择。
方式一:便捷访问方式(推荐,核心入口)
通过 JQuickMethodInvocationManager 单例按方法名统一调用,适合日常业务代码,不需要关心实现类:
JQuickMethodInvocationManager manager = JQuickMethodInvocationManager.getInstance();
// 支持可变参数
Object r1 = manager.invoke("concat", "Hello", " ", "World", "!");
Object r2 = manager.invoke("add", 10, 20, 30); // 60.0
Object r3 = manager.invoke("substring", "hello world", 0, 5); // hello
// 支持 List 参数(适合参数动态拼装的场景)
Object r4 = manager.invoke("replace",
java.util.Arrays.asList("hello world", "world", "java")); // hello java
// 方法存在性判断,避免抛异常
if (manager.hasMethod("md5")) {
Object r5 = manager.invoke("md5", "123456");
}
常用辅助方法:
manager.getMethodCount(); // 获取内置方法总数
manager.getSupportedMethods(); // 获取全部方法名
manager.searchMethods("mask"); // 模糊搜索方法(按方法名/描述)
manager.hasMethod("toUpper"); // 判断方法是否存在
manager.printRegisteredMethods();// 打印全部方法表格(GitHub 风格)
manager.printStats(); // 打印统计信息
manager.exportMarkdownTable(); // 导出 Markdown 方法清单
方式二:路径方式访问(直接使用 Provider 类)
如果你知道方法对应的实现类(即"方法路径"),也可以绕过 Manager 直接调用,适合追求极致性能(省去 Map 查找)或在特定场景做直连:
import com.github.paohaijiao.function.string.JQuickToUpperFunctionProvider;
import com.github.paohaijiao.function.business.JQuickPhoneMaskFunctionProvider;
import java.util.Arrays;
// 直接 new 实现类,手动传入参数列表
JQuickToUpperFunctionProvider toUpper = new JQuickToUpperFunctionProvider();
Object result1 = toUpper.invoke(Arrays.asList("hello")); // HELLO
JQuickPhoneMaskFunctionProvider phoneMask = new JQuickPhoneMaskFunctionProvider();
Object result2 = phoneMask.invoke(Arrays.asList("13800138000")); // 138****8000
方式三:SPI 配置文件方式(供容器/框架集成)
如果你的项目需要自己维护方法清单(比如裁剪方法、按需注册),可以直接编辑资源目录下的 SPI 文件:
路径:src/main/resources/META-INF/services/com.github.paohaijiao.function.core.JQuickMethodFunctionProvider
将需要的方法实现类全类名逐行写入(# 为分类注释),不需要的方法直接删行或注释掉即可:
#只保留字符串和日期方法
com.github.paohaijiao.function.string.JQuickToUpperFunctionProvider
com.github.paohaijiao.function.date.JQuickTodayFunctionProvider
三种方式对比:便捷访问最常用;路径访问适合直连与性能敏感场景;SPI 文件适合框架级定制。
四、内置方法大全(分类速查)
JQuick 内置 240+ 方法,覆盖 20+ 大分类,常用方法示例:
4.1 字符串类(最常用)
| 方法 | 说明 | 示例 |
|---|---|---|
toUpper / toLower |
大小写转换 | toUpper("abc") → ABC |
concat |
拼接多个字符串 | concat("A","B","C") → ABC |
substring |
截取子串 | substring("hello world",0,5) → hello |
split |
字符串分割 | split("a,b,c",",") → [a, b, c] |
replace / replaceAll |
替换 / 正则替换 | replace("hello","l","L") → heLLo |
toCamelCase / toSnakeCase |
驼峰 / 蛇形互转 | toSnakeCase("helloWorld") → hello_world |
md5 |
MD5 加密 | md5("123456") → 32 位小写 |
base64Encode / base64Decode |
Base64 编解码 | — |
mask |
掩码处理 | mask("123456",1,4,'*') → 1***56 |
levenshtein |
编辑距离 | levenshtein("kitten","sitting") → 3 |
similarity |
字符串相似度 | — |
isBlank / isNumeric / isAlpha |
各类校验 | — |
4.2 业务校验与脱敏类(企业开发刚需)
| 方法 | 说明 |
|---|---|
phoneMask / phoneValidate |
手机号脱敏 / 校验 |
idCardInfo / idCardValidate |
身份证信息提取(生日/年龄/性别/地区)/ 校验 |
bankCardMask / bankCardValidate |
银行卡脱敏 / Luhn 校验 |
emailMask / isEmail |
邮箱脱敏 / 校验 |
genderName |
性别码转名称(M/F、1/0、男/女 均可识别) |
4.3 日期时间类
| 方法 | 说明 | 示例 |
|---|---|---|
now / today / timestamp |
当前时间/日期/时间戳 | — |
parseDate / formatDate |
解析 / 格式化日期 | — |
addDays ~ addYears |
日期加减 | addDays(today, -7) → 一周前 |
daysBetween / yearsBetween |
日期差计算 | — |
isWeekend / isLeapYear |
周末 / 闰年判断 | — |
age / idCardAge |
年龄计算 | — |
4.4 数学与统计类
| 方法 | 说明 | 示例 |
|---|---|---|
add / subtract / multiply / divide |
四则运算(支持多参) | add(10,20,30) → 60.0 |
max / min / avg / median / mode |
统计函数 | max(10,20,5,25) → 25.0 |
sum / product / count |
求和 / 乘积 / 计数 | — |
stdDev / variance / percentile |
标准差 / 方差 / 百分位 | — |
factorial / fibonacci |
阶乘 / 斐波那契 | — |
gcd / lcm / permutation / combination |
数论组合 | — |
clamp / lerp / map |
数值约束 / 插值 / 范围映射 | — |
4.5 条件与空值处理类
| 方法 | 说明 | 示例 |
|---|---|---|
if / ifElse / switch / caseWhen |
条件分支 | if(true,"yes","no") → yes |
coalesce / nvl / defaultIfNull |
空值兜底 | coalesce(null,"default") → default |
between / eq / ne / gt / lt |
比较判断 | — |
isEmpty / size |
空判断 / 长度 | — |
4.6 加解密与随机类
| 分类 | 方法 |
|---|---|
| 对称加密 | AES 生成密钥 / 加密 / 解密 |
| 非对称加密 | RSA / ECC 密钥对生成、加密、解密 |
| 随机工具 | randomInt / randomLong / randomDouble / randomString / randomUUID / randomChoice / shuffle / randomDate / randomColor |
4.7 其他亮点
toJson:对象转 JSON 字符串toList/toArray:可变参数快速组装集合typeOf:获取对象类型名toCurrency/toPercentage:货币 / 百分比格式化complexAdd/matrixAdd:复数 / 矩阵运算translate:码值翻译(国际化场景)
五、进阶玩法:动态注册与自定义扩展
这是 JQuick 最强大的地方——不写一行配置,代码里就能新增/替换方法。
5.1 方式一:Lambda 注册(最推荐,最简单)
JQuickMethodInvocationManager manager = JQuickMethodInvocationManager.getInstance();
// 无描述注册
manager.registerInvoker("double", args -> {
Number num = (Number) args.get(0);
return num.doubleValue() * 2;
});
// 带描述注册(会进入对应分组)
manager.registerInvoker("greet", args -> "Hello, " + args.get(0) + "!",
"[String] 生成问候语");
// 带描述和优先级注册
manager.registerInvoker("quadruple", args -> {
Number num = (Number) args.get(0);
return num.doubleValue() * 4;
}, "[Math] 将数值乘以4", 500);
// 调用
manager.invoke("double", 5); // 10.0
manager.invoke("greet", "World"); // Hello, World!
5.2 方式二:覆盖注册(替换内置方法)
对内置方法不满意?直接覆盖,运行时生效:
// 覆盖 toUpper:统一在结果后加后缀
manager.registerOrReplaceInvoker("toUpper", args ->
args.get(0).toString().toUpperCase() + "_CUSTOM", "[Override] 自定义大写");
manager.invoke("toUpper", "hello"); // HELLO_CUSTOM
5.3 方式三:自定义 Provider 类(工程化首选)
当方法逻辑较复杂、需要复用或纳入团队规范时,推荐写成独立的 Provider 类。下面以一个完整的业务示例(订单金额计算)带你走通"写类 → 注册 → 调用"全流程。
① 完整代码:业务方法示例(订单金额计算)
package com.example.function.business;
import com.github.paohaijiao.function.domain.JQuickBaseFunctionFunctionProvider;
import com.github.paohaijiao.spi.anno.Priority;
import com.github.paohaijiao.spi.constants.PriorityConstants;
import java.util.List;
/**
* 自定义方法:计算订单应付金额
*
* 方法名: orderAmount
* 用法: orderAmount(price, quantity) → price * quantity
* orderAmount(price, quantity, discount) → price * quantity * discount
*/
@Priority(PriorityConstants.SYSTEM_HIGH)
public class JQuickOrderAmountFunctionProvider extends JQuickBaseFunctionFunctionProvider {
public JQuickOrderAmountFunctionProvider() {
// 构造方法中指定方法名和描述(描述会用于分组管理与文档输出)
super("orderAmount", "[Business] 计算订单应付金额 - 用法: orderAmount(price, quantity, discount?)");
}
@Override
public Object invoke(List<Object> args) {
// 1. 参数个数校验:允许 2~3 个(基类自带,越界直接抛异常)
validateArgCountRange(args, 2, 3);
// 2. 类型转换:基类自带 asDouble / asInt / asString / asLong / asBoolean
double price = asDouble(args.get(0));
int quantity = asInt(args.get(1));
double discount = args.size() > 2 ? asDouble(args.get(2)) : 1.0;
// 3. 业务校验
if (price < 0 || quantity < 0) {
throw new IllegalArgumentException("价格与数量不能为负数");
}
if (discount <= 0 || discount > 1) {
throw new IllegalArgumentException("折扣必须在 (0, 1] 之间");
}
// 4. 业务计算:结果保留两位小数
double total = price * quantity * discount;
return Math.round(total * 100) / 100.0;
}
}
要点拆解:
- 继承
JQuickBaseFunctionFunctionProvider,在构造方法里通过super(methodName, description)指定方法名和描述;- 用
@Priority(PriorityConstants.SYSTEM_HIGH)注解(或重写getPriority())声明优先级;- 参数校验、类型转换全部复用基类方法,业务代码只写核心逻辑,非常干净。
② 三种注册方式
方式 A:代码注册(单个 / 批量)
JQuickMethodInvocationManager manager = JQuickMethodInvocationManager.getInstance();
// 单个注册
manager.registerInvoker(new JQuickOrderAmountFunctionProvider());
// 批量注册(支持 List 和可变参数两种写法)
manager.registerInvokers(new JQuickOrderAmountFunctionProvider(), new JQuickPowerFunctionProvider());
方式 B:SPI 文件自动加载(推荐,免注册)
把类全类名追加到 SPI 配置文件,项目启动时自动加载,无需写任何注册代码:
文件路径:src/main/resources/META-INF/services/com.github.paohaijiao.function.core.JQuickMethodFunctionProvider
#业务方法
com.example.function.business.JQuickOrderAmountFunctionProvider
方式 C:覆盖注册(替换内置/同名方法)
// 将内置 toUpper 替换为自己的实现
manager.registerOrReplaceInvoker(new JQuickCustomToUpperFunctionProvider());
③ 完整调用验证
import com.github.paohaijiao.function.manager.JQuickMethodInvocationManager;
import java.util.Arrays;
public class CustomProviderDemo {
public static void main(String[] args) {
JQuickMethodInvocationManager manager = JQuickMethodInvocationManager.getInstance();
// 便捷访问方式:按方法名调用
System.out.println(manager.invoke("orderAmount", 99.9, 3)); // 299.7
System.out.println(manager.invoke("orderAmount", 99.9, 3, 0.8)); // 239.76
// 路径访问方式:直接调用实现类
JQuickOrderAmountFunctionProvider provider = new JQuickOrderAmountFunctionProvider();
System.out.println(provider.invoke(Arrays.asList(100.0, 2))); // 200.0
// 方法探测:判断是否存在 / 模糊搜索
System.out.println(manager.hasMethod("orderAmount")); // true
System.out.println(manager.searchMethods("amount")); // 可搜到该方法
}
}
④ 工程化最佳实践
| 规范项 | 建议 |
|---|---|
| 类名 | JQuick + 方法名(驼峰)+ FunctionProvider,如 JQuickOrderAmountFunctionProvider |
| 包名 | 按业务域分包:function.business / function.string / function.date ... |
| 方法名 | 小驼峰、语义化,与内置方法保持统一风格 |
| 描述格式 | "[分组] 方法说明 - 用法: xxx(param1, param2?)",? 表示可选参数 |
| 参数校验 | 优先用基类 validateArgCount / validateArgCountRange,少手写 if |
| 优先级 | 用 @Priority 注解或重写 getPriority();数值越大优先级越高 |
六、实战案例
案例 1:用户信息脱敏(企业级必备)
public class UserMaskDemo {
public static void main(String[] args) {
JQuickMethodInvocationManager manager = JQuickMethodInvocationManager.getInstance();
Object phone = manager.invoke("phoneMask", "13800138000");
Object email = manager.invoke("emailMask", "zhangsan@example.com");
Object card = manager.invoke("bankCardMask", "6222021234567890123");
Object idCard = manager.invoke("idCardInfo", "110101199003078888", "birthday");
System.out.println("手机号: " + phone); // 138****8000
System.out.println("邮箱: " + email); // z***n@example.com
System.out.println("银行卡: " + card); // 6222***********0123
System.out.println("生日: " + idCard); // 1990-03-07
}
}
案例 2:报表统计一行搞定
Object[] nums = new Object[]{
5, 10, 15, 20, 25};
System.out.println(manager.invoke("sum", nums)); // 75.0
System.out.println(manager.invoke("avg", nums)); // 15.0
System.out.println(manager.invoke("median", nums)); // 15.0
System.out.println(manager.invoke("stdDev", nums)); // 7.07
System.out.println(manager.invoke("variance", nums)); // 50.0
案例 3:工具方法在规则引擎 / 低代码平台中的玩法
得益于"方法名 + List 参数"的统一签名,JQuick 天然适合被规则引擎、表达式引擎、低代码平台调度。比如把前端传来的方法名 + 参数直接映射执行:
public Object dispatch(String methodName, List<Object> args) {
JQuickMethodInvocationManager manager = JQuickMethodInvocationManager.getInstance();
if (!manager.hasMethod(methodName)) {
throw new IllegalArgumentException("不支持的方法: " + methodName);
}
return manager.invoke(methodName, args);
}
七、常见问题(FAQ)
Q1:会跟 Commons-Lang3 / Hutool 冲突吗?
不会。JQuick 定位是"方法级 SPI 工具库",与现有工具类可以共存;而且方法名即服务的抽象,让它可以被任何框架调度。
Q2:性能怎么样?
方法注册表是 ConcurrentHashMap,invoke 为 O(1) 路由;方法体多为纯计算,无额外开销。性能敏感场景可直接用"路径方式"直连 Provider 类。
Q3:能用在生产环境吗?
可以。Apache 2.0 协议,Java 8+ 兼容,线程安全,支持动态注册与替换,适合企业级项目。
Q4:如何参与贡献?
在 GitHub 仓库提交 Issue / PR 即可,新增方法只需实现 JQuickMethodFunctionProvider 并在 SPI 文件追加一行。
八、总结
| 优势 | 说明 |
|---|---|
| 开箱即用 | 引入依赖即有 240+ 方法,零配置 |
| 分类齐全 | 字符串 / 日期 / 数学 / 业务 / 加解密全覆盖 |
| 调用优雅 | 方法名即服务,Manager 一行调用 |
| 高度可扩展 | SPI + Lambda + 覆盖注册,三种方式随你挑 |
| 企业友好 | Java 8、线程安全、Apache 2.0、可裁剪方法清单 |
如果你也厌倦了到处复制粘贴工具方法,不妨给 jquick-transform-function 一个 Star ⭐,并把这篇文章收藏起来,下次写代码直接用!
GitHub:https://github.com/paohaijiao/jquick-transform-function
本文由 JQuick 项目作者整理发布,欢迎评论区交流你的使用场景与建议。