解析Json——Json类的静态方法

要使用bantouyan-json库解析Json数据，可以使用类Json。类Json是JsonArray、JsonObject和JsonPrimitive的基类，它有四个静态方法用于解析Json数据，这四个方法分别是parseJsonText、parseJsonReader、parseJavaMap、parseJavaCollection，下面依次介绍。

一、parseJsonText

要将一个表示Json文本的字符串解析成一个Json实例，就要调用方法Json类的静态方法parseJsonText，示例代码如下：

Java代码

import com.bantouyan.json.JsonObject;

public class TestBtyJson
{
public static void main(String[] args)
{
String jsonText = "{a: \"AA\", b: \"BB\", c: 23, d: true, e: null}";
JsonObject jobj = (JsonObject)Json.parseJsonText(jsonText);
System.out.println(jobj.getString("b"));
}
}
//输出： BB

parseJsonText返回一个Json类实例，但在实际使用过程中，我们更常使用的类是JsonArray和JsonObject，你可以用instanceof操作符或者Json类的实例方法getType来确定返回实例的类型。通常情况下，我们知道所解析的字符串内的Json文本到底是表示JsonArray还是JsonObject，即我们知道返回的Json实例的类型，所以我们可以直接使用强制类型转换。

如果我们传给方法parseJsonText的文本既不能表示成一个JsonArray，也不能表示成一个JsonObject，那么这个方法将抛出一个JsonException异常。这是一个runtimeException，没有必要时可以不予捕获，如果你不能保证所解析的Json文本格式正确，那么最好捕获这个异常并加以处理。捕获异常的示例代码如下：

Java代码

import com.bantouyan.json.*;

public class TestBtyJson
{
public static void main(String[] args)
{
String jsonText = "{a \"AA\", b: \"BB\", c: 23, d: true, e: null}";
JsonObject jobj = null;
try
{
jobj = (JsonObject)Json.parseJsonText(jsonText);
}
catch (JsonException e)
{
System.out.println(e.getMessage());
}
}
}
//输出: Non-blank character found at position 3 before ':'.

这个例子中Json Object的第一个子元素的Name与Value之间少了分隔符“:”，导致抛出异常JsonException，异常的Message解释了出现异常的原因：在“:”之前发现了非空白字符。

二、parseJsonReader

如果待解析的文本来自一个Reader对象，那么可以调用Json类的静态方法parseJsonReader，这个方法除了会抛出JsonException异常外，还会抛出IOException异常。示例代码如下：

Java代码

import java.io.IOException;
import com.bantouyan.json.*;

public class TestBtyJson
{
public static void main(String[] args)
{
Reader reader = new ......
JsonObject jobj = null;
try
{
jobj = (JsonObject)Json.parseJsonReader(reader);
}
catch (IOException e)
{
e.printStackTrace();
}
catch (JsonException e)
{
System.out.println(e.getMessage());
}
}
}

parserJsonReader要求被解析的JsonReader内包含一个完整的Json字符串，不允许Json字符串前后有其他非空白内容，否则会抛出异常，而且，读取Reader导致的异常IOException必须在代码中予以处理。

三、parseJavaCollection

如果要将一个Java Collection对象转换为一个JsonArray实例，就要调用方法parseJavaCollection，但要保证Collection对象内部没有循环引用并且所有的子元素都能解析，否则会抛出JsonException异常。示例代码如下：

Java代码

import java.util.*;
import com.bantouyan.json.*;

public class TestBtyJson
{
public static void main(String[] args)
{
ArrayList<Object> list = new ArrayList<Object>();
//list.add(list);
//list.add(new Timer());
JsonArray jary = null;
try
{
jary = Json.parseJavaCollection(list);
}
catch (JsonException e)
{
System.out.println(e.getMessage());
}
}
}
//（第一行注释）输出：Java colloection is referenced again.
//（第二行注释）输出：Cannot parse value: java.util.Timer@60aeb0 to json instance.

