快捷導(dǎo)航

SpringBoot自定義MessageConverter與內(nèi)容協(xié)商管理器contentNegotiationManager詳解

更新時(shí)間：2022年10月08日 11:34:12 作者：Decade0712

這篇文章主要介紹了SpringBoot自定義MessageConverter與內(nèi)容協(xié)商管理器contentNegotiationManager的使用，文中通過(guò)示例代碼介紹的非常詳細(xì)，對(duì)大家的學(xué)習(xí)或者工作具有一定的參考學(xué)習(xí)價(jià)值，需要的朋友們下面隨著小編來(lái)一起學(xué)習(xí)吧

1、自定義消息轉(zhuǎn)換器MessageConverter

在WebMvcAutoConfiguration類(lèi)中有一個(gè)方法configureMessageConverters()，它會(huì)配置默認(rèn)的MessageConverter

public void configureMessageConverters(List<HttpMessageConverter<?>> converters) {
	this.messageConvertersProvider.ifAvailable((customConverters) -> {
		converters.addAll(customConverters.getConverters());
	});
}

假設(shè)我們現(xiàn)在有一個(gè)新的需求

想要后端返回我們自己定義的格式的數(shù)據(jù)，就叫x-decade，格式為使用分號(hào)拼接Person對(duì)象屬性值

那么就要新建一個(gè)MessageConverter了

package com.decade.converters;
import com.decade.pojo.Person;
import org.springframework.http.HttpInputMessage;
import org.springframework.http.HttpOutputMessage;
import org.springframework.http.MediaType;
import org.springframework.http.converter.HttpMessageConverter;
import org.springframework.http.converter.HttpMessageNotReadableException;
import org.springframework.http.converter.HttpMessageNotWritableException;
import java.io.IOException;
import java.io.OutputStream;
import java.util.List;
public class DecadeConverter implements HttpMessageConverter<Person> {
	// 只考慮寫(xiě)出，所以這里默認(rèn)寫(xiě)false
    @Override
    public boolean canRead(Class<?> clazz, MediaType mediaType) {
        return false;
    }
    @Override
    public boolean canWrite(Class<?> clazz, MediaType mediaType) {
        return clazz.isAssignableFrom(Person.class);
    }
    /**
     * 統(tǒng)計(jì)當(dāng)前converter能支持哪些類(lèi)型
     * @return 返回支持的媒體類(lèi)型
     */
    @Override
    public List<MediaType> getSupportedMediaTypes() {
        return MediaType.parseMediaTypes("application/x-decade");
    }
	// 只考慮寫(xiě)出，所以這里默認(rèn)寫(xiě)null
    @Override
    public Person read(Class<? extends Person> clazz, HttpInputMessage inputMessage) throws IOException, HttpMessageNotReadableException {
        return null;
    }
    @Override
    public void write(Person person, MediaType contentType, HttpOutputMessage outputMessage) throws IOException, HttpMessageNotWritableException {
        // 自定義想要寫(xiě)出的數(shù)據(jù)格式
        String result = person.getName() + ";" + person.getAge() + ";" + person.getBirth();
        // 寫(xiě)出
        final OutputStream body = outputMessage.getBody();
        body.write(result.getBytes());
    }
}

我們發(fā)現(xiàn)，WebMvcConfigurer接口類(lèi)下面有2個(gè)關(guān)于配置MessageConverter的方法

// 會(huì)覆蓋默認(rèn)的MessageConverter
default void configureMessageConverters(List<HttpMessageConverter<?>> converters) {
}
// 不會(huì)覆蓋，只會(huì)在默認(rèn)的MessageConverter后面追加我們自定義的
default void extendMessageConverters(List<HttpMessageConverter<?>> converters) {
}

所以，我們選擇在自定義配置類(lèi)中重寫(xiě)extendMessageConverters()方法

