【Spring】25 Spring MVC的HttpMessageConverters

Spring MVC使用HttpMessageConverter接口来转换HTTP请求和响应。Spring Boot默认提供了合理的默认配置。例如，对象可以自动转换为JSON（使用Jackson库）或XML（如果可用，则使用Jackson XML扩展，否则使用JAXB）。默认情况下，字符串使用UTF-8编码。

如果您需要添加或自定义转换器，您可以使用Spring Boot的HttpMessageConverters类，如下所示：

@Configuration(proxyBeanMethods = false)
public class MyHttpMessageConvertersConfiguration {

    @Bean
    public HttpMessageConverters customConverters() {
        HttpMessageConverter<?> additional = new AdditionalHttpMessageConverter();
        HttpMessageConverter<?> another = new AnotherHttpMessageConverter();
        return new HttpMessageConverters(additional, another);
    }

}

上面的示例展示了如何使用HttpMessageConverters类来添加自定义的转换器。您可以将任何实现了HttpMessageConverter接口的bean添加到转换器列表中。您也可以以同样的方式覆盖默认的转换器。

示例

假设我们需要在Spring MVC应用中添加一个自定义的HTTP消息转换器，将特定格式的数据转换为对象。我们可以创建一个自定义的CustomHttpMessageConverter类，实现HttpMessageConverter接口。

import org.springframework.http.HttpInputMessage;
import org.springframework.http.HttpOutputMessage;
import org.springframework.http.MediaType;
import org.springframework.http.converter.HttpMessageConverter;
import org.springframework.http.converter.json.MappingJackson2HttpMessageConverter;
import org.springframework.stereotype.Component;

import java.io.IOException;
import java.util.List;

@Component
public class CustomHttpMessageConverter implements HttpMessageConverter<Object> {

    private final MappingJackson2HttpMessageConverter delegateConverter;

    public CustomHttpMessageConverter(MappingJackson2HttpMessageConverter delegateConverter) {
        this.delegateConverter = delegateConverter;
    }

    @Override
    public boolean canRead(Class<?> clazz, MediaType mediaType) {
        return delegateConverter.canRead(clazz, mediaType);
    }

    @Override
    public boolean canWrite(Class<?> clazz, MediaType mediaType) {
        return delegateConverter.canWrite(clazz, mediaType);
    }

    @Override
    public List<MediaType> getSupportedMediaTypes() {
        return delegateConverter.getSupportedMediaTypes();
    }

    @Override
    public Object read(Class<?> clazz, HttpInputMessage inputMessage) throws IOException {
        return delegateConverter.read(clazz, inputMessage);
    }

    @Override
    public void write(Object t, MediaType contentType, HttpOutputMessage outputMessage) throws IOException {
        delegateConverter.write(t, contentType, outputMessage);
    }
}

在这个例子中，我们创建了一个名为CustomHttpMessageConverter的自定义转换器，它基于Jackson库实现了HttpMessageConverter接口。我们在其中重写了相关的方法来实现自定义转换逻辑。

通过这样的配置，我们可以轻松地自定义Spring MVC中的HTTP消息转换，以满足特定的业务需求。

总结

Spring MVC的HttpMessageConverters提供了灵活的方式来处理HTTP请求和响应的转换。通过示例和配置，我们了解了如何使用Spring Boot来自定义和扩展HTTP消息转换器，并提供了一个实际的案例来说明如何实现这一点。