Spring Boot中的内容协商

Spring Boot中的内容协商

大家好，我是微赚淘客系统3.0的小编，也是冬天不穿秋裤，天冷也要风度的程序猿！今天我们来探讨一下Spring Boot中的内容协商(Content Negotiation)。内容协商是一个重要的Web服务功能，它允许服务器根据客户端请求中的头信息返回不同格式的数据，例如JSON、XML等。通过内容协商，开发者可以为同一个资源提供多种表示形式。

一、内容协商的基本概念

内容协商是HTTP协议中的一部分，允许客户端和服务器就响应的最佳表示形式达成一致。在HTTP请求中，客户端可以通过Accept头指定希望接收的响应格式，服务器则会根据这一信息决定返回哪种格式的数据。

二、Spring Boot中的内容协商配置

在Spring Boot中，内容协商通过ContentNegotiationConfigurer进行配置。我们可以在配置类中设置默认的媒体类型和支持的媒体类型。

首先，创建一个配置类：

登录后复制

package cn.juwatech.config;

import org.springframework.context.annotation.Configuration;
import org.springframework.web.servlet.config.annotation.ContentNegotiationConfigurer;
import org.springframework.web.servlet.config.annotation.WebMvcConfigurer;

@Configuration
public class WebConfig implements WebMvcConfigurer {

    @Override
    public void configureContentNegotiation(ContentNegotiationConfigurer configurer) {
        configurer
            .favorParameter(true)
            .parameterName("mediaType")
            .ignoreAcceptHeader(false)
            .defaultContentType(org.springframework.http.MediaType.APPLICATION_JSON)
            .mediaType("json", org.springframework.http.MediaType.APPLICATION_JSON)
            .mediaType("xml", org.springframework.http.MediaType.APPLICATION_XML);
    }
}

• 1.
• 2.
• 3.
• 4.
• 5.
• 6.
• 7.
• 8.
• 9.
• 10.
• 11.
• 12.
• 13.
• 14.
• 15.
• 16.
• 17.
• 18.
• 19.
• 20.

三、控制器中的内容协商

接下来，我们在控制器中编写示例代码，展示如何根据请求的媒体类型返回不同格式的数据。

登录后复制

package cn.juwatech.controller;

import cn.juwatech.model.User;
import org.springframework.http.MediaType;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RestController;

import java.util.Arrays;
import java.util.List;

@RestController
public class UserController {

    @GetMapping(value = "/users", produces = {MediaType.APPLICATION_JSON_VALUE, MediaType.APPLICATION_XML_VALUE})
    public List<User> getUsers() {
        return Arrays.asList(
            new User(1, "John Doe", "john.doe@example.com"),
            new User(2, "Jane Smith", "jane.smith@example.com")
        );
    }
}

• 1.
• 2.
• 3.
• 4.
• 5.
• 6.
• 7.
• 8.
• 9.
• 10.
• 11.
• 12.
• 13.
• 14.
• 15.
• 16.
• 17.
• 18.
• 19.
• 20.
• 21.

四、模型类

为了使上述代码正常工作，我们需要创建一个简单的模型类User：

登录后复制

package cn.juwatech.model;

import javax.xml.bind.annotation.XmlRootElement;

@XmlRootElement
public class User {

    private int id;
    private String name;
    private String email;

    public User() {
    }

    public User(int id, String name, String email) {
        this.id = id;
        this.name = name;
        this.email = email;
    }

    public int getId() {
        return id;
    }

    public void setId(int id) {
        this.id = id;
    }

    public String getName() {
        return name;
    }

    public void setName(String name) {
        this.name = name;
    }

    public String getEmail() {
        return email;
    }

    public void setEmail(String email) {
        this.email = email;
    }
}

• 1.
• 2.
• 3.
• 4.
• 5.
• 6.
• 7.
• 8.
• 9.
• 10.
• 11.
• 12.
• 13.
• 14.
• 15.
• 16.
• 17.
• 18.
• 19.
• 20.
• 21.
• 22.
• 23.
• 24.
• 25.
• 26.
• 27.
• 28.
• 29.
• 30.
• 31.
• 32.
• 33.
• 34.
• 35.
• 36.
• 37.
• 38.
• 39.
• 40.
• 41.
• 42.
• 43.
• 44.

