springboot升級2.0 fastjson報錯? 2.0以上應該怎么整合fastjson？

SpringBoot2.0如何集成fastjson？在網上查了一堆資料，但是各文章的說法不一，有些還是錯的，可能只是簡單測試一下就認為ok了，最后有沒生效都不知道。恰逢公司項目需要將JackSon換成fastjson，因此自己來實踐一下SpringBoot2.0和fastjson的整合，同時記錄下來方便自己后續查閱。

一、Maven依賴說明

　　SpringBoot的版本為： <version>2.1.4.RELEASE</version>

　　 在pom文件中添加fastjson的依賴:

<dependency>
         <groupId>com.alibaba</groupId>
         <artifactId>fastjson</artifactId>
         <version>1.2.60/version>
</dependency>

 

 

二、整合

　　整合之前，我們先說下springboot1.0的方法，輕車熟路的去自定了一個SpringMvcConfigure去繼承WebMvcConfigurerAdapter,然后你就發現這個WebMvcConfigurerAdapter竟然過時了?what?點進去看源碼:

 

/**
 * An implementation of {@link WebMvcConfigurer} with empty methods allowing
 * subclasses to override only the methods they're interested in.
 *
 * @author Rossen Stoyanchev
 * @since 3.1
 * @deprecated as of 5.0 {@link WebMvcConfigurer} has default methods (made
 * possible by a Java 8 baseline) and can be implemented directly without the
 * need for this adapter
 */
@Deprecated
public abstract class WebMvcConfigurerAdapter implements WebMvcConfigurer {}

 

 

　　可以看到從spring5.0開始就被@Deprecated,原來是java8中支持接口中有默認方法,所以我們現在可以直接實現WebMvcConfigurer,然后選擇性的去重寫某個方法,而不用實現它的所有方法.

 

　　於是就實現了WebMvcConfigurer:

 

@Configuration
public class SpringMvcConfigure implements WebMvcConfigurer {
 
    /**
     * 配置消息轉換器
     * @param converters
     */
    @Override
    public void configureMessageConverters(List<HttpMessageConverter<?>> converters) {
        FastJsonHttpMessageConverter fastJsonHttpMessageConverter = new FastJsonHttpMessageConverter();
        //自定義配置...
        FastJsonConfig config = new FastJsonConfig();
        config.setSerializerFeatures(SerializerFeature.QuoteFieldNames,
                SerializerFeature.WriteEnumUsingToString,
                /*SerializerFeature.WriteMapNullValue,*/
                SerializerFeature.WriteDateUseDateFormat,
                SerializerFeature.DisableCircularReferenceDetect);
        fastJsonHttpMessageConverter.setFastJsonConfig(config);
        converters.add(fastJsonHttpMessageConverter);
    }
 
}

 

 

　　本以為這樣子配置就可以完事兒,但是詭異的事情發生了,我明明注釋了SerializerFeature.WriteMapNullValue,可是返回的json中仍然有為null的字段,然后我就去com.alibaba.fastjson.support.spring.FastJsonHttpMessageConverter中的write和writeInternal打了斷點,再次執行,竟然什么都沒有發生,根本沒有走這兩個方法,於是在自定義的SpringMvcConfigure中configureMessageConverters方法內打了斷點,想看看這個方法參數converters里邊到底有什么:

 

 

 

　　看到這里就想到,肯定是我自己添加的fastjson在后邊,所以沒有生效,所以就加了以下代碼:

 

@Override
public void configureMessageConverters(List<HttpMessageConverter<?>> converters) {
    converters = converters.stream()
                .filter((converter)-> !(converter instanceof MappingJackson2HttpMessageConverter))
                .collect(Collectors.toList());
    FastJsonHttpMessageConverter fastJsonHttpMessageConverter = new FastJsonHttpMessageConverter();
    //自定義配置...
    FastJsonConfig config = new FastJsonConfig();
    config.setSerializerFeatures(SerializerFeature.QuoteFieldNames,
            SerializerFeature.WriteEnumUsingToString,
            /*SerializerFeature.WriteMapNullValue,*/
            SerializerFeature.WriteDateUseDateFormat,
            SerializerFeature.DisableCircularReferenceDetect);
    fastJsonHttpMessageConverter.setFastJsonConfig(config);
    converters.add(fastJsonHttpMessageConverter);
}

 

 

　　這還是不生效的，繼續追蹤，得出如下結論：

 　　  (1)源碼分析可知，返回json的過程為:
           Controller調用結束后返回一個數據對象，for循環遍歷conventers，找到支持application/json的HttpMessageConverter，然后將返回的數據序列化成json。
           具體參考org.springframework.web.servlet.mvc.method.annotation.AbstractMessageConverterMethodProcessor的writeWithMessageConverters方法
      (2)由於是list結構，我們添加的fastjson在最后。因此必須要將jackson的轉換器刪除，不然會先匹配上jackson，導致沒使用fastjson

　　最終得出代碼如下：

 

@Configuration
public class SpringWebMvcConfigurer implements WebMvcConfigurer {

    private final Logger logger = LoggerFactory.getLogger(SpringWebMvcConfigurer.class);

    //使用阿里 FastJson 作為JSON MessageConverter
    @Override
    public void configureMessageConverters(List<HttpMessageConverter<?>> converters) {

         /*
         先把JackSon的消息轉換器刪除.
         備注: (1)源碼分析可知，返回json的過程為:
                    Controller調用結束后返回一個數據對象，for循環遍歷conventers，找到支持application/json的HttpMessageConverter，然后將返回的數據序列化成json。
                    具體參考org.springframework.web.servlet.mvc.method.annotation.AbstractMessageConverterMethodProcessor的writeWithMessageConverters方法
               (2)由於是list結構，我們添加的fastjson在最后。因此必須要將jackson的轉換器刪除，不然會先匹配上jackson，導致沒使用fastjson
        */
        for (int i = converters.size() - 1; i >= 0; i--) {
            if (converters.get(i) instanceof MappingJackson2HttpMessageConverter) {
                converters.remove(i);
            }
        }

        FastJsonHttpMessageConverter converter = new FastJsonHttpMessageConverter();
        FastJsonConfig config = new FastJsonConfig();
        config.setSerializerFeatures(
                SerializerFeature.WriteMapNullValue,//保留空的字段
                SerializerFeature.WriteNullStringAsEmpty,//String null -> ""
                SerializerFeature.WriteNullNumberAsZero,//Number null -> 0
                SerializerFeature.WriteDateUseDateFormat);//日期格式化

        converter.setFastJsonConfig(config);
        converter.setDefaultCharset(Charset.forName("UTF-8"));
        converters.add(converter);
    }
}

 

 

　　總結

1. 最重要的還是解決了springboot2.0.2配置fastjson不生效的問題
2. 更加明白stream api返回的都是全新的對象
3. 更理解java是值傳遞而不是引用傳遞
4. 了解到想要在迭代過程中對集合進行操作要用Iterator,而不是直接簡單的for循環或者增強for循環