使用fastjson時出現$ref: "$.list[2]"的解決辦法（重複引用）

最近下作成績分析的功能的時候，出現了$ref: "$.list[2]"的狀況。
而後我查了一下出現這種狀況的緣由和解決辦法。

出現$ref: "$.list[2]"的緣由是由於循環引用/內存對象重複

那麼什麼是重複/循環引用？

簡單說，重複引用就是一個集合/對象中的多個元素/屬性同時引用同一對象，循環引用就是集合/對象中的多個元素/屬性存在相互引用致使循環。

舉例說明

重複引用

List<Object> list = new ArrayList<>();  
Object obj = new Object();  
list.add(obj);  
list.add(obj);

循環引用

// 循環引用的特殊狀況，自引用  
Map<String,Object> map = new HashMap<>();  
map.put("map",map);  
//  
// map1引用了map2，而map2又引用map1，致使循環引用  
Map<String,Object> map1 = new HashMap<>();  
Map<String,Object> map2 = new HashMap<>();  
map1.put("map",map2);  
map2.put("map",map1);

循環引用會觸發的問題

暫時不說重複引用，單說循環引用。
通常來講，存在循環引用問題的集合/對象在序列化時（好比Json化），若是不加以處理，會觸發StackOverflowError異常。

分析緣由：當序列化引擎解析map1時，它發現這個對象持有一個map2的引用，轉而去解析map2。解析map2時，發現他又持有map1的引用，又轉回map1。如此產生StackOverflowError異常。

FastJson對重複/循環引用的處理

首先，fastjson做爲一款序列化引擎，不可避免的會遇到循環引用的問題，爲了不StackOverflowError異常，fastjson會對引用進行檢測。

若是檢測到存在重複/循環引用的狀況，fastjson默認會以「引用標識」代替同一對象，而非繼續循環解析致使StackOverflowError。

如下文兩例說明,查看json化後的輸出

1.重複引用 JSON.toJSONString(list)

[  
    {},  //obj的實體  
    {  
        "$ref": "$[0]"   //對obj的重複引用的處理  
    }  
]

2.循環引用 JSON.toJSONString(map1)

{  
// map1的key:value對  
    "map": {  
         // map2的key:value對  
        "map": {  
             // 指向map1，對循環引用的處理  
            "$ref": ".."  
        }  
    }  
}

引用標識說明：

「$ref」:」..」 上一級
「$ref」:」@」 當前對象，也就是自引用
「$ref」:」$」 根對象
{"$ref":"../.."} 引用父對象的父對象
「$ref」:」$.children.0」 基於路徑的引用，至關於root.getChildren().get(0)

解決方法：

知道出現的緣由後，我發現我寫那個接口是確實有重複引用的，由於需求要有個最低科的詳細狀況，還有掛科的各個科詳細狀況，因此當某個學生掛科了，那麼他最低科和掛科的那個list裏面的對象就重複了。當時這個需求是這樣，也只能尋找其餘方法了。

關閉FastJson的引用檢測
查看一下fastjson的API，有兩種關閉方法。

局部的

JSON.toJSONString(object, SerializerFeature.DisableCircularReferenceDetect);

全局的

普通的spring項目的話，用xml配置

<mvc:annotation-driven>  
        <mvc:message-converters register-defaults="true">  
            <bean  
                class="com.alibaba.fastjson.support.spring.FastJsonHttpMessageConverter">  
                <property name="supportedMediaTypes">  
                    <array>  
                        <value>text/html;charset=UTF-8</value>  
                    </array>  
                </property>  
                <property name="features">  
                    <array>  
                        <value>WriteMapNullValue</value>  
                        <value>WriteNullStringAsEmpty</value>  
                        <!-- 全局關閉循環引用檢查，最好是不要關閉，否則有可能會StackOverflowException -->
                        <value>DisableCircularReferenceDetect</value>
                    </array>  
                </property>  
            </bean>  
        </mvc:message-converters>  
    </mvc:annotation-driven>

