Spring MVC——HttpMessageConverter详解

SpringMVC中的HttpMessageConverter：处理HTTP请求与响应的多数据格式转换

最新推荐文章于 2025-09-21 20:45:03 发布

原创最新推荐文章于 2025-09-21 20:45:03 发布 · 749 阅读

6 ·

CC 4.0 BY-SA版权

文章标签：

#spring #mvc #java

SpringMVC 专栏收录该内容

37 篇文章

订阅专栏

本文介绍了SpringMVC中的HttpMessageConverter接口及其在处理JSON、XML、表单数据等不同数据格式中的角色，展示了如何配置和扩展内置及自定义的HttpMessageConverter以满足特定需求。

HttpMessageConverter是Spring MVC中用于处理HTTP请求和响应消息的接口。它负责将HTTP请求的消息体转换为Java对象，并将Java对象转换为HTTP响应消息体。HttpMessageConverter接口定义了两个方法： canRead() 和 canWrite() ，用于判断是否支持读取和写入指定的Java对象类型。

Spring MVC中内置了多个实现了HttpMessageConverter接口的类，用于处理不同类型的数据格式，如JSON、XML、表单数据等。一些常用的HttpMessageConverter实现包括：

MappingJackson2HttpMessageConverter：用于处理JSON格式的数据，将Java对象转换为JSON字符串或将JSON字符串转换为Java对象。
StringHttpMessageConverter：用于处理字符串类型的数据，将字符串转换为HTTP响应消息体或将HTTP请求消息体转换为字符串。
FormHttpMessageConverter：用于处理表单数据，将表单数据转换为MultiValueMap对象或将MultiValueMap对象转换为表单数据。
Jaxb2RootElementHttpMessageConverter：用于处理XML格式的数据，将Java对象转换为XML文档或将XML文档转换为Java对象。

通过配置HttpMessageConverter，可以自定义支持更多的数据格式或实现特定的数据转换逻辑。在Spring MVC中，可以通过继承WebMvcConfigurerAdapter类或实现WebMvcConfigurer接口来添加自定义的HttpMessageConverter实现，以满足特定的数据处理需求。

代码如下：

@Configuration
@EnableWebMvc
public class WebConfig implements WebMvcConfigurer {

    @Override
    public void configureMessageConverters(List<HttpMessageConverter<?>> converters) {
        converters.add(new MappingJackson2HttpMessageConverter());
        converters.add(new StringHttpMessageConverter());
        converters.add(new FormHttpMessageConverter());
        converters.add(new Jaxb2RootElementHttpMessageConverter());
        // 添加自定义的HttpMessageConverter
        // converters.add(new CustomHttpMessageConverter());
    }
}

在上面代码中，WebConfig类继承了WebMvcConfigurer接口，并重写了configureMessageConverters方法，向Spring MVC注册了一些内置的HttpMessageConverter实现，包括MappingJackson2HttpMessageConverter、StringHttpMessageConverter、FormHttpMessageConverter和Jaxb2RootElementHttpMessageConverter。如果需要添加自定义的HttpMessageConverter，可以创建自定义的HttpMessageConverter类并将其添加到converters列表中。