7.解析JSON

7.1 问题

应用程序需要解析从API或其他资源返回的JSON(JavaScript Object Natation,JavaScript对象符号)格式的响应结果。

7.2 解决方案

（API Level 1）
使用Android中的arg.json解析类。SDK在org.json包中自带一个非常高效的类集，用来解析JSON格式的字符串。只需要用已经格式化的字符串数据生成一个新的JSONObject或JSONArray，然后就可以使用一系列存取器方法去获得这些对象中的原始数据或内嵌的JSONObject和JSONArray数据。

7.3 实现机制

默认情况下，这个JSON解析器是非常严格的，也就意味着当遇到无效的JSON数据或键时会抛出异常。以“get”开头的存取器方法在请求的值找不到时会抛出JSONException异常。在某些情况下，这种行为可能不太好，因为存在一套以“opt”为前缀的伴随方法。这些方法在请求的键所对应的值找不到时会返回null,而不是抛出异常。另外，它们中的很多方法都提供了重载版本，可以在失败时返回一个传入的参数，而不是返回null。
让我们看一个示例，了解一下如何将一个JSON字符串解析为一些有用的小数据。先看一下以下代码中的JSON数据。
JSON示例

{
    "person":{
        "name":"John"
        "age":5
        "children":[
            {
                "name":"Billy"
                "age"：5
            },
            {
                "name":"Sarah"
                "age":7
            }，
            {
                "name":"Tommy"
                "age":9
            }
        ]
    }
}

这里定义了一个对象，它有3个值：name(字符串)、age（整型）和children。名为“children”的参数是由其他三个对象组成的数组，每个对象都有自己的name和age。以下两个代码的示例展示了使用org.json分析上述数据并在TextView中显示其中的一些元素。
res/layout/main.xml

JSON解析Activity示例

public class MyActivity extends Activity {
    private static final String JSON_STRING =
            "{\"person\":{\"name\":\"John\",\"age\":30,\"children\":["
            + "{\"name\":\"Billy\",\"age\":5},"
            + "{\"name\":\"Sarah\",\"age\":7},"
            + "{\"name\":\"Tommy\",\"age\":9}"
            + "] } }";

    @Override
    public void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.main);

        TextView line1 = (TextView)findViewById(R.id.line1);
        TextView line2 = (TextView)findViewById(R.id.line2);
        TextView line3 = (TextView)findViewById(R.id.line3);
        try {
            JSONObject person = (new JSONObject(JSON_STRING)).getJSONObject("person");
            String name = person.getString("name");
            line1.setText("This person's name is " + name);
            line2.setText(name + " is " + person.getInt("age") + " years old.");
            line3.setText(name + " has " + person.getJSONArray("children").length()
                + " children.");
        } catch (JSONException e) {
            e.printStackTrace();
        }
    }
}

在本例中，JSON字符串作为常量采用了硬编码的方式。在创建了Activity后，这个字符串被转换为一个JSONObject，这样它的所有数据就可以通过键-值对的方式进行访问，就像存储在map或字典中一样。由于我们使用严格方法来访问数据，因此所有的业务逻辑都被封装在一个try块中。
JSONObject.getString()和JSONObject.getInt()等函数用来读取原始数据并把它们放到TextView中；getJSONArray()用来取出内嵌的children数组。在读取数据时，JSONArray拥有和JSONObject一样的存取器方法集，但它的方法参数是数组的索引而不是键的名称。另外，JSONArray可以返回它的长度，我们会在示例中使用这个长度显示每个人拥有的孩子的数量。
如图显示了示例应用程序的结果：

在Activity中显示解析过的JSON数据

调试技巧：
JSON是一种高效的书写方式；然而，因为阅读原始JSON字符串很难，所有也很难调试解析问题。很多情况下，你所分析的JSON来自于远程资源或者你根本不熟悉它，而且在调试时还需要显示它。
JSONObject和JSONArray都提供了重载的toString()方法，参数为整型，它会返回缩进的打印效果十分漂亮的字符串数据，使之更容易解读。通常在一些麻烦的地方添加诸如myJsonObject.toString(2)这样的代码，可以省去很多时间和烦恼。