Jaxb2RootElementHttpMessageConverter – Java Object <-> XML
MappingJackson2HttpMessageConverter – JSON -> Java Object
MappingJacksonHttpMessageConverter – JSON -> Java Object
AtomFeedHttpMessageConverter – Atom feeds -> Java Object
RssChannelHttpMessageConverter – RSS feeds -> Java Object

WebMvcConfigurationSupport.java中对lib包的检测顺序进行了定义。

Http Message Converter是怎么工作的？

当服务器需要响应客户端的一个请求时，Spring会根据请求头(Header)的Accept参数值的媒体类型(media type)来决定要返回的数据类型。接着，Spring会尝试找到一个合适的注册converter来处理这种媒体类型，利用这个converter来进行类型转换并返回给客户端。

Spring在@ResponseBody时，有content negotiation策略，策略当中的最后一个是根据请求Header中的Accept媒体类型来决定返回值类型。该策略是可配置的，下文有讲解。

当服务器接收到客户端的一个请求时，Spring会根据请求头(Header)的Content-Type参数值的媒体类型类决定请求消息体的数据类型，接着，Spring会尝试找到一个合适的注册converter来将消息体中的数据转化为Java Object。

一个完整的客户端请求到服务器端响应过程中，Http Message Converter参与的过程如下：

查看请求头的Content-Type(仅需要)
根据Content-Type的媒体类型找到合适的HttpMessageConverter(仅需要)
将请求数据反序列化为Java Object(仅需要)
获取请求参数和路径变量(Path Variable)
业务逻辑
判断Accept header(根据content negotiation策略，下文有讲解)
根据Accept header找到合适的HttpMessageConverter
返回响应到客户端

序列化过程@ResponseBody

Spring Content Negotiation

当客户端向服务器端请求数据，服务器端需要决定以何种形式将数据返回给客户端，这个决定的过程就叫做内容协商(Content Negotiation)。

服务器端决定以何种形式来返回数据依赖内容协商策略(ContentNegotiationStrategy)，Spring有默认的策略，也可以通过配置自定义。

Spring Content Negotiation是怎么工作的？

正常HTTP协议的工作方式是通过Accept header来决定返回数据的类型，但是这种方式太过于依赖客户端的请求参数(Accept header)，有些时候用起来不太方便，所以Spring默认定义了一些列的内容协商策略(包括原生HTTP Accept header的方式)。

Spring定义了默认的内容协商策略：

第一是URL中路径的后缀(Path Extension Strategy)。如果后缀是.html，则返回HTML格式数据；如果后缀是.xls，则返回Excel格式数据。默认这种方式是开启的。
第二是URL参数format(可以自定义)(Parameter Strategy)。例如：http://myserver/myapp/accounts/list?format=xls，Spring会根据format的定义来决定返回数据的格式。默认这种方式关闭的。
最后一个是Accept header(Header Strategy)。这个是真正HTTP工作的方式。默认这种方式是开启的。

这三种方式Spring会按照先后顺序来检查是否开启，如果开启了就使用该方式，不会继续往下检查。这些方式在类ContentNegotiationConfigurer.java中定义。

Spring Content Negotiation自定义配置

Java Config的方式：

@Configuration
@EnableWebMvc
public class WebConfig extends WebMvcConfigurerAdapter {

    @Override
    public void configureContentNegotiation(ContentNegotiationConfigurer configurer) {
        configurer.favorPathExtension(false)//默认后缀模式是开启的，自定义关闭
        .mediaType("xml", MediaType.APPLICATION_XML)//如果后缀是xml，返回媒体类型为application/xml
        .mediaType("json", MediaType.APPLICATION_JSON)//如果后缀是json，返回媒体类型为application/json
        .favorParameter(true)//默认是关闭的，自定义开启
        .defaultContentType(MediaType.APPLICATION_XML)//自定义默认返回媒体类型为application/xml
        .ignoreAcceptHeader(true)//关闭Header Strategy
    }
}

详细配置参考项目

反序列化过程@RequestMapping

@RequestMapping可以将不同形式的数据表示反序列化为Java Object，服务器端需要根据Request Header中的Content-Type来找到合适的HttpMessageConverter。

反序列化的过程不止可以反序列化为POJO，还可以是Map、File等其他数据支持。

自定义HttpMessageConverter

继承AbstractHttpMessageConverter，自定义ReportConverter：

package com.fmz.learn.spring.utils;

public class ReportConverter
        extends AbstractHttpMessageConverter<Report> {

    public ReportConverter() {
        super(new MediaType("text", "report"));
    }

    @Override
    protected boolean supports(Class<?> clazz) {
        return Report.class.isAssignableFrom(clazz);
    }

    @Override
    protected Report readInternal(Class<? extends Report> clazz, HttpInputMessage inputMessage)
            throws IOException, HttpMessageNotReadableException {
        String requestBody = toString(inputMessage.getBody());
        int i = requestBody.indexOf("\n");
        if (i == -1) {
            throw new HttpMessageNotReadableException("No first line found");
        }

        String reportName = requestBody.substring(0, i).trim();
        String content = requestBody.substring(i).trim();

        Report report = new Report();
        report.setReportName(reportName);
        report.setContent(content);
        return report;
    }

    @Override
    protected void writeInternal(Report report, HttpOutputMessage outputMessage)
            throws IOException, HttpMessageNotWritableException {
        try {
            OutputStream outputStream = outputMessage.getBody();
            String body = report.getReportName() + "\n" +
                    report.getContent();
            outputStream.write(body.getBytes());
            outputStream.close();
        } catch (Exception e) {
        }
    }

    private static String toString(InputStream inputStream) {
        Scanner scanner = new Scanner(inputStream, "UTF-8");
        return scanner.useDelimiter("\\A").next();
    }
}

配置自定义的ReportConverter：

@Configuration
@EnableWebMvc
public class WebConfig extends WebMvcConfigurerAdapter {

    // 添加新的HTTPMessageConverter实现
    @Override
    public void extendMessageConverters(List<HttpMessageConverter<?>> converters) {
        converters.add(new ReportConverter());
    }
}

详细自定义Converter参考项目

参考文章：

理解Spring HttpMessageConverter

目录