拒绝重复造轮子！SpringBoot 内置的20个高效官方工具类详解

程序员蜗牛
2,486 阅读7分钟

点击上方“程序员蜗牛g”，选择“设为星标”

跟蜗牛哥一起，每天进步一点点

程序员蜗牛g

大厂程序员一枚 跟蜗牛一起 每天进步一点点

33篇原创内容

**

公众号

本项目是对 Spring Framework 内置的 20 个精选工具类的完整演示和深度解析。每个工具类都包含：

  • • ✅ 完整可运行的代码示例
  • • ✅ 实际应用场景演示
  • • ✅ 最佳实践和注意事项
  • • ✅ 与其他方案的对比说明

🎯 为什么使用 Spring 官方工具类？

  • • 无额外依赖：Spring Boot 项目开箱即用
  • • 深度框架集成：与 Spring AOP、IoC 等无缝协作
  • • 异常处理完善：自动处理 null、边界条件等陷阱
  • • 性能优化：经 Spring 团队长期生产验证

🚀 快速开始

1. 克隆项目

git clone <repository-url>
cd springuitls

2. 运行演示

方式一：交互式菜单（推荐）
mvn spring-boot:run

启动后会显示交互式菜单，可以选择运行单个或所有演示。

方式二：一次性运行所有演示
mvn spring-boot:run -Dspring-boot.run.arguments="all"

📚 工具类清单

【核心工具】

1. StringUtils - 字符串处理终结者
  • • 包路径：org.springframework.util.StringUtils
  • • 核心功能：字符串判空、去空格、路径处理
  • • 常用方法：
    • • hasText() - 判断字符串是否有内容（自动 trim）
    • • hasLength() - 判断字符串长度是否大于 0
    • • getFilename() - 从路径提取文件名
    • • arrayToCommaDelimitedString() - 数组转逗号分隔字符串

示例代码：

// 安全判空（自动处理 null 和空格）
if (StringUtils.hasText(nickname)) {
    System.out.println("昵称有效: " + nickname.trim());
}

// 提取文件名
String filename = StringUtils.getFilename("/path/to/file.txt"); // file.txt

演示类： StringUtilsDemo.java

2. CollectionUtils - 集合操作防坑神器
  • • 包路径：org.springframework.util.CollectionUtils
  • • 核心功能：集合判空、合并、查找
  • • 常用方法：
    • • isEmpty() - 安全判空（自动处理 null）
    • • firstElement() / lastElement() - 获取首尾元素
    • • intersection() - 求交集

示例代码：

// 安全遍历集合
if (CollectionUtils.isEmpty(tags)) {
    System.out.println("无标签，跳过处理");
    return;
}
tags.forEach(tag -> System.out.println("处理标签: " + tag));

演示类： CollectionUtilsDemo.java

3. ObjectUtils - 对象安全操作卫士
  • • 包路径：org.springframework.util.ObjectUtils
  • • 核心功能：对象安全打印、哈希、比较
  • • 常用方法：
    • • nullSafeToString() - 安全转字符串（支持数组）
    • • nullSafeHashCode() - 安全获取哈希码
    • • nullSafeEquals() - null 安全比较

示例代码：

// 安全打印对象（避免 NullPointerException）
System.out.println("用户信息: " + ObjectUtils.nullSafeToString(user));

// 数组安全打印
String[] array = {"Java", "Spring", "Boot"};
System.out.println("数组: " + ObjectUtils.nullSafeToString(array)); // [Java, Spring, Boot]

演示类： ObjectUtilsDemo.java

4. Assert - 参数校验断言大师
  • • 包路径：org.springframework.util.Assert
  • • 核心功能：参数校验、前置条件检查
  • • 常用方法：
    • • notNull() - 断言非空
    • • hasText() - 断言字符串有内容
    • • isTrue() - 断言条件为真

示例代码：

