42、响应处理-【源码分析】-浏览器与PostMan内容协商完全适配

42、响应处理源码分析浏览器与PostMan内容协商完全适配

要实现浏览器与PostMan在内容协商上的完全适配，需要在Spring Boot应用中自定义内容协商策略，确保服务器能根据浏览器和PostMan的请求头正确返回合适格式的数据。以下是详细的步骤：

### 1. 理解内容协商

**内容协商**是HTTP协议中的一种机制，允许服务器根据客户端的请求头信息（如`Accept`、`Accept-Language`、`Accept-Encoding`等），选择最合适的响应内容格式。例如，客户端可以通过`Accept`头指定希望接收的数据格式，如`application/json`或`application/xml`。

### 2. 默认内容协商行为

Spring Boot默认使用`HeaderContentNegotiationStrategy`，根据请求头中的`Accept`字段进行内容协商。但对于浏览器请求，通常不显式设置`Accept`头，Spring Boot会默认返回HTML格式。

### 3. 自定义内容协商策略

为了实现浏览器与PostMan的完全适配，可以添加基于请求参数的内容协商策略，同时保留基于请求头的策略。

#### 步骤1：引入依赖

如果需要支持XML格式，引入Jackson的XML处理模块：

```xml

<dependency>

    <groupId>com.fasterxml.jackson.dataformat</groupId>

    <artifactId>jackson-dataformat-xml</artifactId>

</dependency>

```

#### 步骤2：配置内容协商

创建配置类，自定义内容协商策略：

```java

@Configuration

public class WebConfig implements WebMvcConfigurer {

    @Override

    public void configureContentNegotiation(ContentNegotiationConfigurer configurer) {

        // 定义支持的媒体类型和参数映射

        Map<String, MediaType> mediaTypes = new HashMap<>();

        mediaTypes.put("json", MediaType.APPLICATION_JSON);

        mediaTypes.put("xml", MediaType.APPLICATION_XML);

        mediaTypes.put("gg", MediaType.parseMediaType("application/x-guigu")); // 自定义格式

        // 创建基于请求参数的内容协商策略

        ParameterContentNegotiationStrategy parameterStrategy = 

            new ParameterContentNegotiationStrategy(mediaTypes);

        parameterStrategy.setParameterName("format"); // 指定参数名为format

        // 保留基于请求头的策略

        HeaderContentNegotiationStrategy headerStrategy = new HeaderContentNegotiationStrategy();

        // 配置内容协商策略

        configurer.strategies(Arrays.asList(parameterStrategy, headerStrategy));

    }

}

```

#### 步骤3：启用请求参数内容协商（可选）

在`application.properties`中开启基于请求参数的内容协商：

```properties

spring.contentnegotiation.favor-parameter=true

```

### 4. 测试与验证

#### PostMan测试

- 发送GET请求到`http://localhost:8080/test/person`，设置请求头`Accept: application/json`，返回JSON格式数据。

- 发送GET请求到`http://localhost:8080/test/person?format=xml`，返回XML格式数据。

- 发送GET请求到`http://localhost:8080/test/person?format=gg`，返回自定义格式数据。

#### 浏览器测试

- 在浏览器中访问`http://localhost:8080/test/person`，返回HTML格式数据（如果未配置视图解析器，可能报错）。

- 在浏览器中访问`http://localhost:8080/test/person?format=json`，返回JSON格式数据。

- 在浏览器中访问`http://localhost:8080/test/person?format=xml`，返回XML格式数据。

### 5. 注意事项

- **默认行为覆盖**：自定义内容协商策略可能会覆盖默认行为，需确保所有功能正常。

- **媒体类型注册**：确保所有自定义媒体类型在`mediaTypes`中注册。

- **Converter支持**：确保有对应的`MessageConverter`支持转换自定义格式。

通过以上步骤，可以实现浏览器与PostMan在内容协商上的完全适配，根据请求头或请求参数返回合适格式的数据。