由於快過年的原因,項目組沒有太多任務,閒來無事研究了一下spring中restful調用。發現spring竟然已經強大到如此境界,程序員已經不需要在關心在寫接口的過程中數據的轉換以及調用,只需要專注業務。下面我總結一下步驟及其在研究過程的遇到的問題。
步驟:
1、git clone https://github.com/spring-guides/gs-rest-service.git 從spring官網上下載了源碼
2、進行maven編譯(gradle也行)
3、運行、訪問http://localhost:8080/greeting
4、運行結果能把對象轉換為json對象返回給頁面
這時我就在思考怎樣能讓請求的數據自動轉換為java對象呢,通過google,發現其實spring已經提供了HttpMessageConverter轉換器,而且默認情況下是加載了 MappingJackson2HttpMessageConverter(json ~object轉換的類)。只需要配置@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; }
這時候我通過谷歌的插件(postman)進行調用,死活調用不成功!
分析問題及解決問題:
這時我感覺問題的原因可能出在如下幾個方面:
1、spring默認沒有加載MappingJackson2HttpMessageConverter(不知道具體加載方式)
2、MappingJackson2HttpMessageConverter加載後不能工作(不知道不工作原因)
其實最後面導致不工作的原因是太相信spring的源碼(對象沒有提供set方法導致),帶著這兩疑問在網上海量搜索者找不到對應結果。沒有辦法只能從根本上找到問題原因,看spring源代碼。
針對第一個問題:
第一步:手動重寫加載類型轉換器
@Configuration @EnableWebMvc public 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 !!!!!"); } }
測試發現還是不能使用,這時就更不清楚原因了。只能看默認情況下spring是怎麼加載類型轉換器的。結果發現在WebMvcConfigurationSupport中這個方法addDefaultHttpMessageConverters(HttpMessageConverter這個關鍵字反射搜索到使用地方通過判斷及其跟蹤找到的)中如下代碼:
@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()); } }
已經加載了相應的默認轉換器。斷點調試說明默認配置是沒有問題的。
只能說明是第二個問題導致的,但是不知道為什麼導致這個問題(json數據問題,還是其他問題),在不知道問題的情況下,只能看request請求過來,轉換器是怎麼工作的。因為本人對spring不是特別了解,所以不知其原理。在這種情況下還是只能根據(HttpMessageConverter)關鍵類找到相應使用地方。以經驗進行判斷和調試。發現在AbstractMessageConverterMethodArgumentResolver中的readWithMessageConverters方法是request請求過來進行類型轉換的處理方法。
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); }
這時候發現其實已經根據HttpMessageConverter的canRead方法已經找到了對應的類型消息轉換器MappingJackson2HttpMessageConverter,而且已經開始進行轉換了,只是拋出了運行時異常。因為異常沒有在控制台輸出。我通過斷點調試發現MappingJackson2HttpMessageConverter的readJavaType方法拋出運行時異常,通過源代碼發現底層是用的jackson的objectMapper進行操作的,代碼如下:
try { return this.objectMapper.readValue(inputMessage.getBody(), javaType); } catch (IOException ex) { throw new HttpMessageNotReadableException("Could not read JSON: " + ex.getMessage(), ex); }
如是我就把代碼單獨拿出來在main方法裡面運行,還是不行,這時我就好定位問題了。要不是類型錯誤,要不是輸入數據錯誤。仔細檢查發現json數據沒有問題,用jsonobject也能進行轉換。這時只能判斷是傳入的javaType有問題導致的。如是我打開發現對象(Greeting)沒有set方法,我想是不是因為此jakson沒法工作呢(原理不清楚)。如是乎我給此對象提供了set方法,再運行可以了。繞了一圈終於把問題解決了,但是通過這個問題讓我更加清楚了spring的restful的工作機制。