如何實現HttpMessageConverter報文信息轉換器的深入分析

如何實現HttpMessageConverter報文信息轉換器的深入分析，針對這個問題，這篇文章詳細介紹了相對應的分析和解答，希望可以幫助更多想解決這個問題的小伙伴找到更簡單易行的方法。

前言

HttpMessageConverter，報文信息轉換器，將請求報文轉換為Java對象，或將Java對象轉換為響應報文。

HttpMessageConverter提供了兩個注解和兩個類型：@RequestBody，@ResponseBody，RequestEntity，ResponseEntity。

HttpMessageConverter 介紹

org.springframework.http.converter.HttpMessageConverter 是一個策略接口，接口說明如下：

Strategy interface that specifies a converter that can convert from and to HTTP requests and responses. 簡單說就是 HTTP request (請求)和response (響應)的轉換器。該接口有只有5個方法，簡單來說就是獲取支持的 MediaType（application/json之類），接收到請求時判斷是否能讀（canRead），能讀則讀（read）；返回結果時判斷是否能寫（canWrite），能寫則寫（write）。這幾個方法先有個印象即可：

boolean canRead(Class<?> clazz, MediaType mediaType);
boolean canWrite(Class<?> clazz, MediaType mediaType);
List<MediaType> getSupportedMediaTypes();
T read(Class<? extends T> clazz, HttpInputMessage inputMessage) throws IOException, HttpMessageNotReadableException;
void write(T t, MediaType contentType, HttpOutputMessage outputMessage) throws IOException, HttpMessageNotWritableException;

一、@RequestBody 請求體注解

@RequestBody可以獲取請求體，需要在控制器方法設置一個形參。

使用@RequestBody進行標識，當前請求的請求體就會為當前注解所標識的形參賦值。

1.1、表單提交模擬

<form th:action="@{/testRequestBody}" method="post">
    用戶名：<input type="text" name="username"><br>
    密碼：<input type="password" name="password"><br>
    <input type="submit">
</form>

1.2、控制器方法示例

@RequestMapping("/testRequestBody")
public String testRequestBody(@RequestBody String requestBody){
    System.out.println("requestBody:"+requestBody);
    return "success";
}

輸出結果：

requestBody:username=admin&password=123456

二、RequestEntity 請求封裝對象

RequestEntity 封裝請求報文的一種類型，需要在控制器方法的形參中設置該類型的形參，當前請求的請求報文就會賦值給該形參。

• 通過getHeaders()獲取請求頭信息

• 通過getBody()獲取請求體信息

2.1、控制器方式示例

@RequestMapping("/testRequestEntity")
public String testRequestEntity(RequestEntity<String> requestEntity){
    System.out.println("requestHeader:"+requestEntity.getHeaders());
    System.out.println("requestBody:"+requestEntity.getBody());
    return "success";
}

2.2、輸出結果

requestHeader:[host:"localhost:8080", connection:"keep-alive", content-length:"27", cache-control:"max-age=0", sec-ch-ua:"" Not A;Brand";v="99", "Chromium";v="90", "Google Chrome";v="90"", sec-ch-ua-mobile:"?0", upgrade-insecure-requests:"1", origin:"http://localhost:8080", user-agent:"Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/90.0.4430.93 Safari/537.36"] requestBody:username=admin&password=123

三、@ResponseBody 響應體注解

@ResponseBody用于標識一個控制器方法，可以將該方法的返回值直接作為響應報文的響應體響應到瀏覽器。

3.1、控制器方式示例

@RequestMapping("/testResponseBody")
@ResponseBody 
public String testResponseBody(){
    return "success";
}

結果：瀏覽器頁面顯示 success

3.2、SpringMVC 添加Json格式轉換器

首先：導入jackson的依賴

<dependency>
    <groupId>com.fasterxml.jackson.core</groupId>
    <artifactId>jackson-databind</artifactId>
    <version>2.12.1</version>
</dependency>

然后：在SpringMVC的核心配置文件中開啟mvc的注解驅動。

此時在HandlerAdaptor中會自動裝配一個消息轉換器：MappingJackson2HttpMessageConverter，可以將響應到瀏覽器的Java對象轉換為Json格式的字符串。

<mvc:annotation-driven />

3.3、控制器使用 Json 格式轉換器示例

在處理器方法上使用 @ResponseBody 注解進行標識。

將Java對象直接作為控制器方法的返回值返回，就會自動轉換為Json格式的字符串

@RequestMapping("/testResponseUser")
@ResponseBody
public User testResponseUser(){
    return new User(1001,"admin","123456",23,"男");
}

瀏覽器的頁面中展示的結果：

{"id":1001,"username":"admin","password":"123456","age":23,"sex":"男"}

3.4、@RestController注解

@RestController注解是springMVC提供的一個復合注解，標識在控制器的類上。

相當于為類添加了@Controller注解，并且為其中的每個方法添加了@ResponseBody注解。

四、ResponseEntity 響應封裝對象

ResponseEntity 用于控制器方法的返回值類型，該控制器方法的返回值就是響應到瀏覽器的響應報文。

關于如何實現HttpMessageConverter報文信息轉換器的深入分析問題的解答就分享到這里了，希望以上內容可以對大家有一定的幫助，如果你還有很多疑惑沒有解開，可以關注億速云行業資訊頻道了解更多相關知識。