Spring 的 REST 架構讓開發者可以專注在業務邏輯,而不必手動處理大量資料轉換細節。當前端傳送 JSON 資料時,Spring 可透過 HttpMessageConverter 自動將內容轉成 Java 物件。
若前端以 application/json 格式提交資料,可在 Controller 參數前加上 RequestBody。
@RequestMapping(value = "/greeting", method = RequestMethod.POST, consumes = "application/json")
public @ResponseBody Greeting greeting(@RequestBody Greeting gree) {
System.out.println(gree.getContent());
return gree;
}
在預設情況下,Spring 通常會載入 MappingJackson2HttpMessageConverter,用來處理 JSON 與物件之間的轉換。
如果使用 Postman 或前端工具測試時一直無法成功,可以先檢查以下幾點:
1. 請求是否帶有正確的 Content-Type,例如 application/json。
2. 接收的 Java 物件是否具備必要的 getter 與 setter。
3. JSON 欄位名稱是否與物件屬性一致。
4. 是否已正確引入 Jackson 相關依賴。
其中很常見的問題是物件沒有提供 setter。Jackson 在反序列化 JSON 時,通常需要透過 setter 設定屬性值。若缺少 setter,就可能導致轉換失敗,而且異常不一定會直接顯示在控制台。
若懷疑是轉換器問題,可以從 Spring 的訊息轉換流程著手。Spring 會在 AbstractMessageConverterMethodArgumentResolver 中判斷哪個 HttpMessageConverter 可以讀取目前的內容型別。若已找到 MappingJackson2HttpMessageConverter,但轉換仍失敗,通常要回到 JSON 格式或目標物件本身檢查。
最終解法往往不複雜:確認 JSON 格式正確,並為 Greeting 物件補上 setter,就能讓 RequestBody 正常運作。