Spring MVC 學習資料整理：@RequestBody/@ResponseBody 實現 Java 對象與 XML/JSON 自動轉換

Spring MVC 學習資料整理：@RequestBody/@ResponseBody 實現 Java 對象與 XML/JSON 自動轉換

Spring MVC 通過 HttpMessageConverter 機制實現請求體/響應體與 Java 對象的自動雙向轉換。本文整理核心註解用法、配置要點、常見轉換器、避坑指南，並推薦優質學習資源鏈接。

核心註解

典型 Controller 寫法

@RestController
@RequestMapping("/api/users")
public class UserController {

    @PostMapping(consumes = MediaType.APPLICATION_JSON_VALUE)
    public User create(@RequestBody @Valid UserDTO dto) {
        // 自動將 JSON 反序列化為 UserDTO
        return userService.save(dto);
    }

    @GetMapping("/{id}", produces = MediaType.APPLICATION_JSON_VALUE)
    public User get(@PathVariable Long id) {
        // 自動將 User 序列化為 JSON
        return userService.findById(id);
    }

    @GetMapping(value = "/{id}/xml", produces = MediaType.APPLICATION_XML_VALUE)
    public User getXml(@PathVariable Long id) {
        // 同樣對象，根據 produces 自動輸出 XML
        return userService.findById(id);
    }
}

HttpMessageConverter 自動配置與自定義

Spring Boot 默認註冊以下轉換器（優先級順序）：

1. ByteArrayHttpMessageConverter (application/octet-stream)
2. StringHttpMessageConverter (text/plain)
3. ResourceHttpMessageConverter (application/octet-stream)
4. MappingJackson2HttpMessageConverter (application/json, **依賴 jackson-databind**)
5. MappingJackson2XmlHttpMessageConverter (application/xml, **依賴 jackson-dataformat-xml**)
6. Jaxb2RootElementHttpMessageConverter (application/xml, 依賴 JAXB)

添加 XML 支持 (Spring Boot 2.x/3.x)

<dependency>
    <groupId>com.fasterxml.jackson.dataformat</groupId>
    <artifactId>jackson-dataformat-xml</artifactId>
</dependency>

實體類雙註解：

@Data
@JacksonXmlRootElement(localName = "user")
public class User {
    @JacksonXmlProperty(isAttribute = true)
    private Long id;
    private String name;
    private String email;
}

常見問題與解決

推薦學習資源

1. Spring MVC 中使用 @RequestBody/@ResponseBody 實現 Java 對象和 XML/JSON 數據自動轉換（上）：CSDN 文章
2. springmvc 實現 Java 對象和 XML/JSON 數據自動轉換（上）：博客園/CSDN 同步
3. 官方文檔：Spring Reference - @RequestBody

進階：自定義 HttpMessageConverter

public class CustomProtobufHttpMessageConverter extends AbstractHttpMessageConverter {
    public CustomProtobufHttpMessageConverter() {
        super(new MediaType("application", "x-protobuf"));
    }
    @Override protected boolean supports(Class clazz) { return User.class.isAssignableFrom(clazz); }
    @Override protected User readInternal(Class clazz, HttpInputMessage input) throws IOException {
        return User.parseFrom(input.getBody());
    }
    @Override protected void writeInternal(User user, HttpOutputMessage output) throws IOException {
        output.getBody().write(user.toByteArray());
    }
}

// 配置類註冊
@Configuration
public class WebMvcConfig implements WebMvcConfigurer {
    @Override
    public void configureMessageConverters(List> converters) {
        converters.add(new CustomProtobufHttpMessageConverter());
    }
}

1. 上一篇文章： Java 集合框架全景圖：Collection/Map 體系、數組 vs 集合、選型指南與源碼級核心原理
2. 下一篇文章： 從 Visual Studio 轉戰 Eclipse 快速上手指南：漢化、編輯器配置、智能提示、快捷鍵與格式化模板

Java 綜合教學

圖解 Java String 不可變性：為什麼拼接會創建新對象？

圖解 Java String 不可變性 String 不可變

人機對戰 AI 五子棋：Java 實現核心算法解析與開源項目分享

人機對戰 AI 五子棋：Java 實現核心算法解析與開源項目

Java 連接 SQL Server 常見坑點避雷指南（新手親測）

Java 連接 SQL Server 常見坑點避雷指南（新手

Java Swing JDialog 對話框組件完整指南：從基礎用法到模態與非模態實戰

JDialog 核心概念 JDialog 是 Swing 中