若是springboot的話

public class FastJsonHttpMessageConverterEx extends FastJsonHttpMessageConverter{
    public FastJsonHttpMessageConverterEx(){
        //在這裏配置fastjson特性(全局設置的)
        FastJsonConfig fastJsonConfig = new FastJsonConfig();
        //fastJsonConfig.setDateFormat("yyyy-MM-dd HH:mm:ss");    //自定義時間格式
        //fastJsonConfig.setSerializerFeatures(SerializerFeature.WriteMapNullValue);  //正常轉換null值
        //fastJsonConfig.setSerializerFeatures(SerializerFeature.DisableCircularReferenceDetect);     //關閉循環引用
        this.setFastJsonConfig(fastJsonConfig);
    }

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

@Configuration
public class WebMvcConfigurer extends WebMvcConfigurerAdapter {
    .....
    @Bean
    public FastJsonHttpMessageConverterEx fastJsonHttpMessageConverterEx(){
        return new FastJsonHttpMessageConverterEx();
    }
}

配置這個DisableCircularReferenceDetect的做用是：決定了生成的「多個」JSON對象中，是否加載被引用的同一個對象的數據。

開啓和關閉FastJson的「循環引用檢測」特性的對比

如今的問題：

全局關閉引用檢測確實是方便，可是有可能的之後的代碼愈來愈多的狀況出現StackOverflowError。可是局部的關閉引用檢測的話也有些小問題。JSON.toJSONString(object, SerializerFeature.DisableCircularReferenceDetect) 這個方法是把對象轉爲String對象，若是在@ResponseBody註解的方法裏返回這個String對象的話，就會像我以前那篇文章springMVC源碼分析--HttpMessageConverter（三）之寫write操做所說那些樣
在加了@ResponseBody註解的Controller中使用

String result = JSON.toJSONString(obj);
return result;

這種狀況就至關於JSON.toJSONString() 這句話執行了兩次。
固然你也能夠HttpServletResponse 輸出流的方法輸出這個字符串，否則爲了代碼風格統一，仍是不採用這種。

有沒有更好的解決方法？最終還回到那個緣由上，由於咱們重複引用同一個對象，因此如今解決方法應該是把那個掛科成績對象score 轉到另一個新的對象。

List<Object> list = new ArrayList<>();
Object obj = new Object();
list.add(obj);
// 建立新的對象
Object newObj = new Object();
// 使用org.springframework.beans.BeansUtils複製屬性值
BeansUtils.copyProperties(obj, newObj);
list.add(newObj);

BeanUtils能夠經過反射機制將兩個對象進行屬性的拷貝，可是他們不是指向同一個地址，至關好用，假如你的bean有不少個屬性，你就不用逐個複製屬性了。

避免重複引用序列化時顯示$ref

在編碼時，使用新對象爲集合或對象賦值，而非使用同一對象
不要在多處引用同一個對象，這能夠說是一種java編碼規範，須要時刻注意。
不要關閉FastJson的引用檢測來避免顯示$ref
引用檢測是FastJson提供的一種避免運行時異常的優良機制，若是爲了不在重複引用時顯示$ref而關閉它，會有很大可能致使循環引用時發生StackOverflowError異常。這也是FastJson默認開啓引用檢測的緣由。

避免重複/循環引用的正確姿式

一、重複引用
能夠向上面的代碼同樣，建立新的對象，把要有重複須要的對象的屬性複製給新對象，新對象再添加到json那裏。
二、循環引用
循環引用這種邏輯自己就不合理，須要在編碼時注意避免，這是邏輯錯誤而非編碼技巧。

做者：carway 連接：https://www.jianshu.com/p/6041242405e8 來源：簡書 簡書著做權歸做者全部，任何形式的轉載都請聯繫做者得到受權並註明出處.