Spring MVC 接口 ResponseBodyAdvice 及其應(yīng)用最佳實(shí)踐記錄
更新時(shí)間：2025年04月15日 09:56:37 作者：法天象地 日月同輝
ResponseBodyAdvice?是 Spring MVC 提供的一個(gè)強(qiáng)大接口,允許你在響應(yīng)體被寫(xiě)入 HTTP 響應(yīng)之前對(duì)其進(jìn)行全局處理,下面我將全面介紹它的工作原理、使用場(chǎng)景和最佳實(shí)踐,感興趣的朋友一起看看吧
ResponseBodyAdvice 是 Spring MVC 提供的一個(gè)強(qiáng)大接口，允許你在響應(yīng)體被寫(xiě)入 HTTP 響應(yīng)之前對(duì)其進(jìn)行全局處理。
下面我將全面介紹它的工作原理、使用場(chǎng)景和最佳實(shí)踐。
基本概念
接口定義
public interface ResponseBodyAdvice<T> {
boolean supports(MethodParameter returnType, Class<? extends HttpMessageConverter<?>> converterType);
@Nullable
T beforeBodyWrite(@Nullable T body, MethodParameter returnType,
MediaType selectedContentType, Class<? extends HttpMessageConverter<?>> selectedConverterType,
ServerHttpRequest request, ServerHttpResponse response);
}核心方法
supports()
- 決定是否對(duì)該方法的返回值應(yīng)用 advice
- 參數(shù)：
returnType: 控制器方法的返回類(lèi)型信息converterType: 將用于序列化響應(yīng)體的消息轉(zhuǎn)換器類(lèi)型
beforeBodyWrite()
- 在消息轉(zhuǎn)換器寫(xiě)入響應(yīng)體之前對(duì)其進(jìn)行處理
- 參數(shù)：
body: 控制器返回的原始響應(yīng)體- 其他參數(shù)與
supports()相同 request/response: 當(dāng)前請(qǐng)求和響應(yīng)對(duì)象
典型應(yīng)用場(chǎng)景
1. 統(tǒng)一響應(yīng)封裝
最常見(jiàn)的用途是將所有控制器的返回值包裝成統(tǒng)一格式：
@RestControllerAdvice
public class UnifiedResponseAdvice implements ResponseBodyAdvice<Object> {
@Override
public boolean supports(MethodParameter returnType, Class<? extends HttpMessageConverter<?>> converterType) {
return true;
}
@Override
public Object beforeBodyWrite(Object body, MethodParameter returnType,
MediaType selectedContentType,
Class<? extends HttpMessageConverter<?>> selectedConverterType,
ServerHttpRequest request, ServerHttpResponse response) {
if (body instanceof ApiResponse) {
return body;
}
return ApiResponse.success(body);
}
}2. 響應(yīng)數(shù)據(jù)脫敏
對(duì)敏感數(shù)據(jù)進(jìn)行自動(dòng)處理：
@Override
public Object beforeBodyWrite(Object body, MethodParameter returnType,
MediaType selectedContentType,
Class<? extends HttpMessageConverter<?>> selectedConverterType,
ServerHttpRequest request, ServerHttpResponse response) {
if (body instanceof UserInfo) {
UserInfo user = (UserInfo) body;
user.setIdCard(desensitize(user.getIdCard()));
}
return body;
}3. 響應(yīng)數(shù)據(jù)緩存
緩存特定響應(yīng)：
@Override
public Object beforeBodyWrite(Object body, MethodParameter returnType,
MediaType selectedContentType,
Class<? extends HttpMessageConverter<?>> selectedConverterType,
ServerHttpRequest request, ServerHttpResponse response) {
if (request.getURI().getPath().contains("/api/cacheable")) {
cacheManager.put(generateCacheKey(request), body);
}
return body;
}高級(jí)用法與最佳實(shí)踐
1. 精確控制應(yīng)用范圍
通過(guò) supports() 方法精確控制哪些方法需要處理：
@Override
public boolean supports(MethodParameter returnType, Class<? extends HttpMessageConverter<?>> converterType) {
// 只處理標(biāo)注了@ResponseWrap注解的方法
return returnType.hasMethodAnnotation(ResponseWrap.class);
// 或者排除特定包下的控制器
// return !returnType.getDeclaringClass().getPackage().getName().startsWith("org.springdoc");
}2. 處理特殊情況 處理String類(lèi)型返回值
@Override
public Object beforeBodyWrite(Object body, MethodParameter returnType,
MediaType selectedContentType,
Class<? extends HttpMessageConverter<?>> selectedConverterType,
ServerHttpRequest request, ServerHttpResponse response) {
if (body instanceof String) {
response.getHeaders().setContentType(MediaType.APPLICATION_JSON);
return objectMapper.writeValueAsString(ApiResponse.success(body));
}
// 其他處理...
}處理文件下載等非JSON響應(yīng)
@Override
public boolean supports(MethodParameter returnType, Class<? extends HttpMessageConverter<?>> converterType) {
// 排除文件下載等場(chǎng)景
return !ResourceHttpMessageConverter.class.isAssignableFrom(converterType);
}3. 性能優(yōu)化
@RestControllerAdvice
public class CustomResponseAdvice implements ResponseBodyAdvice<Object> {
// 重用ObjectMapper實(shí)例
private static final ObjectMapper objectMapper = new ObjectMapper();
// 預(yù)定義的成功響應(yīng)
private static final ApiResponse<?> EMPTY_SUCCESS = ApiResponse.success(null);
@Override
public Object beforeBodyWrite(Object body, MethodParameter returnType,
MediaType selectedContentType,
Class<? extends HttpMessageConverter<?>> selectedConverterType,
ServerHttpRequest request, ServerHttpResponse response) {
if (body == null) {
return EMPTY_SUCCESS;
}
// 其他處理...
}
}常見(jiàn)問(wèn)題解決方案
1. 與Swagger的兼容性問(wèn)題
@Override
public boolean supports(MethodParameter returnType, Class<? extends HttpMessageConverter<?>> converterType) {
// 排除Swagger相關(guān)的控制器
return !returnType.getDeclaringClass().getPackage().getName().startsWith("springfox.documentation");
}2. 循環(huán)引用問(wèn)題
當(dāng)包裝的對(duì)象存在循環(huán)引用時(shí)，需要在ObjectMapper中配置：
objectMapper.configure(SerializationFeature.FAIL_ON_EMPTY_BEANS, false); objectMapper.configure(SerializationFeature.FAIL_ON_SELF_REFERENCES, false);
3. 異常處理
雖然ResponseBodyAdvice不處理異常，但可以與@ExceptionHandler配合使用：
@ExceptionHandler(Exception.class)
public ApiResponse<?> handleException(Exception e) {
return ApiResponse.failure(e.getMessage());
}完整示例
@RestControllerAdvice
public class GlobalResponseAdvice implements ResponseBodyAdvice<Object> {
private final ObjectMapper objectMapper;
public GlobalResponseAdvice(ObjectMapper objectMapper) {
this.objectMapper = objectMapper;
}
@Override
public boolean supports(MethodParameter returnType, Class<? extends HttpMessageConverter<?>> converterType) {
// 排除Swagger和Actuator端點(diǎn)
return !(returnType.getDeclaringClass().getName().contains("springfox") ||
returnType.getDeclaringClass().getName().contains("org.springframework.boot.actuate"));
}
@Override
public Object beforeBodyWrite(Object body, MethodParameter returnType,
MediaType selectedContentType,
Class<? extends HttpMessageConverter<?>> selectedConverterType,
ServerHttpRequest request, ServerHttpResponse response) {
// 非JSON響應(yīng)不處理
if (!selectedContentType.includes(MediaType.APPLICATION_JSON)) {
return body;
}
// 已經(jīng)是包裝類(lèi)型不處理
if (body instanceof ApiResponse) {
return body;
}
// 處理String類(lèi)型返回值
if (body instanceof String) {
try {
response.getHeaders().setContentType(MediaType.APPLICATION_JSON);
return objectMapper.writeValueAsString(ApiResponse.success(body));
} catch (JsonProcessingException e) {
throw new RuntimeException("JSON序列化失敗", e);
}
}
// 空值處理
if (body == null) {
return ApiResponse.success();
}
// 默認(rèn)包裝
return ApiResponse.success(body);
}
@Data
@NoArgsConstructor
@AllArgsConstructor
public static class ApiResponse<T> {
private int code;
private String message;
private T data;
private long timestamp = System.currentTimeMillis();
public static <T> ApiResponse<T> success() {
return new ApiResponse<>(200, "success", null);
}
public static <T> ApiResponse<T> success(T data) {
return new ApiResponse<>(200, "success", data);
}
}
}通過(guò)合理使用ResponseBodyAdvice，你可以實(shí)現(xiàn)響應(yīng)處理的集中管理，使代碼更加整潔和一致。
到此這篇關(guān)于Spring MVC 接口 ResponseBodyAdvice 及其應(yīng)用最佳實(shí)踐記錄的文章就介紹到這了,更多相關(guān)Spring MVC ResponseBodyAdvice 內(nèi)容請(qǐng)搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持腳本之家！
相關(guān)文章
在IDEA中設(shè)置自動(dòng)創(chuàng)建類(lèi)和方法的注釋可以提高編碼效率,確保代碼的一致性和可讀性,首先,對(duì)于創(chuàng)建類(lèi)的注釋,可以通過(guò)修改File→Settings→File and Code Templates→Class的模板來(lái)實(shí)現(xiàn),其次,對(duì)于方法注釋2024-10-10
這篇文章主要介紹了巧妙mybatis避免Where 空條件的尷尬，具有很好的參考價(jià)值，希望對(duì)大家有所幫助。一起跟隨小編過(guò)來(lái)看看吧2020-11-11
JavaMail是利用現(xiàn)有的郵件賬戶發(fā)送郵件的工具，使用過(guò)JavaMail的api發(fā)送郵件的人可能會(huì)有這樣一個(gè)疑惑：我如何知道我調(diào)用該api發(fā)送的郵件是否成功呢？那么通過(guò)下面這篇文章大家一起來(lái)看看使用JavaMail保證郵件發(fā)送成功的方法，有需要的朋友們可以參考借鑒。2016-11-11
Java中的HashMap內(nèi)存泄漏問(wèn)題詳解
這篇文章主要介紹了Java中的HashMap內(nèi)存泄漏問(wèn)題詳解,WeakHashMap中的key是弱引用,如果再使用之后沒(méi)有及時(shí)remove掉這個(gè)key,那么當(dāng)GC時(shí)key就可能會(huì)被回收,導(dǎo)致key對(duì)應(yīng)的value對(duì)象占用的內(nèi)存無(wú)法回收進(jìn)而導(dǎo)致內(nèi)存泄漏,需要的朋友可以參考下2023-09-09
這篇文章主要介紹了mybatis中resulthandler的用法，具有很好的參考價(jià)值，希望對(duì)大家有所幫助。如有錯(cuò)誤或未考慮完全的地方，望不吝賜教2022-01-01
基于Java編寫(xiě)簡(jiǎn)易的算式測(cè)試程序
本文將利用Java語(yǔ)言編寫(xiě)一個(gè)簡(jiǎn)易的算式測(cè)試程序，這個(gè)程序可以自動(dòng)生成指定數(shù)量的加減乘三則運(yùn)算題目，感興趣的小伙伴可以了解一下2022-05-05
解決idea中yml文件圖標(biāo)問(wèn)題及自動(dòng)提示失效的情況
這篇文章主要介紹了解決idea中yml文件圖標(biāo)問(wèn)題及自動(dòng)提示失效的情況，具有很好的價(jià)值，希望對(duì)大家有所幫助。一起跟隨小編過(guò)來(lái)看看吧2021-01-01
java開(kāi)發(fā)應(yīng)用程序與數(shù)據(jù)庫(kù)交互使用比較多的就是mybatisPlus接口,本文主要介紹了MyBatis-Plus內(nèi)置接口方法的具體使用,具有一定的參考價(jià)值,感興趣的可以了解一下2023-12-12
解決因jdk版本引起的TypeNotPresentExceptionProxy異常
這篇文章介紹了解決因jdk版本引起的TypeNotPresentExceptionProxy異常的方法，對(duì)大家的學(xué)習(xí)或者工作具有一定的參考學(xué)習(xí)價(jià)值，需要的朋友們下面隨著小編來(lái)一起學(xué)習(xí)學(xué)習(xí)吧2021-12-12
這篇文章主要介紹了SpringCache緩存處理詳解,SpringCache是一個(gè)框架,實(shí)現(xiàn)了基于注解緩存功能,只需要簡(jiǎn)單地加一個(gè)注解,就能實(shí)現(xiàn)緩存功能,需要的朋友可以參考下2023-09-09