例如，假设我们有一个文章提交接口，接收标题、关键词、描述和正文内容。我们可以创建如下实体类：

java
import com.fasterxml.jackson.dataformat.xml.annotation.JacksonXmlProperty;
import com.fasterxml.jackson.dataformat.xml.annotation.JacksonXmlRootElement;

@JacksonXmlRootElement(localName = "article")
public class Article {

@JacksonXmlProperty(localName = "title")
private String title;

@JacksonXmlProperty(localName = "keywords")
private String keywords;

@JacksonXmlProperty(localName = "description")
private String description;

@JacksonXmlProperty(localName = "content")
private String content;

// 省略 getter 和 setter 方法

}

这里使用了 @JacksonXmlRootElement 指定根元素名称为 <article>，并通过 @JacksonXmlProperty 明确每个字段对应的 XML 子节点名称。这种注解方式清晰且易于维护，避免了命名冲突或结构错乱的问题。

编写控制器接收 XML 请求

接下来，在控制器中编写一个 POST 接口，用于接收客户端发送的 XML 数据。Spring MVC 会根据请求头中的 Content-Type 自动选择合适的消息转换器。当 Content-Type: application/xml 或 text/xml 时，框架将调用 XML 转换器进行解析。

java
import org.springframework.web.bind.annotation.*;

@RestController
@RequestMapping("/api/articles")
public class ArticleController {

@PostMapping(consumes = "application/xml", produces = "application/xml")
public ResponseEntity<String> createArticle(@RequestBody Article article) {
    // 模拟业务处理逻辑
    System.out.println("接收到文章：" + article.getTitle());
    System.out.println("关键词：" + article.getKeywords());

    // 返回成功响应（也可返回 XML 格式的确认信息）
    return ResponseEntity.ok("<status>success</status>");
}

}

注意 consumes = "application/xml" 的设置，它明确限定此接口只接受 XML 格式的请求体。如果客户端发送的是 JSON，将会返回 415 Unsupported Media Type 错误。这样的设计增强了接口的健壮性和语义清晰度。

测试 XML 请求示例

我们可以使用 curl 或 Postman 发送一段标准的 XML 请求来测试接口是否正常工作：

xml
POST /api/articles HTTP/1.1
Content-Type: application/xml

只要请求头正确设置了 Content-Type: application/xml，Spring Boot 就能自动将上述 XML 内容映射到 Article 对象的各个字段上，开发者可以直接在方法中使用这些数据进行后续处理。

处理复杂嵌套结构与命名空间

对于更复杂的 XML 结构，比如包含嵌套对象或使用命名空间的情况，可以通过进一步的注解进行控制。例如：

java
@JacksonXmlRootElement(localName = "article")
public class Article {
@JacksonXmlProperty(localName = "meta")
private MetaData meta;

@JacksonXmlProperty(localName = "content")
private String content;

}

public class MetaData {
@JacksonXmlProperty(localName = "title")
private String title;

@JacksonXmlProperty(localName = "keywords")
private String keywords;

}

对应 XML 示例：

xml

此外，若涉及命名空间，可使用 @JacksonXmlProperty(namespace = "...") 显式指定命名空间 URI，确保解析准确无误。

注意事项与最佳实践

尽管 Spring Boot 对 XML 的支持较为完善，但在实际项目中仍需注意几点：

1. 性能考量：相比 JSON，XML 解析通常更耗资源，尤其在高并发场景下应评估其影响。
2. 编码一致性：确保客户端和服务端使用相同的字符编码（推荐 UTF-8），防止中文乱码。
3. 校验机制：建议结合 Bean Validation（如 @NotBlank）对接收的数据进行合法性检查。
4. 异常处理：配置全局异常处理器，捕获 HttpMessageNotReadableException 等 XML 解析失败的情况，返回友好的错误提示。

通过合理配置和严谨编码，Spring Boot 完全可以胜任 XML 请求的处理任务，既保持系统的兼容性，又不失现代开发的简洁与高效。