SpringBoot项目中如何定制HTTP消息转换器

本文首发于我的网站：Spring Boot项目中如何定制HTTP消息转换器，如需转载，请注明来源

在构建RESTful数据服务过程当中，咱们定义了controller、repositories，并用一些注解修饰它们，可是到如今为止咱们还没执行过对象的转换——将java实体对象转换成HTTP的数据输出流。

Spring Boot底层经过HttpMessageConverters和Jackson库将Java实体类输出为JSON格式。当有多个转换器可用时，根据消息对象类型和须要的内容类型选择最适合的转换器使用。

在SpringMVC源码剖析（五)-消息转换器HttpMessageConverter一文中，有一张图能够很清楚得表示消息转换器的位置。

消息转换器的目标是：

1. HTTP输入请求格式向Java对象的转换；
2. Java对象向HTTP输出请求的转换。

有的消息转换器只支持多个数据类型，有的只支持多个输出格式，还有的二者兼备。

例如：MappingJackson2HttpMessageConverter能够将Java对象转换为application/json，而ProtobufHttpMessageConverter仅支持com.google.protobuf.Message类型的输入，可是能够输出application/json、application/xml、text/plain和application/x-protobuf这么多格式。

实践

在项目中有三种办法配置消息转换器，主要是从可定制性和易用度两个方面进行衡量。

1. 在WebConfiguration类中加入@Bean定义

@Bean
public ByteArrayHttpMessageConverter byteArrayHttpMessageConverter() {
    return new ByteArrayHttpMessageConverter();
}复制代码

1. 重写（override）configureMessageConverters方法，扩展示有的消息转换器链表；

@Override
public 
void configureMessageConverters(List<HttpMessageConverter<?>> converters) {
    converters.add(new ByteArrayHttpMessageConverter());
}复制代码

1. 更多的控制，能够重写extendMessageConverters方法，首先清空转换器列表，再加入自定义的转换器。

@Override
public 
void extendMessageConverters(List<HttpMessageConverter<?>> converters) {
    converters.clear();
    converters.add(new ByteArrayHttpMessageConverter());
}复制代码

分析

Spring Boot提供了多种方法完成一样的任务，选择哪一个取决于咱们更侧重便捷性仍是更侧重可定制性。

上述提到的三种方法各有什么不一样呢？

经过@Bean定义HttpMessageConverter是向项目中添加消息转换器最简便的办法，这相似于以前提到的添加Servlet Filters。若是Spring扫描到HttpMessageConverter类型的bean，就会将它自动添加到调用链中。推荐让项目中的WebConfiguration继承自WebMvcConfigurerAdapter。

经过重写configureMessageConverters方法添加自定义的转换器很方便，但有一个弱点：若是项目中存在多个WebMvcConfigurers的实例（咱们本身定义的，或者Spring Boot默认提供的），不能确保重写后的configureMessageConverters方法按照固定顺序执行。

若是须要更精细的控制：清除其余消息转换器或者清楚重复的转换器，能够经过重写extendMessageConverters完成，仍然有这种可能：别的WebMvcConfigurer实例也能够重写这个方法，可是这种概率很是小。

Spring Boot 1.x系列

1. Spring Boot的自动配置、Command-line-Runner
2. 了解Spring Boot的自动配置
3. Spring Boot的@PropertySource注解在整合Redis中的使用
   ***
   本号专一于后端技术、JVM问题排查和优化、Java面试题、我的成长和自我管理等主题，为读者提供一线开发者的工做和成长经验，期待你能在这里有所收获。