Hutool NumberUtil不止于计算：5个你可能忽略的实用技巧

在Java开发中，数字处理是绕不开的日常操作。虽然大多数开发者对Hutool的NumberUtil工具类的基础计算功能如数家珍，但其中一些"隐藏技能"却鲜为人知。这些功能往往能在特定场景下大幅简化代码，甚至解决一些棘手问题。本文将带你探索NumberUtil中五个容易被忽略但极具实用价值的技巧，从安全验证码生成到权限位运算，从数据清洗到算法优化，展示如何用一两行代码替代复杂的原生实现。

1. 安全验证码生成：不重复随机数的艺术

在需要生成验证码、抽奖序号或测试数据的场景中，确保随机数不重复是个常见需求。传统做法往往需要手动维护一个集合来检查重复，而NumberUtil提供了更优雅的解决方案：

// 生成10个0-100之间不重复的随机数
int[] uniqueRandoms = NumberUtil.generateRandomNumber(0, 100, 10);

对于需要返回包装类型的情况，可以使用 generateBySet 方法：

Integer[] uniqueRandoms = NumberUtil.generateBySet(0, 100, 10);

实际应用场景 ：

• 短信验证码生成（避免重复）
• 抽奖系统（确保奖品不重复发放）
• 测试数据准备（生成唯一ID集合）

注意：当请求的随机数数量接近范围大小时，算法性能会下降。例如在0-100范围内请求90个不重复随机数就不太适合。

2. 权限位运算：二进制转换的妙用

在权限管理系统或标志位处理中，经常需要在十进制和二进制表示之间转换。NumberUtil提供了一系列进制转换方法：

// 十进制转二进制
String binary = NumberUtil.getBinaryStr(8); // 返回"1000"

// 二进制转十进制
int decimal = NumberUtil.binaryToInt("111"); // 返回7

高级技巧 ：结合位运算进行权限检查

// 假设权限定义：1=读，2=写，4=执行
int userPermission = 3; // 二进制11，表示有读写权限

// 检查是否有执行权限
boolean canExecute = NumberUtil.getBinaryStr(userPermission).charAt(0) == '1';

性能对比 ：

操作类型	原生实现	NumberUtil实现	代码量对比
十进制转二进制	Integer.toBinaryString()	getBinaryStr()	相当
二进制转十进制	Integer.parseInt(str, 2)	binaryToInt()	更直观

3. 数据清洗：去除数字中多余的零

从数据库或用户输入中获取的数字经常带有无意义的后缀零，影响展示效果。手动处理这些情况既繁琐又容易出错，而NumberUtil的 toStr 方法可以智能处理：

NumberUtil.toStr(1.00000); // 返回"1"
NumberUtil.toStr(1.20000); // 返回"1.2"
NumberUtil.toStr(1.23400); // 返回"1.234"

实际应用场景 ：

• 金融数据展示（去除无意义的零使报表更简洁）
• API响应处理（减少不必要的数据传输）
• 用户输入规范化（统一数字格式）

进阶用法 ：结合DecimalFormat实现更灵活的格式化

double value = 1234.5600;
String formatted = NumberUtil.decimalFormat("#.##", value); // "1234.56"

4. 算法优化：质数判断与整数序列生成

在解决算法问题或数学计算时，NumberUtil提供了一些有用的数学工具：

质数判断 ：

NumberUtil.isPrimes(17); // 返回true

生成整数序列 ：

// 生成1-100的奇数序列
int[] odds = NumberUtil.range(1, 100, 2); 

// 添加到现有集合
List<Integer> numbers = new ArrayList<>(Arrays.asList(1));
NumberUtil.appendRange(100, 200, 2, numbers);

性能考虑 ：

• 对于大数质数判断，NumberUtil使用的是基础的试除法，不适合极大数的判断
• 整数序列生成采用预分配数组方式，比循环添加效率更高

算法题应用示例 ：

// 找出100以内的所有质数
IntStream.rangeClosed(2, 100)
         .filter(NumberUtil::isPrimes)
         .toArray();

5. 配置解析：灵活的数字格式判断

在处理配置文件或用户输入时，经常需要判断字符串是否为有效数字。NumberUtil提供了多种判断方法：

NumberUtil.isNumber("123"); // true
NumberUtil.isNumber("12.3"); // true
NumberUtil.isNumber("12a3"); // false

NumberUtil.isInteger("123"); // true
NumberUtil.isInteger("123.0"); // false

NumberUtil.isDouble("123"); // true
NumberUtil.isDouble("123.0"); // true
NumberUtil.isDouble("123a"); // false

实际应用场景 ：

• 配置文件读取（验证数字参数有效性）
• API参数校验（确保输入为有效数字）
• 数据导入处理（过滤非数字记录）

类型判断对比表 ：

方法名	整数	带小数	科学计数法	其他字符
isNumber	✓	✓	✓	✗
isInteger	✓	✗	✗	✗
isDouble	✓	✓	✓	✗

在最近的一个电商平台开发项目中，我们使用NumberUtil的这些"边缘"功能解决了多个实际问题：用不重复随机数生成优惠券码，通过二进制转换实现紧凑的权限存储，利用数字格式化统一了来自不同供应商的价格数据显示。这些看似小的优化，累计起来显著提升了代码的可维护性和系统性能。