深入理解Spring系列之十一:SpringMVC-@RequestBody接收json數據報415

網絡上對這個問題的分析及解決不是很深入,大部分并不能解決問題,而且內容基本相同,拿來主義,把內容放在自己的博客上!

報錯原因可能有兩種情況:
1.請求頭中沒有設置Content-Type參數,或Content-Type參數值不是application/json;
2.請求頭中正確設置了Content-Type參數及參數值,但是在項目jar依賴中(pom.xml或build.gradle)沒有添加處理json字符串的處理類,如果SpringMVC框架在啟動的時候,檢查com.fasterxml.jackson.databind.ObjectMapper和com.fasterxml.jackson.core.JsonGenerator有一個不存在或不能加載,則不會注冊MappingJackson2HttpMessageConverter,這個類使用Jackson將json請求參數轉成相應的方法參數;同樣檢查com.google.gson.Gson,如果不存在或不能加載,則不會注冊GsonHttpMessageConverter,這個類使用Gson將json請求參數轉成相應的方法參數;如果依賴的Jackson和Gson都沒有被添加或不能加載,則SpringMVC將找不到對應的參數處理類。

源碼分析

在使用SpringMVC的時候,都會添加<mvc:annotation-driven />注解,這個注解下有很多可以配置的擴展參數,有興趣的可以研究一下。有這個注解,就必定有對應的注解解析,查看NamespaceHandler接口的實現類,發現有一個MvcNamespaceHandler。

image.png

annotation-driven注解做了什么,直接看AnnotationDrivenBeanDefinitionParser類。這個類中主要的就是parse方法,這個方法中做了很多重要的事,如對一些可擴展的參數進行了解析注冊,這些不是本篇的重點,有興趣的可以研究一下,關注重點代碼。

image.png

代碼中的messageConverters是消息轉換器集合,里面包含了對json、xml、atom、rss格式報文的轉換。接著,把messageConverters添加到RequestMappingHandlerAdapter中,RequestMappingHandlerAdapter是處理@RequestMapping注解的HandlerAdapter,簡單說就是標注了@RequestMapping注解的Controller,是經過RequestMappingHandlerAdapter進行調用的。messageConverters是它的一個屬性,代碼如下。

image.png

繼續看AnnotationDrivenBeanDefinitionParser類,分析上圖紅框中的ManagedList<?> messageConverters = getMessageConverters(element, source, parserContext),深入這個getMessageConverters方法。

image.png

romePresent、jaxb2Present、jackson2Present、jackson2XmlPresent、gsonPresent為true則將對應的轉換器包裝成BeanDefinition,然后將其添加到messageConverters集合中。這幾個布爾變量的值在AnnotationDrivenBeanDefinitionParser類的開頭處就賦值了。

image.png

如果相應的實現類存在并且可以被加載,則對應的布爾變量值為true,否則為false。也就是說,如果SpringMVC框架在啟動的時候,檢查com.fasterxml.jackson.databind.ObjectMapper和com.fasterxml.jackson.core.JsonGenerator有一個不存在或不能加載,則不會注冊MappingJackson2HttpMessageConverter,這個類使用Jackson將json請求參數轉成相應的方法參數;同樣檢查com.google.gson.Gson,如果不存在或不能加載,則不會注冊GsonHttpMessageConverter,這個類使用Gson將json請求參數轉成相應的方法參數;如果依賴的Jackson和Gson都沒有被添加或不能加載,則SpringMVC將找不到json參數轉換類,也就沒辦法處理。

如果配置了json參數轉換處理類,SpringMVC框架將根據請求頭中的Content-Type參數遍歷messageConverters,選擇匹配的轉換器類,進行參數轉換。如果Content-Type參數值類型是messageConverters中不支持的,那么就沒辦法做轉換。

總結

首先,SpringMVC框架在啟動的時候會遍歷Spring容器中的所有bean,對標注了@Controller或@RequestMapping注解的類中方法進行遍歷,將類和方法上的@RequestMapping注解值進行合并,使用@RequestMapping注解的相關參數值(如value、method等)封裝一個RequestMappingInfo,將這個Controller實例、方法及方法參數信息(類型、注解等)封裝到HandlerMethod中,然后以RequestMappingInfo為key,HandlerMethod為value存到一個以Map為結構的handlerMethods中。

接著,將@RequestMapping注解中的value(即請求路徑)值取出,即url,然后以url為key,以RequestMappingInfo為value,存到一個以Map為結構的urlMap屬性中。

客戶端發起請求的時候,根據請求的URL到urlMap中查找,找到RequestMappingInfo,然后根據RequestMappingInfo到handlerMethods中查找,找到對應的HandlerMethod,接著將HandlerMethod封裝到HandlerExecutionChain;接著遍歷容器中所有HandlerAdapter實現類,找到支持這次請求的HandlerAdapter,如RequestMappingHandlerAdapter,然后執行SpringMVC攔截器的前置方法(preHandle方法),然后對請求參數解析及轉換,這里主要根據HandlerMethod中封裝的參數信息(方法參數上的注解)來遍歷argumentResolvers(List結構,存儲了HandlerMethodArgumentResolver接口實現類,不同實現類,實現對不同注解參數的解析,如RequestResponseBodyMethodProcessor可以實現對@RequestBody和@ResponseBody參數的解析),找到支持這個注解的HandlerMethodArgumentResolver實現類,然后解析請求參數。

