如何保持json序列化的顺序性？
说到json,相信没有人会陌生,我们天天都在用。那么，我们来讨论个问题，json有序吗？是谁来决定的呢？如何保持？
说到底，json是框架还是啥？实际上它只是一个数据格式，一个规范标准，它永远不会限制实现方的任何操作，即不会自行去保证什么顺序性之类的。json的格式仅由写入数据的一方决定其长像如何。而数据读取一方，则按照json的协议标准进行解析，即可理解原数据的含义。json拥有较为丰富的数据格式，所以对当前应用还是比较友好的。
那么，我们如何处理json的顺序性呢？
1. 保持json有序的思路
首先，我们要澄清有序性的概念：从某种程度上，我们可以把json看作是一个个的kv组成的数据，从这个层面上来讲，我们可以把有序性定义为json的key保持有序，先假设为字典序吧，那么就说这个json数据是有序的。
其次，因为json的数据支持嵌套，所以，我们应该需要保持每一层的数据都有序，才是完整有序的。
ok, 理解完有序的概念，下面我们来看看如何实现有序？
json本身是不可能保持有序了，所以，当我们自行写入json数据时，只需要按照 abcde... 这种key顺序写入数据，那么得到的最终json就是有序的。
但我们一般都是使用对象进行程序变换的，所以，就应该要从对象中取出有序的key, 然后序列化为json.
这里保持有序，至少有两个层面的有序：1. kv形式的key的有序; 2. 列表形式的数据有序; 还有其他可能非常复杂的有序性需求，比如按照某字段有序，倒序。。。
所以，想保持json有序很简单，保证有序写入就可以了。（貌似等于没有说哦）
2. 保持json有序的应用场景举例
为什么要保持json有序呢？json相当于kv数据，一般情况下我们是不需要保证有序的，但有些特殊情况下也许有用。比如我有两份json数据，我想比较它们是否是相等的时候！
比如第一份数据是 {"a":1, "b":2}, 第二份数据是 {"b":2, "a":1}, 那么你说这两份数据是否是相等的呢？相等或不相等依据是啥？
如果对于固定数据结构的json, 那么也许我们可以直接取出每个key的值，然后进行比较，全部相等则相等成立，否则不相等。
但对于json本身就是各种不确定的数据组成，如果我们限制死必须取某些key, 那么这个通用性就很差了。所以，我们要想比较两个json是否相等，还应该要有另外的依据。
另外，当我们将有序json写入文件之后，当key的数据非常多时，有序实际上可以辅助我们快速找到对应的key所在的位置。这是有序性带来的好处，快速查找！
比如下面的例子，对比两个结果集是否相等，你觉得结果当如何呢？
@Test public void testJsonObjectOrder() { String res1, res2; List<Map<String, Object>> nList; Map<String, Object> data = new HashMap<>(); data.put("d", "cd"); data.put("a", 1); data.put("b", 0.45); data.put("total", 333); List<Map<String, Object>> list = new ArrayList<>(); Map<String, Object> item1 = new HashMap<>(); item1.put("aa", 1); item1.put("ee", 5); item1.put("bb", 6); item1.put("nn", null); list.add(item1); Map<String, Object> item2 = new HashMap<>(); item2.put("xxx", "000"); item2.put("q", 2); item2.put("a", "aa"); list.add(item2); data.put("sub", list); Map<String, Object> nData = new HashMap<>(data); nData.put("c", null); nData.put("abc", null); res1 = JSONObject.toJSONString(data); res2 = JSONObject.parseObject(JSONObject.toJSONString(nData)).toJSONString(); Assert.assertEquals("序列化结果不相等default", res1, res2); res2 = JSONObject.toJSONString(JSONObject.parseObject( JSONObject.toJSONString(nData, SerializerFeature.SortField)), SerializerFeature.SortField); Assert.assertEquals("序列化结果不相等sort", res1, res2); nList = new ArrayList<>(); nList.add(item2); nList.add(item1); nData.put("sub", nList); res2 = JSONObject.parseObject(JSONObject.toJSONString(nData)).toJSONString(); Assert.assertEquals("序列化结果不相等array", res1, res2); }
以上是fastjson库进行json序列化的处理方式，json的数据结构大部分使用可以用map进行等价，除了纯数组的结构以外。以上测试中，除了最后一个array的位置调换，导致的结果不一样之外，总体还是相等的。纠其原因，是因为原始数据结构是一致的，而fastjson从一定程度上维持了这个有序性。
3. fastjson维护json的有序性的实现
很显然，让我们自行写json的工具类，还是有一定的难度的，至少要想高效完整地写json是困难的。所以，一般我们都是借助一些现有的开源类库。
上一节中说到，fastjson维护了json一定的顺序性，但是并非完整维护了顺序性，它的顺序性要体现在，相同的数据结构序列化的json，总能得到相同的反向的相同数据结构的数据。比如，ArrayList 的顺序性被维护，map的顺序性被维护。
但是很明显，这些顺序性是根据数据结构的特性而定的，而非所谓的字典序，那么，如果我们想维护一个保持字典序的json如何处理呢？看看下面的实现：
public class JsonObjectTest { @Test public void testJsonObjectOrder() { String res1, res2; List<Map<String, Object>> nList; Map<String, Object> data = new HashMap<>(); data.put("d", "cd"); data.put("a", 1); data.put("b", 0.45); data.put("total", 333); List<Map<String, Object>> list = new ArrayList<>(); Map<String, Object> item1 = new HashMap<>(); item1.put("aa", 1); item1.put("ee", 5); item1.put("bb", 6); item1.put("nn", null); list.add(item1); Map<String, Object> item2 = new HashMap<>(); item2.put("xxx", "000"); item2.put("q", 2); item2.put("a", "aa"); list.add(item2); data.put("sub", list); Map<String, Object> nData = new HashMap<>(data); nData.put("c", null); nData.put("abc", null); res1 = JSONObject.toJSONString(data); res2 = JSONObject.parseObject(JSONObject.toJSONString(nData)).toJSONString(); Assert.assertEquals("序列化结果不相等default", res1, res2); res2 = JSONObject.toJSONString(JSONObject.parseObject( JSONObject.toJSONString(nData, SerializerFeature.SortField)), SerializerFeature.SortField); Assert.assertEquals("序列化结果不相等sort", res1, res2); res2 = JSONObject.toJSONString(JSONObject.parseObject( JSONObject.toJSONString(nData, SerializerFeature.WriteMapNullValue)), SerializerFeature.WriteMapNullValue); Assert.assertEquals("序列化结果不相等null", res1, res2); nList = new ArrayList<>(); nList.add(item2); nList.add(item1); nData.put("sub", nList); res2 = JSONObject.parseObject(JSONObject.toJSONString(nData)).toJSONString(); Assert.assertEquals("序列化结果不相等array", res1, res2); nList = new ArrayList<>(); nList.add(item2); nList.add(item1); nData.put("sub", nList); res1 = transformDataToJSONAsOrderWay(data); res2 = transformDataToJSONAsOrderWay(nData); Assert.assertEquals("序列化结果不相等array-s", res1, res2); } /** * 将原始数据转换为有序的集合 */ private String transformDataToJSONAsOrderWay(Map<String, Object> data) { TreeMap<String, Object> transformedData = new TreeMap<>(); for (Map.Entry<String, Object> entry : data.entrySet()) { if(entry.getValue() == null) { continue; } if(entry.getValue() instanceof List) { TreeMap<String, Integer> tmpMap = new TreeMap<>(); List value = (List) entry.getValue(); for (int i = 0; i < (value).size(); i++) { Object it1 = value.get(i); // 假设只支持二维数组嵌套 tmpMap.put(transformDataToJSONAsOrderWay((Map<String, Object>) it1), i); } List<Object> orderedList = new ArrayList<>(tmpMap.size()); for (Integer listNo : tmpMap.values()) { orderedList.add(value.get(listNo)); } transformedData.put(entry.getKey(), orderedList); continue; } transformedData.put(entry.getKey(), entry.getValue()); } return JSONObject.toJSONString(transformedData); } }
以上就是完整的基于fastjson实现的json字典序维持的实现了，其实就是 transformDataToJSONAsOrderWay() 方法，其原理也简单，因fastjson的有序性，依赖于输入的数据结构，那么只要维护好输入结构的字典序就好了。TreeMap 是以字典序排序key的一种数据结构，符合这需求，另外，将list这种数据结构，转化为kv这种数据结构，将整个item作为key排序后，再将其放入对应位置，从而保证了整体的顺序性。但这种list的顺序性，不一定是大家所理解的字典序，但一定可以保证得到相同的顺序。
另外，fastjson中还考虑了对于null值的处理，比如json中有null值的数据与没有null值的数据，你说是相等呢还是不相等呢？
4. hashmap数据结构的顺序迭代原理
map是一种kv型的数据结构存储，一般可以认为其是无序的。但我们可以额外的维护一些属性，以保证它能够以某种顺序输出数据，顺序性主要体现在进行迭代时，如使用 keyset(), values(), entrySet() 等方法。针对额外维护顺序性的数据结构而言，其迭代自然是基于其额外字段。但针对无序的hashmap这种数据结构而言，我们知道其底层数据是根据hash值乱序存储的。简单来说就是根据一个hash值，然后求余定位到一个数组下标中。即对hashmap所分配的数组对象的下标，有可能有值，有可能没有值，那么在做迭代的时候如何做呢？多次做迭代的顺序一致吗？一个最简单的思路自然是依次遍历数据的每个元素，直到数据的最大值。这样，肯定是可以保证多次遍历的顺序性的。那么，hashmap是否是这样实现的呢？
// java.util.HashMap#forEach @Override public void forEach(BiConsumer<? super K, ? super V> action) { Node<K,V>[] tab; if (action == null) throw new NullPointerException(); if (size > 0 && (tab = table) != null) { int mc = modCount; // 1. 迭代所有数组元素 // 2. 迭代hash冲突时的链表 for (int i = 0; i < tab.length; ++i) { for (Node<K,V> e = tab[i]; e != null; e = e.next) action.accept(e.key, e.value); } if (modCount != mc) throw new ConcurrentModificationException(); } } // java.util.HashMap.EntrySet#forEach public final void forEach(Consumer<? super Map.Entry<K,V>> action) { Node<K,V>[] tab; if (action == null) throw new NullPointerException(); if (size > 0 && (tab = table) != null) { int mc = modCount; for (int i = 0; i < tab.length; ++i) { for (Node<K,V> e = tab[i]; e != null; e = e.next) action.accept(e); } if (modCount != mc) throw new ConcurrentModificationException(); } } // keySet(), 换成了取key的处理 // java.util.HashMap.KeySet#forEach public final void forEach(Consumer<? super K> action) { Node<K,V>[] tab; if (action == null) throw new NullPointerException(); if (size > 0 && (tab = table) != null) { int mc = modCount; for (int i = 0; i < tab.length; ++i) { for (Node<K,V> e = tab[i]; e != null; e = e.next) action.accept(e.key); } if (modCount != mc) throw new ConcurrentModificationException(); } } // values() 换成了取value的处理 // java.util.HashMap.Values#forEach public final void forEach(Consumer<? super V> action) { Node<K,V>[] tab; if (action == null) throw new NullPointerException(); if (size > 0 && (tab = table) != null) { int mc = modCount; for (int i = 0; i < tab.length; ++i) { for (Node<K,V> e = tab[i]; e != null; e = e.next) action.accept(e.value); } if (modCount != mc) throw new ConcurrentModificationException(); } }
TreeMap基于key做排序处理，最符合有序性要求，其迭代实现如下：
// java.util.TreeMap#forEach @Override public void forEach(BiConsumer<? super K, ? super V> action) { Objects.requireNonNull(action); int expectedModCount = modCount; // 从最小的key开始取，进行二叉树的中序遍历 // 因该二叉树在插入时维护了有序性，进行遍历时也就有了顺序了 for (Entry<K, V> e = getFirstEntry(); e != null; e = successor(e)) { action.accept(e.key, e.value); if (expectedModCount != modCount) { throw new ConcurrentModificationException(); } } } /** * Returns the successor of the specified Entry, or null if no such. */ static <K,V> TreeMap.Entry<K,V> successor(Entry<K,V> t) { if (t == null) return null; else if (t.right != null) { Entry<K,V> p = t.right; while (p.left != null) p = p.left; return p; } else { Entry<K,V> p = t.parent; Entry<K,V> ch = t; while (p != null && ch == p.right) { ch = p; p = p.parent; } return p; } }
LinkedHashMap是按照插入的顺序排列的一种map, 它与ArrayList这种有序性有相似性，但相对难以理解一些。因为list这种数据结构，你说先插入哪个元素，后插入哪个元素，是显而易见的。然而像map这种数据结构，你很想像它是先插入某元素，再插入另一个元素的，这是一种先入为主的概念导致的。但它并不影响我们理解map有序性的实现，LinkedHashMap的迭代实现如下：
// java.util.LinkedHashMap#forEach public void forEach(BiConsumer<? super K, ? super V> action) { if (action == null) throw new NullPointerException(); int mc = modCount; // 仅通过维护插入时的链表，即可实现有序迭代 for (LinkedHashMap.Entry<K,V> e = head; e != null; e = e.after) action.accept(e.key, e.value); if (modCount != mc) throw new ConcurrentModificationException(); }
ok, 到此我们分析了多个类型的map的有序性的实现。从内部解释了为什么我们使用TreeMap数据结构时，就可以使json保持字典序了。因为fastjson在写json数据时，针对map的写入，就是通过entrySet()迭代元素进行写入的了。