// Service 方法入口校验
public void cancelOrder(Long orderId) {
    Assert.notNull(orderId, "订单ID不能为空");
    Assert.isTrue(orderId > 0, "订单ID必须大于0");
    // 业务逻辑...
}

演示类： AssertDemo.java

【文件和流】

5. FileCopyUtils - 文件拷贝终极方案
  • • 包路径：org.springframework.util.FileCopyUtils
  • • 核心功能：文件、流、字节数组互拷
  • • 常用方法：
    • • copy(InputStream, OutputStream) - 流拷贝
    • • copyToByteArray(File) - 文件转字节数组
    • • copy(byte[], File) - 字节数组写入文件

演示类： FileCopyUtilsDemo.java

6. StreamUtils - 流操作轻量级专家
  • • 包路径：org.springframework.util.StreamUtils
  • • 核心功能：流转字符串、字节数组
  • • 常用方法：
    • • copyToString(InputStream, Charset) - 流转字符串
    • • copyToByteArray(InputStream) - 流转字节数组
    • • drain(InputStream) - 排空流

演示类： StreamUtilsDemo.java

7. ResourceUtils - 资源路径解析器
  • • 包路径：org.springframework.util.ResourceUtils
  • • 核心功能：解析 classpath:、file: 等协议
  • • ⚠️ 重要提醒：生产环境推荐使用 ResourceLoader，此工具在 Fat JAR 中可能失效

演示类： ResourceUtilsDemo.java

【反射和 AOP】

8. ReflectionUtils - 反射操作安全网
  • • 包路径：org.springframework.util.ReflectionUtils
  • • 核心功能：反射调用方法、访问字段
  • • 常用方法：
    • • findMethod() - 查找方法
    • • invokeMethod() - 调用方法
    • • findField() / setField() - 字段操作

⚠️ 提醒：仅推荐在测试中使用，生产代码避免反射

演示类： ReflectionUtilsDemo.java

9. AopProxyUtils - AOP 代理解密器
  • • 包路径：org.springframework.aop.support.AopProxyUtils
  • • 核心功能：获取代理对象的真实类型
  • • 使用场景：调试 AOP 代理、日志打印

演示类： AopProxyUtilsDemo.java

【加密和编码】

10. DigestUtils - 加密工具精简版
  • • 包路径：org.springframework.util.DigestUtils
  • • 核心功能：MD5、SHA-256 摘要计算
  • • ⚠️ 生产警告：MD5 已不安全！密码加密必须用 BCryptPasswordEncoder

示例代码：

String md5 = DigestUtils.md5DigestAsHex("123456".getBytes()); 
// e10adc3949ba59abbe56e057f20f883e

演示类： DigestUtilsDemo.java

11. Base64Utils - Base64 编解码专家
  • • 包路径：org.springframework.util.Base64Utils
  • • 核心功能：Base64 编解码、URL 安全编码
  • • 常用方法：
    • • encodeToString() - 编码为字符串
    • • decodeFromString() - 从字符串解码
    • • encodeToUrlSafeString() - URL 安全编码

演示类： Base64UtilsDemo.java

【性能和路径】

12. StopWatch - 代码耗时统计器
  • • 包路径：org.springframework.util.StopWatch
  • • 核心功能：多任务耗时统计、性能分析
  • • 使用场景：接口性能监控、方法耗时分析

示例代码：

StopWatch watch = new StopWatch("订单服务监控");
watch.start("查询订单");
// 业务逻辑...
watch.stop();
System.out.println(watch.prettyPrint()); // 输出格式化报告

演示类： StopWatchDemo.java

13. AntPathMatcher - 路径匹配引擎
  • • 包路径：org.springframework.util.AntPathMatcher
  • • 核心功能：路径通配符匹配、变量提取
  • • 通配符说明：
    • • ? - 匹配单个字符
    • • * - 匹配任意字符（不含 /）
    • • ** - 匹配任意层级路径

示例代码：

