av一区二区在线观看_亚洲男人的天堂网站_日韩亚洲视频_在线成人免费_欧美日韩精品免费观看视频_久草视

您的位置:首頁(yè)技術(shù)文章
文章詳情頁(yè)

Spring Boot統(tǒng)一返回體的踩坑記錄

瀏覽:97日期:2023-03-12 10:25:58
前言

在Spring Boot項(xiàng)目中我們可以通過(guò)RestControllerAdvice配合實(shí)現(xiàn)ResponseBodyAdvice<T>接口來(lái)保證Spring MVC接口具有統(tǒng)一的返回格式,以保證前端同學(xué)能夠封裝統(tǒng)一的數(shù)據(jù)接收工具。但是很多網(wǎng)上的文章并沒(méi)有對(duì)實(shí)際開(kāi)發(fā)中的細(xì)節(jié)作出更多的講解。今天胖哥就來(lái)分享一下我的采坑經(jīng)歷,也算作一個(gè)總結(jié)。

控制作用范圍

我記得在前面關(guān)于Swagger3的文章中提過(guò),如果我們不指定范圍將導(dǎo)致Swagger無(wú)法識(shí)別接口的元信息。因此如果你使用了Swagger必須指定其范圍,這里你可以通過(guò)指定掃描包來(lái)指定其作用域:

@RestControllerAdvice('cn.felord.controller')

如果你的Spring MVC控制器有統(tǒng)一的父類(lèi)控制器的話(huà),

@RestController@RequestMapping('/foo')public class FooController extends BaseController { //todo 省略}

也可以這樣:

@RestControllerAdvice(assignableTypes = BaseController.class)白名單

有些接口可能根據(jù)業(yè)務(wù)需要或者協(xié)議需要不能使用統(tǒng)一返回體,例如支付的通知應(yīng)答。這就需要一個(gè)類(lèi)似白名單的機(jī)制來(lái)繞過(guò)統(tǒng)一返回體控制器通知類(lèi)。我們可以借助于ResponseBodyAdvice<T>的下列方法實(shí)現(xiàn):

boolean supports(MethodParameter returnType, Class<? extends HttpMessageConverter<?>> converterType);

這個(gè)方法如果返回false就表示不執(zhí)行統(tǒng)一返回體的封裝邏輯。這里我推薦注解實(shí)現(xiàn)。定義一個(gè)標(biāo)記注解,可以定義在類(lèi)上或者方法上:

@Documented@Inherited@Target({ElementType.ANNOTATION_TYPE, ElementType.METHOD})@Retention(RetentionPolicy.RUNTIME)public @interface IgnoreRestBody {}

然后上面的supports方法這樣實(shí)現(xiàn):

@Overridepublic boolean supports(MethodParameter returnType, Class<? extends HttpMessageConverter<?>> converterType) { return !returnType.hasMethodAnnotation(IgnoreRestBody.class);}

如果某個(gè)Controller下所有的方法都繞過(guò),就把這個(gè)注解標(biāo)記在控制器類(lèi)上;如果只想忽略某個(gè)方法上就把它標(biāo)記在該方法上即可。

返回獨(dú)立字符串的問(wèn)題

有些接口我們會(huì)返回一個(gè)字符串:

@GetMapping('/get')public String getStr(){ //返回了一個(gè)字符串 return 'felord.cn';}

我們希望這個(gè)字符串被統(tǒng)一返回體處理,類(lèi)似這樣:

{ code: 200, data: 'felord.cn', msg: '返回成字符串',}

但是你會(huì)發(fā)現(xiàn)并沒(méi)有達(dá)到期望的效果,會(huì)拋出類(lèi)型轉(zhuǎn)換異常。這是因?yàn)楫?dāng)我們的Spring MVC接口返回?cái)?shù)據(jù)時(shí),會(huì)根據(jù)Content-Type來(lái)選擇一個(gè)HttpMessageConverter來(lái)處理,而字符串在不聲明Content-Type的情況下優(yōu)先使用StringHttpMessageConverter ,就導(dǎo)致了轉(zhuǎn)換異常,需要設(shè)定成MappingJackson2HttpMessageConverter用Jackson來(lái)處理,Spring MVC的對(duì)應(yīng)配置如下:

@Configuration(proxyBeanMethods = false)public class SpringMvcConfiguration implements WebMvcConfigurer { @Override public void configureMessageConverters(List<HttpMessageConverter<?>> converters) {// 解決 String 統(tǒng)一封裝RestBody的問(wèn)題converters.add(0, new MappingJackson2HttpMessageConverter()); }}

嗯,這樣就起效了!你以為這樣就完了?你會(huì)發(fā)現(xiàn)你的JSON序列化不按照你設(shè)置的策略執(zhí)行了。因?yàn)槟鉵ew了一個(gè)而不是采用系統(tǒng)初始化的那個(gè)。解決方法為,將Spring IoC中的ObjectMapper注入到MappingJackson2HttpMessageConverter中去。或者你使用Debug調(diào)試出系統(tǒng)默認(rèn)的MappingJackson2HttpMessageConverter的位置,比如我的索引為7,就可以這樣配置:

@Configuration(proxyBeanMethods = false)public class SpringMvcConfiguration implements WebMvcConfigurer { @Override public void configureMessageConverters(List<HttpMessageConverter<?>> converters) {// 解決 String 統(tǒng)一封裝RestBody的問(wèn)題HttpMessageConverter<?> httpMessageConverter = converters.get(7);if (!(httpMessageConverter instanceof MappingJackson2HttpMessageConverter)) { // 確保正確,如果有改動(dòng)就重新debug throw new RuntimeException('MappingJackson2HttpMessageConverter is not here');}converters.add(0, httpMessageConverter); }}Data的類(lèi)型問(wèn)題

曾經(jīng)一個(gè)安卓開(kāi)發(fā)同學(xué)說(shuō),你這統(tǒng)一結(jié)構(gòu)中的data如果是數(shù)組:

{ code: 200, data: [’a’,’b’], msg: '返回成字符串',}

后續(xù)如果data添加其它與數(shù)組沒(méi)有關(guān)系的屬性就不兼容了,你應(yīng)該保證這個(gè)data是個(gè)Map。是的,這也是問(wèn)題,實(shí)際中發(fā)現(xiàn)不僅僅是數(shù)組,如果是int、long等原始類(lèi)型或者String類(lèi)型都面臨這種情況,需要加一個(gè)額外的判斷body是不是可能改變data類(lèi)型的類(lèi)型:

private boolean checkPrimitive(Object body) { Class<?> clazz = body.getClass(); return clazz.isPrimitive() || clazz.isArray() || Collection.class.isAssignableFrom(clazz) || body instanceof Number || body instanceof Boolean || body instanceof Character || body instanceof String;}

然后我們?cè)赗esponseBodyAdvice<T>實(shí)現(xiàn)中增加一個(gè)判斷:

// 增強(qiáng)擴(kuò)展性if (checkPrimitive(body)) { return RestBody.okData(Collections.singletonMap('result', body));}

就解決問(wèn)題了。

總結(jié)

今天對(duì)Spring Boot中統(tǒng)一返回體的一些細(xì)節(jié)問(wèn)題進(jìn)行了分享,希望能夠幫助你解決一些實(shí)際開(kāi)發(fā)中遇到的同樣問(wèn)題。

到此這篇關(guān)于Spring Boot統(tǒng)一返回體踩坑記錄的文章就介紹到這了,更多相關(guān)Spring Boot統(tǒng)一返回體內(nèi)容請(qǐng)搜索好吧啦網(wǎng)以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持好吧啦網(wǎng)!

標(biāo)簽: Spring
相關(guān)文章:
主站蜘蛛池模板: 久久成人一区 | 美国一级黄色片 | 97超碰在线播放 | 国产精品永久免费观看 | 成人av一区二区亚洲精 | 午夜精品一区二区三区在线播放 | 四虎影院在线播放 | 久久久无码精品亚洲日韩按摩 | 少妇一级淫片免费放播放 | 在线国产一区二区 | 国产aⅴ爽av久久久久久久 | www中文字幕 | 国产中文字幕在线观看 | 国产精品久久久久一区二区三区 | 国际精品久久 | 欧美精品1区 | 一区二区三区四区在线视频 | 羞羞色在线观看 | 精品视频一区二区在线观看 | 在线视频国产一区 | 欧美网站一区 | 午夜无码国产理论在线 | 国产午夜精品视频 | 亚洲午夜精品 | 日批免费观看 | 亚洲一区二区三区桃乃木香奈 | aaa国产大片 | 欧美日本一区 | 国产精彩视频 | av男人天堂影院 | 日韩精品在线视频 | 91免费在线看 | 国产亚洲精品美女久久久久久久久久 | 99re99| 在线观看亚洲精品视频 | 精品久久一区 | 日韩图区 | 久久久毛片 | 国产重口老太伦 | 一区二区三区精品视频 | 亚洲午夜精品一区二区三区 |