SpringMVC restful 註解之@RequestBody進行json與object轉換_javascript技巧

由於快過年的原因，專案組沒有太多任務，閒來無事研究了一下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;
  }

這時候我透過Google的插件（postman）進行調用，死活調用不成功！

分析問題及解決問題：

這時我感覺問題的原因可能出在以下幾個方面：

 1、spring預設沒有載入MappingJackson2HttpMessageConverter（不知道特定載入方式）

 2、MappingJackson2HttpMessageConverter載入後不能工作（不知道不工作原因）

其實最後面導致不工作的原因是太相信spring的源碼(對象沒有提供set方法導致)，帶著這兩疑問在網上海量搜索者找不到對應結果。沒有辦法只能從根本上找到問題原因，看spring原始碼。

針對第一個問題：

    第一步：手動重寫載入型轉換器

@Configuration
  @EnableWebMvc
public class WebConfiguration extends WebMvcConfigurerAdapter {
  public void configureMessageConverters(List<HttpMessageConverter<&#63;>> 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<&#63;>> 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<&#63;> contextClass = methodParam.getContainingClass();
    Class<T> targetClass = (Class<T>) ResolvableType.forType(targetType,
        ResolvableType.forMethodParameter(methodParam)).resolve();
    for (HttpMessageConverter<&#63;> converter : this.messageConverters) {
      if (converter instanceof GenericHttpMessageConverter) {
        GenericHttpMessageConverter<&#63;> genericConverter = (GenericHttpMessageConverter<&#63;>) 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的工作機制。