SpringMVC HttpMessageConverter消息转换器怎么使用

今天小编给大家分享一下SpringMVC HttpMessageConverter消息转换器怎么使用的相关知识点，内容详细，逻辑清晰，相信大部分人都还太了解这方面的知识，所以分享这篇文章给大家参考一下，希望大家阅读完这篇文章后有所收获，下面我们一起来了解一下吧。

Spring MVC 为开发者提供了方便的开发方式和丰富的功能。其中，HttpMessageConverter 是Spring MVC中非常重要的一个组件，它负责将客户端提交的请求数据（如JSON、XML等）转换为Java对象，同时也负责将 Java 对象转换为客户端需要的数据格式。

作用

在 Spring MVC 中，客户端通过发送请求，向服务器端请求数据，服务器端接收到请求后需要将请求参数转换为 Java 对象进行处理，这就需要使用 HttpMessageConverter，它主要负责将HTTP请求中的请求参数转换为 Java 对象或将 Java 对象转换为 HTTP 响应中的内容。

HttpMessageConverter 是一个接口，Spring MVC 中有很多实现类，用于处理不同的数据类型。常见的 HttpMessageConverter 实现类有：

• ByteArrayHttpMessageConverter：用于处理字节数组类型的数据。

• StringHttpMessageConverter：用于处理字符串类型的数据。

• FormHttpMessageConverter：用于处理表单类型的数据。

• MappingJackson2HttpMessageConverter：用于处理JSON类型的数据。

• Jaxb2RootElementHttpMessageConverter：用于处理XML类型的数据。

HttpMessageConverter 接口定义了两个方法：canRead() 和 canWrite()，分别用于判断当前的 HttpMessageConverter 是否可以读取或写入指定的数据类型。

• 如果 canRead() 方法返回 true，那么当前的 HttpMessageConverter 就可以将 HTTP 请求中的请求参数转换为 Java 对象；

• 如果 canWrite() 方法返回 true，那么当前的 HttpMessageConverter 就可以将Java对象转换为 HTTP 响应中的内容。

源码实现

下面以 MappingJackson2HttpMessageConverter 为例，讲解 HttpMessageConverter 的源码实现。

MappingJackson2HttpMessageConverter 是一个用于处理 JSON 类型数据的 HttpMessageConverter 实现类。它继承了 AbstractJackson2HttpMessageConverter 类，并实现了 HttpMessageConverter 接口。

canRead()

@Override
public boolean canRead(Class<?> clazz, @Nullable MediaType mediaType) {
    JavaType javaType = getJavaType(clazz, null);
    return (this.objectMapper.canDeserialize(javaType) && canRead(mediaType));
}

方法首先调用了 getJavaType() 方法获取 JavaType 对象

然后判断当前的 ObjectMapper 是否可以反序列化 JavaType 对象。

如果当前的 HttpMessageConverter 可以反序列化 JavaType 对象并且当前的 MediaType 可以被处理，那么就返回 true，否则返回 false。

canWrite()

@Override
public boolean canWrite(Class<?> clazz, @Nullable MediaType mediaType) {
    return (this.objectMapper.canSerialize(clazz) && canWrite(mediaType));
}

方法首先判断当前的 ObjectMapper 是否可以序列化指定的 Java 对象

如果可以序列化并且当前的 MediaType 可以被处理，那么就返回 true，否则返回 false。

read()

@Override
public T readInternal(Class<? extends T> clazz, HttpInputMessage inputMessage)throws IOException, HttpMessageNotReadableException {
    JavaType javaType = getJavaType(clazz, null);
    try {
        return this.objectMapper.readValue(inputMessage.getBody(), javaType);
    }
    catch (JsonProcessingException ex) {
        throw new HttpMessageNotReadableException("JSON parse error: " + ex.getMessage(), ex, inputMessage);
    }
}

方法首先调用 getJavaType() 方法获取 JavaType 对象

然后通过 ObjectMapper 的 readValue() 方法将HTTP请求中的请求参数转换为 Java 对象。

如果在转换的过程中出现了异常，那么就抛出 HttpMessageNotReadableException 异常。

write()

@Override
protected void writeInternal(T t, HttpOutputMessage outputMessage) throws IOException, HttpMessageNotWritableException {
    try {
        JsonEncoding encoding = getJsonEncoding(outputMessage.getHeaders().getContentType());
        JsonGenerator jsonGenerator = this.objectMapper.getFactory().createGenerator(outputMessage.getBody(), encoding);
        writePrefix(jsonGenerator, t);
        this.objectMapper.writeValue(jsonGenerator, t);
        writeSuffix(jsonGenerator, t);
        jsonGenerator.flush();
    }
    catch (JsonProcessingException ex) {
        throw new HttpMessageNotWritableException("Could not write JSON: " + ex.getMessage(), ex);
    }
}

方法首先通过 getJsonEncoding() 方法获取JSON编码格式

然后通过 ObjectMapper 的 writeValue() 方法将 Java 对象转换为 JSON 格式的字符串

并将结果输出到 HTTP 响应中。如果在转换的过程中出现了异常，那么就抛出 HttpMessageNotWritableException 异常。

异同

大家是不是觉得与前面文章所讲的 MethodArgumentResolver 很相似，都能够将请求参数转换为Java对象，但它们的作用和处理流程不同：

• HttpMessageConverter 会在请求到达 Controller 方法之前进行处理，这意味着它只处理请求参数，而不管 Controller 方法的签名和参数类型；

• MethodArgumentResolver 会在 Controller 方法执行之前进行处理，它的作用是将请求参数按照 Controller 方法的参数顺序进行解析，并将解析结果映射到 Controller 方法的参数上，然后再调用 Controller 方法

以上就是“SpringMVC HttpMessageConverter消息转换器怎么使用”这篇文章的所有内容，感谢各位的阅读！相信大家阅读完这篇文章都有很大的收获，小编每天都会为大家更新不同的知识，如果还想学习更多的知识，请关注亿速云行业资讯频道。