五、测试内容协商

现在，我们可以通过不同的方式来测试内容协商功能。

1. 使用浏览器：

• 访问http://localhost:8080/users?mediaType=json，浏览器会显示JSON格式的数据。
• 访问http://localhost:8080/users?mediaType=xml，浏览器会显示XML格式的数据。

2. 使用curl命令行工具：

• 请求JSON格式的数据：

登录后复制

curl -H "Accept: application/json" http://localhost:8080/users

• 1.

• 请求XML格式的数据：

登录后复制

curl -H "Accept: application/xml" http://localhost:8080/users

• 1.

六、使用自定义消息转换器

有时，我们需要自定义消息转换器以支持特殊的媒体类型。以下是一个示例，展示如何在Spring Boot中注册自定义消息转换器。

首先，创建自定义消息转换器类：

登录后复制

package cn.juwatech.converter;

import cn.juwatech.model.User;
import org.springframework.http.HttpInputMessage;
import org.springframework.http.HttpOutputMessage;
import org.springframework.http.MediaType;
import org.springframework.http.converter.AbstractHttpMessageConverter;

import java.io.IOException;
import java.nio.charset.StandardCharsets;

public class CustomMessageConverter extends AbstractHttpMessageConverter<User> {

    public CustomMessageConverter() {
        super(new MediaType("application", "x-custom-type", StandardCharsets.UTF_8));
    }

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

    @Override
    protected User readInternal(Class<? extends User> clazz, HttpInputMessage inputMessage) throws IOException {
        // 实现读取逻辑
        return null;
    }

    @Override
    protected void writeInternal(User user, HttpOutputMessage outputMessage) throws IOException {
        // 实现写入逻辑
        String output = "Custom User Output: " + user.getName();
        outputMessage.getBody().write(output.getBytes(StandardCharsets.UTF_8));
    }
}

• 1.
• 2.
• 3.
• 4.
• 5.
• 6.
• 7.
• 8.
• 9.
• 10.
• 11.
• 12.
• 13.
• 14.
• 15.
• 16.
• 17.
• 18.
• 19.
• 20.
• 21.
• 22.
• 23.
• 24.
• 25.
• 26.
• 27.
• 28.
• 29.
• 30.
• 31.
• 32.
• 33.
• 34.
• 35.

接下来，在配置类中注册这个自定义消息转换器：

登录后复制

package cn.juwatech.config;

import cn.juwatech.converter.CustomMessageConverter;
import org.springframework.context.annotation.Configuration;
import org.springframework.http.converter.HttpMessageConverter;
import org.springframework.web.servlet.config.annotation.WebMvcConfigurer;

import java.util.List;

@Configuration
public class WebConfig implements WebMvcConfigurer {

    @Override
    public void extendMessageConverters(List<HttpMessageConverter<?>> converters) {
        converters.add(new CustomMessageConverter());
    }
}

• 1.
• 2.
• 3.
• 4.
• 5.
• 6.
• 7.
• 8.
• 9.
• 10.
• 11.
• 12.
• 13.
• 14.
• 15.
• 16.
• 17.

七、测试自定义消息转换器

为了测试自定义消息转换器，我们可以更新控制器中的方法，使其支持自定义的媒体类型：

登录后复制

@GetMapping(value = "/custom-user", produces = "application/x-custom-type")
public User getCustomUser() {
    return new User(1, "John Doe", "john.doe@example.com");
}

• 1.
• 2.
• 3.
• 4.

现在，我们可以通过以下命令测试自定义消息转换器：

登录后复制

curl -H "Accept: application/x-custom-type" http://localhost:8080/custom-user

• 1.

总结

通过本文，我们了解了在Spring Boot中实现内容协商的基本方法，包括配置内容协商、使用不同的媒体类型返回数据以及自定义消息转换器。内容协商是构建灵活、高效的RESTful服务的重要组成部分，能够帮助我们更好地满足不同客户端的需求。

原创作者: szk123456 转载于: https://blog.51cto.com/szk123456/11386870