AntPathMatcher matcher = new AntPathMatcher();
boolean match = matcher.match("/api/user/**", "/api/user/1001/profile"); // true

// 提取路径变量
Map<String, String> vars = matcher.extractUriTemplateVariables(
    "/api/user/{id}", "/api/user/1001");
System.out.println(vars.get("id")); // 1001

演示类： AntPathMatcherDemo.java

【Web 工具】

14. MimeTypeUtils - MIME 类型解析器
  • • 包路径：org.springframework.util.MimeTypeUtils
  • • 核心功能：MIME 类型解析、内容协商
  • • 常用常量：APPLICATION_JSON, TEXT_HTML, IMAGE_PNG 等

演示类： MimeTypeUtilsDemo.java

15. UriComponentsBuilder - URL 构建安全专家
  • • 包路径：org.springframework.web.util.UriComponentsBuilder
  • • 核心功能：安全构建 URL、自动编码参数
  • • 核心优势：防止 XSS 注入、自动编码特殊字符

示例代码：

String url = UriComponentsBuilder
    .fromHttpUrl("http://api.example.com/search")
    .queryParam("q", "Spring Boot 教程") // 自动编码中文
    .queryParam("id", 1001)
    .toUriString();

演示类： UriComponentsBuilderDemo.java

【其他工具】

16. ClassUtils - 类操作安全助手
  • • 包路径：org.springframework.util.ClassUtils
  • • 核心功能：类存在性检查、类信息获取
  • • 使用场景：条件化配置、自动配置

示例代码：

// 检查 Redis 依赖是否存在
boolean available = ClassUtils.isPresent(
    "redis.clients.jedis.Jedis", 
    classLoader);

演示类： ClassUtilsDemo.java

17. SystemPropertyUtils - 系统属性占位符解析器
  • • 包路径：org.springframework.util.SystemPropertyUtils
  • • 核心功能：解析 ${user.home} 等占位符
  • • 使用场景：动态生成路径、测试临时目录

示例代码：

String path = SystemPropertyUtils.resolvePlaceholders("${user.home}/logs");
// 输出：/Users/yourname/logs

演示类： SystemPropertyUtilsDemo.java

18. NumberUtils - 数字转换安全卫士
  • • 包路径：org.springframework.util.NumberUtils
  • • 核心功能：字符串安全转数字、类型转换
  • • 常用方法：
    • • parseNumber(String, Class) - 解析数字
    • • convertNumberToTargetClass() - 数字类型转换

演示类： NumberUtilsDemo.java

19. ConcurrentReferenceHashMap - 并发弱引用 Map
  • • 包路径：org.springframework.util.ConcurrentReferenceHashMap
  • • 核心功能：基于弱/软引用的并发 Map，自动回收
  • • 使用场景：轻量级缓存、元数据缓存

⚠️ 提醒：仅用于非关键缓存，生产级缓存用 Caffeine/Redis

演示类： ConcurrentReferenceHashMapDemo.java

20. LinkedMultiValueMap - 多值 Map 实现
  • • 包路径：org.springframework.util.LinkedMultiValueMap
  • • 核心功能：一个 key 对应多个 value，保留插入顺序
  • • 使用场景：HTTP 请求参数、表单提交

示例代码：

MultiValueMap<String, String> params = new LinkedMultiValueMap<>();
params.add("hobby", "篮球");
params.add("hobby", "足球");
System.out.println(params.get("hobby")); // [篮球, 足球]

演示类： LinkedMultiValueMapDemo.java

📊 工具类归属包速查表

