此版本仍在开发中，尚未稳定。如需最新的稳定版本，请使用 Spring Framework 7.0.6！spring-doc.cadn.net.cn

HTTP 消息转换

请参阅响应式栈中的等效项spring-doc.cadn.net.cn

spring-web 模块包含 HttpMessageConverter 接口，用于通过 InputStream 和 OutputStream 读取和写入 HTTP 请求和响应的正文。 HttpMessageConverter 实例在客户端（例如，在 RestClient 中）和服务器端（例如，在 Spring MVC REST 控制器中）使用。spring-doc.cadn.net.cn

框架为主要媒体（MIME）类型提供了具体实现，并且默认情况下在客户端与RestClient和RestTemplate注册，在服务器端与RequestMappingHandlerAdapter注册（参见配置消息转换器）。spring-doc.cadn.net.cn

以下是 HttpMessageConverter 的几种实现方式。有关完整列表，请参考 HttpMessageConverter Javadoc。对于所有转换器，均使用默认的媒体类型，但您可以通过设置 supportedMediaTypes 属性来覆盖它。spring-doc.cadn.net.cn

表 1. HttpMessageConverter 实现
MessageConverter	描述
`StringHttpMessageConverter`spring-doc.cadn.net.cn	一个可以从HTTP请求和响应中读取和写入`String`实例的`HttpMessageConverter`实现。默认情况下，此转换器支持所有文本媒体类型（`text/*`），并使用`Content-Type`的`text/plain`进行编写。spring-doc.cadn.net.cn
`FormHttpMessageConverter`spring-doc.cadn.net.cn	一种 `HttpMessageConverter` 实现，能够从HTTP请求和响应中读取和写入表单数据。默认情况下，此转换器读取和写入 `application/x-www-form-urlencoded` 媒体类型。表单数据从 `MultiValueMap<String, String>` 中读取并写入其中。该转换器还可以写入（但不能读取）从 `MultiValueMap<String, Object>` 读取的多部分数据。默认支持 `multipart/form-data`。可为写入表单数据支持其他多部分子类型。有关更多详细信息，请参阅 `FormHttpMessageConverter` 的javadoc。spring-doc.cadn.net.cn
`ByteArrayHttpMessageConverter`spring-doc.cadn.net.cn	一个可以从HTTP请求和响应中读取和写入字节数组的`HttpMessageConverter`实现。默认情况下，此转换器支持所有媒体类型（`/`），并使用`Content-Type`的`application/octet-stream`进行写入。您可以通过设置`supportedMediaTypes`属性并重写`getContentType(byte[])`来覆盖此设置。spring-doc.cadn.net.cn
`MarshallingHttpMessageConverter`spring-doc.cadn.net.cn	一个 `HttpMessageConverter` 实现，可以通过 Spring 的 `Marshaller` 和 `Unmarshaller` 抽象从 `org.springframework.oxm` 包中读取和写入 XML。此转换器在使用前需要 `Marshaller` 和 `Unmarshaller`。您可以通过构造函数或 bean 属性注入这些内容。默认情况下，此转换器支持 `text/xml` 和 `application/xml`。spring-doc.cadn.net.cn
`MappingJackson2HttpMessageConverter`spring-doc.cadn.net.cn	一个使用Jackson的`HttpMessageConverter`实现，能够读写JSON。您可以通过使用Jackson提供的注解按需自定义JSON映射方式。当需要进一步控制（例如，针对特定类型需要提供自定义的JSON序列化器/反序列化器时），可以通过`ObjectMapper`属性注入自定义的`ObjectMapper`。默认情况下，此转换器支持`application/json`。这需要`com.fasterxml.jackson.core:jackson-databind`依赖项。spring-doc.cadn.net.cn
`MappingJackson2XmlHttpMessageConverter`spring-doc.cadn.net.cn	一个使用`HttpMessageConverter`实现的，能够通过Jackson XML扩展的`XmlMapper`读写XML。您可以通过JAXB或Jackson提供的注解按需自定义XML映射方式。当需要进一步控制时（例如：针对特定类型需要提供自定义XML序列化/反序列化器的情况），可以通过`ObjectMapper`属性注入自定义的`XmlMapper`。默认情况下，此转换器支持`application/xml`。这需要`com.fasterxml.jackson.dataformat:jackson-dataformat-xml`依赖项。spring-doc.cadn.net.cn
`MappingJackson2CborHttpMessageConverter`spring-doc.cadn.net.cn	`com.fasterxml.jackson.dataformat:jackson-dataformat-cbor`spring-doc.cadn.net.cn
`SourceHttpMessageConverter`spring-doc.cadn.net.cn	一个可以读取和写入HTTP请求和响应中`HttpMessageConverter`的实现。仅支持`DOMSource`、`SAXSource`和`StreamSource`。默认情况下，此转换器支持`text/xml`和`application/xml`。spring-doc.cadn.net.cn
`GsonHttpMessageConverter`spring-doc.cadn.net.cn	一个可以使用“Google Gson”读写JSON的`HttpMessageConverter`实现。这需要`com.google.code.gson:gson`依赖项。spring-doc.cadn.net.cn
`JsonbHttpMessageConverter`spring-doc.cadn.net.cn	一个可以使用Jakarta Json绑定API读写JSON的`HttpMessageConverter`实现。这需要`jakarta.json.bind:jakarta.json.bind-api`依赖项和一个可用的实现。spring-doc.cadn.net.cn
`ProtobufHttpMessageConverter`spring-doc.cadn.net.cn	一个可以读写二进制格式的Protobuf消息的`HttpMessageConverter`实现，使用了`"application/x-protobuf"`内容类型。这需要`com.google.protobuf:protobuf-java`依赖。spring-doc.cadn.net.cn
`ProtobufJsonFormatHttpMessageConverter`spring-doc.cadn.net.cn	一个可以读取和写入JSON文档与Protobuf消息之间的`HttpMessageConverter`实现。这需要`com.google.protobuf:protobuf-java-util`依赖项。spring-doc.cadn.net.cn