HTTP 消息转换

在 Reactive 堆栈中查看 equivalentspring-doc.cn

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

框架中提供了主媒体（MIME）类型的具体实现，默认情况下，它们在客户端和 server 端注册到 and（请参阅配置消息转换器）。RestClientRestTemplateRequestMappingHandlerAdapterspring-doc.cn

的几种实现如下。有关完整列表，请参阅 HttpMessageConverter Javadoc。对于所有转换器，都使用默认媒体类型，但您可以通过设置该属性来覆盖它。HttpMessageConvertersupportedMediaTypesspring-doc.cn

表 1.HttpMessageConverter 实现
消息转换器	描述
`StringHttpMessageConverter`spring-doc.cn	可以从 HTTP 请求和响应中读取和写入实例的实现。默认情况下，此转换器支持所有文本媒体类型（），并使用 of .`HttpMessageConverterStringtext/*Content-Typetext/plain`spring-doc.cn
`FormHttpMessageConverter`spring-doc.cn	可以从 HTTP 请求和响应中读取和写入表单数据的实现。默认情况下，此转换器读取和写入媒体类型。表单数据从 . 转换器还可以写入（但不能读取）从 . 默认情况下，支持。可以支持其他多部分子类型来写入表单数据。有关更多详细信息，请参阅 javadoc。`HttpMessageConverterapplication/x-www-form-urlencodedMultiValueMap<String, String>MultiValueMap<String, Object>multipart/form-dataFormHttpMessageConverter`spring-doc.cn
`ByteArrayHttpMessageConverter`spring-doc.cn	可以从 HTTP 请求和响应中读取和写入字节数组的实现。默认情况下，此转换器支持所有媒体类型（）并使用 a of . 您可以通过设置属性并覆盖来覆盖此属性。`HttpMessageConverter/Content-Typeapplication/octet-streamsupportedMediaTypesgetContentType(byte[])`spring-doc.cn
`MarshallingHttpMessageConverter`spring-doc.cn	可以使用 Spring 和包中的抽象来读取和写入 XML 的实现。此转换器需要 and 才能使用。您可以通过 constructor 或 bean 属性注入这些内容。默认情况下，此转换器支持和。`HttpMessageConverterMarshallerUnmarshallerorg.springframework.oxmMarshallerUnmarshallertext/xmlapplication/xml`spring-doc.cn
`MappingJackson2HttpMessageConverter`spring-doc.cn	可以使用 Jackson 的 . 您可以使用 Jackson 提供的注释根据需要自定义 JSON 映射。当你需要进一步的控制时（对于需要为特定类型提供自定义 JSON 序列化器/反序列化器的情况），你可以通过属性注入自定义。默认情况下，此转换器支持 .这需要 dependency。`HttpMessageConverterObjectMapperObjectMapperObjectMapperapplication/jsoncom.fasterxml.jackson.core:jackson-databind`spring-doc.cn
`MappingJackson2XmlHttpMessageConverter`spring-doc.cn	一种可以使用 Jackson XML 扩展的 . 您可以根据需要通过使用 JAXB 或 Jackson 提供的注释来自定义 XML 映射。当你需要进一步的控制时（对于需要为特定类型提供自定义 XML 序列化器/反序列化器的情况），你可以通过属性注入自定义。默认情况下，此转换器支持 .这需要 dependency。`HttpMessageConverterXmlMapperXmlMapperObjectMapperapplication/xmlcom.fasterxml.jackson.dataformat:jackson-dataformat-xml`spring-doc.cn
`MappingJackson2CborHttpMessageConverter`spring-doc.cn	`com.fasterxml.jackson.dataformat:jackson-dataformat-cbor`spring-doc.cn
`SourceHttpMessageConverter`spring-doc.cn	可以从 HTTP 请求和响应中读取和写入的实现。仅支持、和。默认情况下，此转换器支持和。`HttpMessageConverterjavax.xml.transform.SourceDOMSourceSAXSourceStreamSourcetext/xmlapplication/xml`spring-doc.cn
`GsonHttpMessageConverter`spring-doc.cn	可以使用 “Google Gson” 读取和写入 JSON 的实现。这需要 dependency。`HttpMessageConvertercom.google.code.gson:gson`spring-doc.cn
`JsonbHttpMessageConverter`spring-doc.cn	一种可以使用 Jakarta Json Bind API 读取和写入 JSON 的实现。这需要依赖项和可用的实现。`HttpMessageConverterjakarta.json.bind:jakarta.json.bind-api`spring-doc.cn
`ProtobufHttpMessageConverter`spring-doc.cn	一种可以读取和写入内容类型的二进制格式的 Protobuf 消息的实现。这需要 dependency。`HttpMessageConverter"application/x-protobuf"com.google.protobuf:protobuf-java`spring-doc.cn
`ProtobufJsonFormatHttpMessageConverter`spring-doc.cn	一种可以在 Protobuf 消息中读取和写入 JSON 文档的实现。这需要 dependency。`HttpMessageConvertercom.google.protobuf:protobuf-java-util`spring-doc.cn