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

    快速校验参数合法性,抛出 IllegalArgumentExceptionIllegalStateException

    示例:

    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);
相关推荐
明月_清风6 小时前
加密解密系统完全指南:原理剖析与 Go 实践
后端
风吹夏回6 小时前
Python 全局异常处理:从“满屏 try-except”到优雅兜底
开发语言·python
小熊Coding7 小时前
Python爬取当当网二手图书项目实战!
开发语言·爬虫·python·beautifulsoup·requests·二手图书
秋97 小时前
Java项目运行5天左右自动宕机:系统性定位与解决方案
java·开发语言·python
小江的记录本7 小时前
【JVM虚拟机】垃圾回收GC:垃圾收集器:CMS:核心原理、回收流程、优缺点、废弃原因(附《思维导图》+《面试高频考点清单》)
java·jvm·后端·python·spring·面试·maven
田里的水稻8 小时前
OE_ubuntu26.04与宿主机之间复制粘贴内容
人工智能·python·机器人
冬奇Lab8 小时前
每日一个开源项目(第105篇):Twenty - 跳出 Salesforce 的圈套,定义现代开源 CRM
前端·后端·开源
jiayong238 小时前
02 创建虚拟环境
python
旺仔来了9 小时前
不联网的Linux下部署python环境
linux·开发语言·python
ServBay9 小时前
月之暗面 Kimi Code 0.4.0 发布,终端 AI 编码助手全面采用 TypeScript,实现毫秒级启动
后端·aigc·ai编程