插播一下請求參數的解析及轉換,下圖是HandlerMethodArgumentResolver接口的實現類。

image.png

從上圖中可以看到很多常見注解參數的解析類,這里分析RequestResponseBodyMethodProcessor,其它處理類感興趣的可以自己研究一下。RequestResponseBodyMethodProcessor會從請求頭中獲取Content-Type參數值,例如application/json,然后遍歷messageConverters,查找能夠處理這種Content-Type的轉換器類,如果messageConverters中有可以處理application/json請求的處理類,如Jackson或Gson,則使用Jackson或Gson對請求體中的參數進行讀取轉換,轉換成具體方法參數類型,下面是Jackson具體的處理代碼。

image.png

如果messageConverters沒有匹配的處理類,那就會報415。

最后,(使用反射)調用具體Controller的對應方法返回一個ModelAndView對象,執行攔截器的后置方法(postHandle方法),然后對返回的結果進行處理,最后執行afterCompletion方法。

最后編輯于
?著作權歸作者所有,轉載或內容合作請聯系作者
平臺聲明:文章內容(如有圖片或視頻亦包括在內)由作者上傳并發布,文章內容僅代表作者本人觀點,簡書系信息發布平臺,僅提供信息存儲服務。
  • 序言:七十年代末,一起剝皮案震驚了整個濱河市,隨后出現的幾起案子,更是在濱河造成了極大的恐慌,老刑警劉巖,帶你破解...
    沈念sama閱讀 229,836評論 6 540
  • 序言:濱河連續發生了三起死亡事件,死亡現場離奇詭異,居然都是意外死亡,警方通過查閱死者的電腦和手機,發現死者居然都...
    沈念sama閱讀 99,275評論 3 428
  • 文/潘曉璐 我一進店門,熙熙樓的掌柜王于貴愁眉苦臉地迎上來,“玉大人,你說我怎么就攤上這事。” “怎么了?”我有些...
    開封第一講書人閱讀 177,904評論 0 383
  • 文/不壞的土叔 我叫張陵,是天一觀的道長。 經常有香客問我,道長,這世上最難降的妖魔是什么? 我笑而不...
    開封第一講書人閱讀 63,633評論 1 317
  • 正文 為了忘掉前任,我火速辦了婚禮,結果婚禮上,老公的妹妹穿的比我還像新娘。我一直安慰自己,他們只是感情好,可當我...
    茶點故事閱讀 72,368評論 6 410
  • 文/花漫 我一把揭開白布。 她就那樣靜靜地躺著,像睡著了一般。 火紅的嫁衣襯著肌膚如雪。 梳的紋絲不亂的頭發上,一...
    開封第一講書人閱讀 55,736評論 1 328
  • 那天,我揣著相機與錄音,去河邊找鬼。 笑死,一個胖子當著我的面吹牛,可吹牛的內容都是我干的。 我是一名探鬼主播,決...
    沈念sama閱讀 43,740評論 3 446
  • 文/蒼蘭香墨 我猛地睜開眼,長吁一口氣:“原來是場噩夢啊……” “哼!你這毒婦竟也來了?” 一聲冷哼從身側響起,我...
    開封第一講書人閱讀 42,919評論 0 289
  • 序言:老撾萬榮一對情侶失蹤,失蹤者是張志新(化名)和其女友劉穎,沒想到半個月后,有當地人在樹林里發現了一具尸體,經...
    沈念sama閱讀 49,481評論 1 335
  • 正文 獨居荒郊野嶺守林人離奇死亡,尸身上長有42處帶血的膿包…… 初始之章·張勛 以下內容為張勛視角 年9月15日...
    茶點故事閱讀 41,235評論 3 358
  • 正文 我和宋清朗相戀三年,在試婚紗的時候發現自己被綠了。 大學時的朋友給我發了我未婚夫和他白月光在一起吃飯的照片。...
    茶點故事閱讀 43,427評論 1 374
  • 序言:一個原本活蹦亂跳的男人離奇死亡,死狀恐怖,靈堂內的尸體忽然破棺而出,到底是詐尸還是另有隱情,我是刑警寧澤,帶...
    沈念sama閱讀 38,968評論 5 363
  • 正文 年R本政府宣布,位于F島的核電站,受9級特大地震影響,放射性物質發生泄漏。R本人自食惡果不足惜,卻給世界環境...
    茶點故事閱讀 44,656評論 3 348
  • 文/蒙蒙 一、第九天 我趴在偏房一處隱蔽的房頂上張望。 院中可真熱鬧,春花似錦、人聲如沸。這莊子的主人今日做“春日...
    開封第一講書人閱讀 35,055評論 0 28
  • 文/蒼蘭香墨 我抬頭看了看天上的太陽。三九已至,卻和暖如春,著一層夾襖步出監牢的瞬間,已是汗流浹背。 一陣腳步聲響...
    開封第一講書人閱讀 36,348評論 1 294
  • 我被黑心中介騙來泰國打工, 沒想到剛下飛機就差點兒被人妖公主榨干…… 1. 我叫王不留,地道東北人。 一個月前我還...
    沈念sama閱讀 52,160評論 3 398
  • 正文 我出身青樓,卻偏偏與公主長得像,于是被迫代替她去往敵國和親。 傳聞我的和親對象是個殘疾皇子,可洞房花燭夜當晚...
    茶點故事閱讀 48,380評論 2 379

推薦閱讀更多精彩內容