例子中的ArrayList经过解析后将得到一个空的JsonArray实例。如果把代码中的第一行注释去掉，那么将抛出由循环引用导致的异常，如果把第二行注释去掉，那么将抛出由无法解析导致的异常。

四、parseJavaMap

parseJavaMap与parseJavaCollection相似，只是把一个Java Map对象解析成JsonObject实例，同样要求Map对象内部没有循环引用并且所有的元素都能解析，否则会抛出JsonException异常。示例代码如下：

Java代码

import java.util.*;
import com.bantouyan.json.*;

public class TestBtyJson
{
public static void main(String[] args)
{
HashMap<Object, Object> map = new HashMap<Object, Object>();
//map.put("self", map);
//map.put("a", new Timer());
JsonObject jobj = null;
try
{
jobj = Json.parseJavaMap(map);
}
catch (JsonException e)
{
System.out.println(e.getMessage());
}
}
}
//（第一行注释）输出：Java map is referenced again.
//（第二行注释）输出：Cannot parse value: java.util.Timer@60aeb0 to json instance.

这个例子与上一个类似，map对象解析后得到一个空的JsonObject实例，如果把代码中的第一行注释去掉，那么将抛出由循环引用导致的异常，如果把第二行注释去掉，那么将抛出由无法解析导致的异常。

五、JsonParser

默认情况下，parseJavaCollection与parseJavaMap只能处理一些简单的类型，如String、Number、Boolean等，如果要处理普通的Java类，就要为这些类实现Jsonable接口。但是这有局限性，例如我们要处理的类不是我们自己编写的而是来自其他包，这时候再使用Jsonable就很不方便。为了解决这种不便，bantouyan-json库还提供了另外一个接口JsonParser，该接口用在parseJavaCollection与parseJavaMap的重载版本parseJavaCollection(Collection, Jsonparser)与parseJavaMap(Map, Jsonparser)中。

Jsonparser有四个方法，canToName用于判断Java对象是否可以转换为JsonObject子元素的Name，changToName用于将Java对象转换为JsonObject子元素的Name，canToJson用于判断Java对象是否可以转换为Json实例，changeToJson用于将Java对象转换为Json实例。需要注意的是，只有通过canToJson（canToName）的Java对象，即返回true，才会在parseJavaCollection(Collection, Jsonparser)与parseJavaMap(Map, Jsonparser)中用changeToJson（changeToName）处理，如果通不过，即返回false，则按默认规则处理。

下面是一个例子：

Java代码

import com.bantouyan.json.*;

public class StringParser implements JsonParser
{
public boolean canToName(Object obj)
{
if(obj instanceof String)
return ((String)obj).startsWith("*");
else
return false;
}

public String changeToName(Object obj) throws JsonException
{
String str = (String)obj;
return "Name_" + str.substring(1);
}

public boolean canToJson(Object obj)
{
if(obj instanceof String)
return ((String)obj).startsWith("#");
else
return false;
}

public Json changeToJson(Object obj) throws JsonException
{
String str = (String)obj;
return new JsonPrimitive("Value_" + str.substring(1));
}
}

Java代码

import java.util.*;
import com.bantouyan.json.*;

public class TestBtyJson
{
public static void main(String[] args)
{
HashMap<Object, Object> map = new HashMap<Object, Object>();
map.put("na", "#va");
map.put("*b", "vb");
ArrayList<Object> list = new ArrayList<Object>();
list.add("eA");
list.add("#eb");
list.add(map);

JsonParser parser = new StringParser();
JsonArray jaryA = Json.parseJavaCollection(list);
System.out.println(jaryA);
JsonArray jaryB = Json.parseJavaCollection(list, parser);
System.out.println(jaryB);
}
}
//输出：["eA","#eb",{"*b":"vb","na":"#va"}]
//输出：["eA","Value_eb",{"Name_b":"vb","na":"Value_va"}]

例子中的JsonParse对于以*开头的Name，会转换为以Name_开头， 对于以#开头的Value，会转换为以Value_开头的字符串型Json实例。