SpringBoot 內(nèi)置的 20 個高效工具類

還在自己寫工具類？你已經(jīng)被SpringBoot拋棄了！很多人嘴上說“別重復(fù)造輪子”，結(jié)果還在項目里一遍遍寫String工具、Bean拷貝、文件處理、反射操作……

SpringBoot 內(nèi)置了 20個寶藏工具類，輕量級、性能強(qiáng)、低耦合，很多大廠架構(gòu)師都在用，可你可能連名字都沒聽過！

有人說：“用這些就像開了外掛?！币灿腥苏f：“太黑箱，寧愿自己寫?！蹦阍趺纯?？

一、數(shù)據(jù)處理

1. StringUtils

Spring 提供的 StringUtils 相比 Apache Commons Lang 版本更加輕量，且與 Spring 生態(tài)完美集成。它提供了字符串判空、截取、拼接等常用操作，比如：

// 判斷字符串是否為空
StringUtils.isEmpty(str); 

// 判斷字符串是否有內(nèi)容
StringUtils.hasText(str);

// 數(shù)組合并成字符串
StringUtils.arrayToCommaDelimitedString(arr);

2. ObjectUtils

處理對象判空和默認(rèn)值時，不要再寫 if-else 了：

// 安全判空
ObjectUtils.isEmpty(obj);

// 獲取第一個非空對象
ObjectUtils.firstNonNull(obj1, obj2, defaultValue);

// 空安全toString
ObjectUtils.nullSafeToString(obj);

3. CollectionUtils

Spring 的集合工具類讓集合操作更加優(yōu)雅：

// 集合判空
CollectionUtils.isEmpty(collection);

// 查找第一個匹配元素
CollectionUtils.find(collection, predicate);

// 合并數(shù)組
CollectionUtils.mergeArrayIntoCollection(arr, collection);

二、HTTP 請求

1. RestTemplate傳統(tǒng)同步請求

雖然已被標(biāo)記為過時，但在非響應(yīng)式項目中依然實用：

// 簡單GET請求
String result = restTemplate.getForObject(url, String.class);

// 帶參數(shù)的POST請求
ResponseEntity<String> response = restTemplate.postForEntity(
    url, request, String.class);

2. WebClient

Spring 5 引入的響應(yīng)式 HTTP 客戶端：

WebClient.create()
    .get()
    .uri(url)
    .retrieve()
    .bodyToMono(String.class)
    .subscribe(result -> System.out.println(result));

3. TestTemplate

專門為測試設(shè)計的增強(qiáng)版 RestTemplate：

@Test
public void testApi() {
    ResponseEntity<String> response = testRestTemplate
        .getForEntity("/api/test", String.class);
    assertThat(response.getStatusCode()).isEqualTo(HttpStatus.OK);
}

4. MockRestServiceServer

測試時模擬外部 API 調(diào)用：

MockRestServiceServer server = MockRestServiceServer
    .bindTo(restTemplate).build();

server.expect(requestTo("/external/api"))
    .andRespond(withSuccess("mock response", MediaType.APPLICATION_JSON));

三、緩存 & 異步

1. CacheManager

Spring 的緩存抽象層支持多種實現(xiàn)：

@Cacheable(value = "users", key = "#id")
public User getUser(Long id) {
    // 數(shù)據(jù)庫查詢
}

@CacheEvict(value = "users", key = "#id")
public void updateUser(User user) {
    // 更新邏輯
}

2. @Async + TaskExecutor

輕松實現(xiàn)方法異步執(zhí)行：

@Async
public CompletableFuture<User> asyncGetUser(Long id) {
    // 耗時操作
    return CompletableFuture.completedFuture(user);
}

// 配置線程池
@Bean
public TaskExecutor taskExecutor() {
    ThreadPoolTaskExecutor executor = new ThreadPoolTaskExecutor();
    executor.setCorePoolSize(5);
    return executor;
}

3. EventPublishe

實現(xiàn)應(yīng)用內(nèi)事件發(fā)布訂閱：

// 定義事件
public class UserRegisteredEvent extends ApplicationEvent {
    public UserRegisteredEvent(User user) {
        super(user);
    }
}

// 發(fā)布事件
applicationEventPublisher.publishEvent(new UserRegisteredEvent(user));

// 監(jiān)聽事件
@EventListener
public void handleEvent(UserRegisteredEvent event) {
    // 處理邏輯
}

四、校驗 & 日志

1. Assert

Spring 的斷言工具讓參數(shù)檢查更簡潔：

// 參數(shù)校驗
Assert.notNull(param, "參數(shù)不能為空");
Assert.isTrue(value > 0, "值必須大于0");

// 狀態(tài)檢查
Assert.state(isValid, "狀態(tài)不合法");

2. @Validated + BindingResult

結(jié)合 JSR-303 實現(xiàn)參數(shù)校驗：

@PostMapping("/users")
public ResponseEntity createUser(
    @Validated @RequestBody User user,
    BindingResult result) {
    
    if (result.hasErrors()) {
        // 處理校驗錯誤
    }
    // 業(yè)務(wù)邏輯
}

3. Logback/Log4j2

SpringBoot 自動配置的日志系統(tǒng)：

# application.properties
logging.level.root=INFO
logging.level.com.example=DEBUG
logging.file.name=app.log
logging.pattern.console=%d{yyyy-MM-dd HH:mm:ss} [%thread] %-5level %logger{36} - %msg%n

五、測試 & 調(diào)試

1. MockMvc

測試 Controller 層的利器：

@SpringBootTest
@AutoConfigureMockMvc
class UserControllerTest {

    @Autowired
    private MockMvc mockMvc;

    @Test
    void testGetUser() throws Exception {
        mockMvc.perform(get("/users/1"))
            .andExpect(status().isOk())
            .andExpect(jsonPath("$.name").value("張三"));
    }
}

2. OutputCapture

捕獲并驗證日志輸出：

@SpringBootTest
class LoggingTest {

    @Autowired
    private MyService service;

    @Rule
    public OutputCapture outputCapture = new OutputCapture();

    @Test
    void testLogging() {
        service.doSomething();
        assertThat(outputCapture.toString())
            .contains("操作已完成");
    }
}

3. TestPropertyValues

靈活修改測試環(huán)境配置：

@Test
void testWithDynamicProperties() {
    TestPropertyValues.of(
        "app.timeout=5000",
        "app.enabled=true"
    ).applyTo(environment);
    
    // 執(zhí)行測試
}

4. SpringBootTest

完整的集成測試支持：

@SpringBootTest(
    webEnvironment = WebEnvironment.RANDOM_PORT,
    properties = {"app.env=test"}
)
class FullIntegrationTest {

    @LocalServerPort
    private int port;

    @Test
    void testFullStack() {
        // 測試完整應(yīng)用棧
    }
}

六、冷門但實用的工具

1. BannerCustomizer

讓應(yīng)用啟動更有個性：

@Bean
public BannerCustomizer myBannerCustomizer() {
    return banner -> {
        banner.setBanner(new ResourceBanner(
            new ClassPathResource("banner.txt")));
        banner.setMode(Banner.Mode.LOG);
    };
}

2. Environment

靈活訪問環(huán)境變量和配置：

@Autowired
private Environment env;

public void someMethod() {
    String dbUrl = env.getProperty("spring.datasource.url");
    boolean debug = env.getProperty("app.debug", Boolean.class, false);
}

3. SpelExpressionParser

運(yùn)行時執(zhí)行 SpEL 表達(dá)式：

ExpressionParser parser = new SpelExpressionParser();
Expression exp = parser.parseExpression("name.toUpperCase()");

String result = exp.getValue(userContext, String.class);