由于快過(guò)年的原因,項(xiàng)目組沒(méi)有太多任務(wù),閑來(lái)無(wú)事研究了一下spring中restful調(diào)用。發(fā)現(xiàn)spring竟然已經(jīng)強(qiáng)大到如此境界,程序員已經(jīng)不需要在關(guān)心在寫接口的過(guò)程中數(shù)據(jù)的轉(zhuǎn)換以及調(diào)用,只需要專注業(yè)務(wù)。下面我總結(jié)一下步驟及其在研究過(guò)程的遇到的問(wèn)題。
步驟:
1、git clone https://github.com/spring-guides/gs-rest-service.git 從spring官網(wǎng)上下載了源碼
2、進(jìn)行maven編譯(gradle也行)
3、運(yùn)行、訪問(wèn)http://localhost:8080/greeting
4、運(yùn)行結(jié)果能把對(duì)象轉(zhuǎn)換為json對(duì)象返回給頁(yè)面
這時(shí)我就在思考怎樣能讓請(qǐng)求的數(shù)據(jù)自動(dòng)轉(zhuǎn)換為java對(duì)象呢,通過(guò)google,發(fā)現(xiàn)其實(shí)spring已經(jīng)提供了HttpMessageConverter轉(zhuǎn)換器,而且默認(rèn)情況下是加載了 MappingJackson2HttpMessageConverter(json ~object轉(zhuǎn)換的類)。只需要配置@RequestBody Greeting gree 即可使用。
controller層代碼如下:
@RequestMapping(value = "/greeting", method = RequestMethod.POST,consumes = "application/json") public @ResponseBody Greeting greeting(@RequestBody Greeting gree) { System.out.println(gree.getContent()); return gree; }
這時(shí)候我通過(guò)谷歌的插件(postman)進(jìn)行調(diào)用,死活調(diào)用不成功!
分析問(wèn)題及解決問(wèn)題:
這時(shí)我感覺(jué)問(wèn)題的原因可能出在如下幾個(gè)方面:
1、spring默認(rèn)沒(méi)有加載MappingJackson2HttpMessageConverter(不知道具體加載方式)
2、MappingJackson2HttpMessageConverter加載后不能工作(不知道不工作原因)
其實(shí)最后面導(dǎo)致不工作的原因是太相信spring的源碼(對(duì)象沒(méi)有提供set方法導(dǎo)致),帶著這兩疑問(wèn)在網(wǎng)上海量搜索者找不到對(duì)應(yīng)結(jié)果。沒(méi)有辦法只能從根本上找到問(wèn)題原因,看spring源代碼。
針對(duì)第一個(gè)問(wèn)題:
第一步:手動(dòng)重寫加載類型轉(zhuǎn)換器
@Configuration @EnableWebMvcpublic class WebConfiguration extends WebMvcConfigurerAdapter { public void configureMessageConverters(List<HttpMessageConverter<?>> messageConverters) { System.out.println("init convert is start !!!!!"); StringHttpMessageConverter stringConverter = new StringHttpMessageConverter(); stringConverter.setWriteAcceptCharset(false); messageConverters.add(new MappingJackson2HttpMessageConverter()); System.out.println("init convert is stop !!!!!"); }}
測(cè)試發(fā)現(xiàn)還是不能使用,這時(shí)就更不清楚原因了。只能看默認(rèn)情況下spring是怎么加載類型轉(zhuǎn)換器的。結(jié)果發(fā)現(xiàn)在WebMvcConfigurationSupport中這個(gè)方法addDefaultHttpMessageConverters(HttpMessageConverter這個(gè)關(guān)鍵字反射搜索到使用地方通過(guò)判斷及其跟蹤找到的)中如下代碼:
@SuppressWarnings("deprecation") protected final void addDefaultHttpMessageConverters(List<HttpMessageConverter<?>> messageConverters) { StringHttpMessageConverter stringConverter = new StringHttpMessageConverter(); stringConverter.setWriteAcceptCharset(false); messageConverters.add(new ByteArrayHttpMessageConverter()); messageConverters.add(stringConverter); messageConverters.add(new ResourceHttpMessageConverter()); messageConverters.add(new SourceHttpMessageConverter<Source>()); messageConverters.add(new AllEncompassingFormHttpMessageConverter()); if (romePresent) { messageConverters.add(new AtomFeedHttpMessageConverter()); messageConverters.add(new RssChannelHttpMessageConverter()); } if (jaxb2Present) { messageConverters.add(new Jaxb2RootElementHttpMessageConverter()); } if (jackson2Present) { messageConverters.add(new MappingJackson2HttpMessageConverter()); } else if (jacksonPresent) { messageConverters.add(new org.springframework.http.converter.json.MappingJacksonHttpMessageConverter()); } }
已經(jīng)加載了相應(yīng)的默認(rèn)轉(zhuǎn)換器。斷點(diǎn)調(diào)試說(shuō)明默認(rèn)配置是沒(méi)有問(wèn)題的。
只能說(shuō)明是第二個(gè)問(wèn)題導(dǎo)致的,但是不知道為什么導(dǎo)致這個(gè)問(wèn)題(json數(shù)據(jù)問(wèn)題,還是其他問(wèn)題),在不知道問(wèn)題的情況下,只能看request請(qǐng)求過(guò)來(lái),轉(zhuǎn)換器是怎么工作的。因?yàn)楸救藢?duì)spring不是特別了解,所以不知其原理。在這種情況下還是只能根據(jù)(HttpMessageConverter)關(guān)鍵類找到相應(yīng)使用地方。以經(jīng)驗(yàn)進(jìn)行判斷和調(diào)試。發(fā)現(xiàn)在AbstractMessageConverterMethodArgumentResolver中的readWithMessageConverters方法是request請(qǐng)求過(guò)來(lái)進(jìn)行類型轉(zhuǎn)換的處理方法。
protected <T> Object readWithMessageConverters(HttpInputMessage inputMessage, MethodParameter methodParam, Type targetType) throws IOException, HttpMediaTypeNotSupportedException { MediaType contentType; try { contentType = inputMessage.getHeaders().getContentType(); } catch (InvalidMediaTypeException ex) { throw new HttpMediaTypeNotSupportedException(ex.getMessage()); } if (contentType == null) { contentType = MediaType.APPLICATION_OCTET_STREAM; } Class<?> contextClass = methodParam.getContainingClass(); Class<T> targetClass = (Class<T>) ResolvableType.forType(targetType, ResolvableType.forMethodParameter(methodParam)).resolve(); for (HttpMessageConverter<?> converter : this.messageConverters) { if (converter instanceof GenericHttpMessageConverter) { GenericHttpMessageConverter<?> genericConverter = (GenericHttpMessageConverter<?>) converter; if (genericConverter.canRead(targetType, contextClass, contentType)) { if (logger.isDebugEnabled()) { logger.debug("Reading [" + targetType + "] as /"" + contentType + "/" using [" + converter + "]"); } return genericConverter.read(targetType, contextClass, inputMessage); } } if (targetClass != null) { if (converter.canRead(targetClass, contentType)) { if (logger.isDebugEnabled()) { logger.debug("Reading [" + targetClass.getName() + "] as /"" + contentType + "/" using [" + converter + "]"); } return ((HttpMessageConverter<T>) converter).read(targetClass, inputMessage); } } } throw new HttpMediaTypeNotSupportedException(contentType, allSupportedMediaTypes); }
這時(shí)候發(fā)現(xiàn)其實(shí)已經(jīng)根據(jù)HttpMessageConverter的canRead方法已經(jīng)找到了對(duì)應(yīng)的類型消息轉(zhuǎn)換器MappingJackson2HttpMessageConverter,而且已經(jīng)開始進(jìn)行轉(zhuǎn)換了,只是拋出了運(yùn)行時(shí)異常。因?yàn)楫惓](méi)有在控制臺(tái)輸出。我通過(guò)斷點(diǎn)調(diào)試發(fā)現(xiàn)MappingJackson2HttpMessageConverter的readJavaType方法拋出運(yùn)行時(shí)異常,通過(guò)源代碼發(fā)現(xiàn)底層是用的jackson的objectMapper進(jìn)行操作的,代碼如下:
try { return this.objectMapper.readValue(inputMessage.getBody(), javaType); } catch (IOException ex) { throw new HttpMessageNotReadableException("Could not read JSON: " + ex.getMessage(), ex); }
如是我就把代碼單獨(dú)拿出來(lái)在main方法里面運(yùn)行,還是不行,這時(shí)我就好定位問(wèn)題了。要不是類型錯(cuò)誤,要不是輸入數(shù)據(jù)錯(cuò)誤。仔細(xì)檢查發(fā)現(xiàn)json數(shù)據(jù)沒(méi)有問(wèn)題,用jsonobject也能進(jìn)行轉(zhuǎn)換。這時(shí)只能判斷是傳入的javaType有問(wèn)題導(dǎo)致的。如是我打開發(fā)現(xiàn)對(duì)象(Greeting)沒(méi)有set方法,我想是不是因?yàn)榇薺akson沒(méi)法工作呢(原理不清楚)。如是乎我給此對(duì)象提供了set方法,再運(yùn)行可以了。繞了一圈終于把問(wèn)題解決了,但是通過(guò)這個(gè)問(wèn)題讓我更加清楚了spring的restful的工作機(jī)制。