工具类所属包依赖模块
StringUtilsorg.springframework.utilspring-core
CollectionUtilsorg.springframework.utilspring-core
ObjectUtilsorg.springframework.utilspring-core
Assertorg.springframework.utilspring-core
FileCopyUtilsorg.springframework.utilspring-core
StreamUtilsorg.springframework.utilspring-core
ResourceUtilsorg.springframework.utilspring-core
ReflectionUtilsorg.springframework.utilspring-core
AopProxyUtilsorg.springframework.aop.supportspring-aop
DigestUtilsorg.springframework.utilspring-core
Base64Utilsorg.springframework.utilspring-core
StopWatchorg.springframework.utilspring-core
AntPathMatcherorg.springframework.utilspring-core
MimeTypeUtilsorg.springframework.utilspring-core
UriComponentsBuilderorg.springframework.web.utilspring-web
ClassUtilsorg.springframework.utilspring-core
SystemPropertyUtilsorg.springframework.utilspring-core
NumberUtilsorg.springframework.utilspring-core
ConcurrentReferenceHashMaporg.springframework.utilspring-core
LinkedMultiValueMaporg.springframework.utilspring-core

🎓 最佳实践总结

✅ 推荐使用场景

  1. 1. StringUtils：任何字符串判空、处理场景
  2. 2. CollectionUtils：任何集合判空、操作场景
  3. 3. Assert：Service 层方法入口参数校验
  4. 4. StopWatch：性能监控、耗时统计
  5. 5. UriComponentsBuilder：任何需要构建 URL 的场景

⚠️ 使用注意事项

  1. 1. ResourceUtils：勿用于生产环境，Fat JAR 中会失败
  2. 2. DigestUtils：MD5 已不安全，密码加密用 BCrypt
  3. 3. ReflectionUtils：仅限测试使用，生产避免反射
  4. 4. ConcurrentReferenceHashMap：仅用于临时缓存

🚫 避免重复造轮子

不要自己写使用 Spring 工具
if (str == nullstr.isEmpty())StringUtils.hasText(str)
if (list == nulllist.isEmpty())CollectionUtils.isEmpty(list)
String.format() 拼接 URLUriComponentsBuilder
手写 MD5 工具类DigestUtils
手写 Base64 工具类Base64Utils

🛠 技术栈

  • • Spring Boot: 3.2.5
  • • Java: 17+
  • • Maven: 3.6+

📝 项目结构

springuitls/
├── src/main/java/com/artisan/springuitls/
│   ├── SpringuitlsApplication.java          # 主启动类
│   ├── SpringUtilsDemoRunner.java           # 演示运行器
│   └── demos/                                # 演示类包
│       ├── StringUtilsDemo.java
│       ├── CollectionUtilsDemo.java
│       ├── ObjectUtilsDemo.java
│       ├── AssertDemo.java
│       ├── FileCopyUtilsDemo.java
│       ├── StreamUtilsDemo.java
│       ├── ResourceUtilsDemo.java
│       ├── ReflectionUtilsDemo.java
│       ├── AopProxyUtilsDemo.java
│       ├── DigestUtilsDemo.java
│       ├── Base64UtilsDemo.java
│       ├── StopWatchDemo.java
│       ├── AntPathMatcherDemo.java
│       ├── MimeTypeUtilsDemo.java
│       ├── UriComponentsBuilderDemo.java
│       ├── ClassUtilsDemo.java
│       ├── SystemPropertyUtilsDemo.java
│       ├── NumberUtilsDemo.java
│       ├── ConcurrentReferenceHashMapDemo.java
│       └── LinkedMultiValueMapDemo.java
├── pom.xml
└── README.md

📖 学习建议

  1. 1. 按顺序学习：从核心工具开始，逐步深入
  2. 2. 动手实践：运行每个演示，观察输出
  3. 3. 对比学习：理解为什么用 Spring 工具而不是第三方库
  4. 4. 应用到项目：在实际项目中替换现有代码

如果这篇文章对您有所帮助，或者有所启发的话，求一键三连：点赞、转发、在看。

关注公众号：woniuxgg，在公众号中回复：笔记  就可以获得蜗牛为你精心准备的java实战语雀笔记，回复面试、开发手册、有超赞的粉丝福利！

avatar
文章
阅读
粉丝