package com.decade.config;
import com.decade.converters.DecadeConverter;
import org.springframework.context.annotation.Bean;
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(proxyBeanMethods = false)
public class MyMvcConfig implements WebMvcConfigurer {
    @Bean
    public WebMvcConfigurer createConvert() {
        return new WebMvcConfigurer() {
            @Override
            public void extendMessageConverters(List<HttpMessageConverter<?>> converters) {
                converters.add(new DecadeConverter());
            }
        };
    }
}

我們?cè)谡?qǐng)求頭中設(shè)置Accept為我們自定義的格式application/x-decade

驗(yàn)證結(jié)果如下

2、自定義內(nèi)容協(xié)商管理器contentNegotiationManager

問(wèn)題：我們新建的x-decade格式是否只能通過(guò)postman調(diào)用才會(huì)生效呢？如果我們要使用瀏覽器參數(shù)方式，怎么才能生效呢？

因?yàn)槲覀冎暗?a href="http://m.fzitv.net/article/264444.htm" target="_blank">【Spring Boot】響應(yīng)處理

它默認(rèn)只能處理xml和json格式，所以為了解決這個(gè)問(wèn)題，我們就要自定義內(nèi)容協(xié)商管理器了

首先我們還是要在自定義配置類(lèi)中重寫(xiě)相關(guān)方法

package com.decade.config;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import org.springframework.http.MediaType;
import org.springframework.web.accept.HeaderContentNegotiationStrategy;
import org.springframework.web.accept.ParameterContentNegotiationStrategy;
import org.springframework.web.servlet.config.annotation.ContentNegotiationConfigurer;
import org.springframework.web.servlet.config.annotation.WebMvcConfigurer;
import java.util.Arrays;
import java.util.HashMap;
import java.util.Map;
@Configuration(proxyBeanMethods = false)
public class MyMvcConfig implements WebMvcConfigurer {
    @Bean
    public WebMvcConfigurer createConvert() {
        return new WebMvcConfigurer() {
            @Override
            public void configureContentNegotiation(ContentNegotiationConfigurer configurer) {
                // 設(shè)置支持的瀏覽器參數(shù)類(lèi)型
                Map<String, MediaType> mediaTypes = new HashMap<>();
                mediaTypes.put("json", MediaType.APPLICATION_JSON);
                mediaTypes.put("xml", MediaType.APPLICATION_XML);
                mediaTypes.put("decade", MediaType.parseMediaType("application/x-decade"));
                final ParameterContentNegotiationStrategy strategy = new ParameterContentNegotiationStrategy(mediaTypes);
                // 為了繼續(xù)支持請(qǐng)求頭參數(shù)類(lèi)型，還需要往里面塞請(qǐng)求頭內(nèi)容協(xié)商管理器
                final HeaderContentNegotiationStrategy headerContentNegotiationStrategy = new HeaderContentNegotiationStrategy();
                configurer.strategies(Arrays.asList(strategy, headerContentNegotiationStrategy));
            }
        };
    }
}

可以看到，系統(tǒng)中的內(nèi)容協(xié)商管理器下面還是原來(lái)的2種：獲取請(qǐng)求頭中的Accept和獲取請(qǐng)求參數(shù)中的format

但是獲取請(qǐng)求參數(shù)format，除了能識(shí)別原來(lái)的json和xml，還能識(shí)別我們自定義的application/x-decade，它使用decade與之對(duì)應(yīng)

可以看到，我們自定義的媒體類(lèi)型成功加入服務(wù)器能解析出來(lái)的類(lèi)型

我們寫(xiě)一個(gè)接口進(jìn)行驗(yàn)證

@GetMapping(value = "/testPerson")
@ResponseBody
public Person testPerson() {
	Person person = new Person();
	person.setName("decade");
	person.setAge(24);
	person.setBirth(new Date());
	return person;
}

由驗(yàn)證結(jié)果可以知道，我們從postman和瀏覽器都可以獲得我們指定格式的數(shù)據(jù)

到此這篇關(guān)于SpringBoot自定義MessageConverter與內(nèi)容協(xié)商管理器contentNegotiationManager詳解的文章就介紹到這了,更多相關(guān)SpringBoot MessageConverter內(nèi)容請(qǐng)搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持腳本之家！

您可能感興趣的文章: