JSON (JavaScript Object Notation)为一种数据交换结构,相比 XML,JSON 的语法显得更为轻巧,大大地减少数据交换时所要传递的数据量。在 Java 语言里,有许多根据 JSON 数据交换标准实作出来的 Library,json.org 和 Gson 就是其中的两种。

json.org

Gson

json.org 和 Gson 的差异

json.org 和 Gson 虽都能够完整处理 JSON 数据,但在实际撰写程序的时候,两者的用法却不太相同。举例来说:若要捞出 JSON 对象(JSONObject)内所有的 Key,json.org 的函数库可以直接使用 keySet() 方法得到 key 的 set(方法类似 Java Collections 的 HashMap),然后再使用 for-each 或是 iterator 去走访 set 里所有的 key。但是在 Gson 中,需要使用 entrySet() 取得所有 entry 的 set,再用 for-each 或是 iterator 去走访 set 里所有的 entry,然后用 entry 的 getKey() 方法来取得 entry 的 key。笔者比较喜欢 json.org 的作法,因为少了一层 entry,做起来稍微容易。若要 key 值所对应的 value,可以用 JSON 对象的 get 方法。Gson 取出的 entry 虽可以直接取得 JsonElement,若要使用还要先去转换型态,个人觉得没有比较好用,所以通常还是会拿 key 透过 get 方法取出值。

Gson 提供了一个方便的功能,它能够将 Java 对象转换成 JSON 字符串或是 JSON 的对象或数组,也可以将 JSON 字符串或是 JSON 的对象或数组转回 Java 对象。若有个 class 结构如下:

class A {

    int a = 1;
    String s = "123";
    int[] arr = {2,4,6};
}

透过 Gson 可以将这个 A 类别产生出的对象实体转换成 JSON 字符串如下:

{"a":1,"s":"123","arr":[2,4,6]}

若使用 json.org 的函数库,则没有提供类似的功能,只能够用 put 的方法慢慢将 key 和 value 插入进 JSON 对象内。

MagicLen JSON(Mson)

由于笔者习惯使用 json.org 的函数库,又想要拥有 Gson 的功能,因此决定将 json.org 和 Gson 结合,创造出 Mson。使用 Mson 可以将 Java 对象转换成 json.org 的 JSON 对象或数组,也可以将 json.org 的 JSON 对象或数组转回 Java 对象。而且比起 Gson 所提供的转换功能,Mson 更为简易,而且层数更少。同时,Mson 还支持一次将多种 Java 不同的对象转成 JSON 数组,当然也能将此包含不同 Java 对象的 JSON 数组,转回 Java 对象的数组(Object[])。Gson 采用固定型态的转换,而 Mson 则采用优先型态的转换,用户可以自订要尝试转换成的对象类别,故使用起来 Mson 会比 Gson 更为自由、简单。

除此之外,Mson 还可以使用 toString(json, true) 方法来产生出整齐的 JSON 结构字符串,结果如下:

{
    "a" : [
        {
	        "b" : "Hello, welcome to MagicLen!"
        },
        {
	        "c" : "My name is Magic Len."
        },
        "Thanks",
        88
    ]
}

也可以使用 toXML 或是 fromXML 方法将 JSON 转成 XML,或是将 XML 转成 JSON 哦!

<a><b>Hello, welcome to MagicLen!</b></a><a><c>My name is Magic Len.</c></a><a>Thanks</a><a>88</a>

MagicLenJSON 的源代码、函数库和文档可以在 GitHub 上取得,网址如下: