Spring Boot 内置工具类汇总与讲解

Spring Boot 提供了许多内置工具类,这些类大多继承自 Spring Framework,旨在简化常见开发任务(如配置处理、资源加载、Bean 操作等)。以下是常用的工具类及其典型应用场景:


1. 应用启动与配置工具

  • SpringApplication

    用于启动 Spring Boot 应用的核心类,支持自定义 Banner、配置文件、监听器等。

    示例:SpringApplication.run(MyApp.class, args);

  • SpringApplicationBuilder

    链式 API 构建应用,支持多环境配置、父子上下文等。

    示例:

    java 复制代码
    new SpringApplicationBuilder(MyApp.class)
        .profiles("dev")
        .run(args);
  • ApplicationArguments

    解析命令行参数,区分 --key=value 格式和非选项参数。

    示例:

    java 复制代码
    @Autowired
    private ApplicationArguments args;
    List<String> nonOptionArgs = args.getNonOptionArgs();

2. 环境配置与属性读取

  • Environment

    获取应用配置(如 application.properties 中的属性、系统变量等)。

    示例:

    java 复制代码
    @Autowired
    private Environment env;
    String port = env.getProperty("server.port");
  • @ConfigurationProperties

    将配置属性绑定到 Java 对象,支持类型安全访问。

    示例:

    java 复制代码
    @ConfigurationProperties(prefix = "myapp")
    public class MyConfig {
        private String name;
        // getter/setter
    }

3. Bean 操作工具

  • ApplicationContextAware

    获取 Spring 上下文,动态获取 Bean。

    示例:

    java 复制代码
    @Component
    public class MyBean implements ApplicationContextAware {
        private ApplicationContext context;
        @Override
        public void setApplicationContext(ApplicationContext context) {
            this.context = context;
        }
        public Object getBean(String name) {
            return context.getBean(name);
        }
    }
  • BeanUtils

    复制 Bean 属性、实例化对象等。

    示例:

    java 复制代码
    MyBean dest = new MyBean();
    BeanUtils.copyProperties(source, dest); // 同名属性复制
  • ObjectProvider

    延迟注入 Bean,避免依赖不存在时的异常。

    示例:

    java 复制代码
    @Autowired
    private ObjectProvider<MyService> myServiceProvider;
    MyService service = myServiceProvider.getIfAvailable();

4. 资源处理工具

  • ResourceUtils

    获取类路径、文件系统中的资源。

    示例:

    java 复制代码
    File file = ResourceUtils.getFile("classpath:config/file.txt");
  • FileCopyUtils

    简化文件复制和内容读写。

    示例:

    java 复制代码
    byte[] data = FileCopyUtils.copyToByteArray(new FileInputStream("test.txt"));

5. 断言与校验工具

  • Assert

    快速校验参数合法性,抛出 IllegalArgumentException 或 IllegalStateException。

    示例:

    java 复制代码
    Assert.notNull(obj, "对象不能为空");
    Assert.hasText(str, "字符串必须非空");
  • ValidationUtils

    结合 Spring Validator 进行数据校验。

    示例:

    java 复制代码
    ValidationUtils.rejectIfEmpty(errors, "name", "name.empty");

6. 集合与对象工具

  • CollectionUtils

    集合判空、合并、过滤等操作。

    示例:

    java 复制代码
    if (CollectionUtils.isEmpty(list)) { ... }
  • ObjectUtils

    对象判空、默认值处理。

    示例:

    java 复制代码
    String value = ObjectUtils.defaultIfNull(str, "default");

7. SpEL 表达式工具

  • SpelExpressionParser
    解析 SpEL 表达式,动态求值。
    示例:

    java 复制代码
    ExpressionParser parser = new SpelExpressionParser();
    Expression exp = parser.parseExpression("'Hello ' + name");
    String result = exp.getValue(context, String.class);

8. AOP 工具

  • AopUtils
    判断代理类型、获取目标类等。
    示例:

    java 复制代码
    if (AopUtils.isAopProxy(bean)) { ... }

9. 事件与监听

  • ApplicationEventPublisher
    发布自定义事件。
    示例:

    java 复制代码
    @Autowired
    private ApplicationEventPublisher publisher;
    publisher.publishEvent(new MyEvent("事件内容"));

10. Web 相关工具

  • ResponseEntity

    封装 HTTP 响应,包括状态码、头信息、响应体。

    示例:

    java 复制代码
    return ResponseEntity.status(HttpStatus.OK).body("Success");
  • ServletUtils

    处理请求与响应(如获取请求参数)。

    示例:

    java 复制代码
    HttpServletRequest request = ServletUtils.getRequest();

11. 测试工具

  • TestPropertySource

    为测试类指定配置文件。

    示例:

    java 复制代码
    @TestPropertySource(locations = "classpath:test.properties")
  • MockMvc

    模拟 HTTP 请求,测试 Controller 层。

    示例:

    java 复制代码
    mockMvc.perform(get("/api/data"))
           .andExpect(status().isOk());

12. 其他工具

  • StringUtils

    字符串判空、截断、分割等(org.springframework.util 包)。

    示例:

    java 复制代码
    if (StringUtils.hasText(str)) { ... }
  • JsonUtils

    (需配合 Jackson)JSON 序列化与反序列化。

    示例:

    java 复制代码
    String json = JsonUtils.toJson(obj);
    MyObject obj = JsonUtils.fromJson(json, MyObject.class);
相关推荐
宋冠巡2 分钟前
Spring Boot 4 + OpenTelemetry + Spring Cloud Gateway:全链路 TraceId 传播验证
spring boot·可观测性·traceid
承渊政道9 分钟前
【Python编程—从入门到实践】(设置样式并部署:给Django网站换新装,把学习笔记发布到互联网)
python·学习·pycharm·django
我不会起名字32218 分钟前
仅 Web 主动 ping:30 秒读超时与各平台保活
前端·后端·websocket·go·即时通讯·im·故障排查
用户2986985301435 分钟前
使用 Python 将 JSON 转换为 Word 文档的实践指南
python·json·api
Mh37 分钟前
AI 的模型能力越来越强,为什么我的编码能力越来越弱?
前端·javascript·后端
下一站春风里40 分钟前
Spring IoC 控制反转 完整技术笔记
java·spring boot·笔记·spring
新*41 分钟前
Elasticsearch 索引别名入门:创建、路由、原子切换与几个常见误解
运维·后端·elasticsearch·索引别名
挖掘狂人44 分钟前
用户连点两次「确认支付」,你的后端凭什么只扣一次钱?
java·后端·面试
卷无止境1 小时前
AI 加速开发之后,如何应对尚未发现的代码安全威胁
后端·python
Rain的Java大神之路1 小时前
面试官问"MySQL 大表 COUNT(*) 怎么优化",90% 的人第一步就答错了
java·后端·面试