Android扫雷:JSON 解析java.lang.IllegalStateException: Expected a name but was NUMBER 原因及解决方案

最新推荐文章于 2025-03-08 12:44:54 发布

SunnyZhou-1024

最新推荐文章于 2025-03-08 12:44:54 发布

阅读量5.3k

点赞数 1

分类专栏： Android Java 文章标签： java android Exception json解析 json

本文链接：https://blog.youkuaiyun.com/ZM_Yang/article/details/70135839

版权

Android 同时被 2 个专栏收录

6 篇文章

订阅专栏

Java

4 篇文章

订阅专栏

JsonReader:java.lang.IllegalStateException: Expected a name but was NUMBER

JSON (JavaScript Object Notation),是一种轻量级的数据交换格式,不仅易于程序生成和解析,人也很容易看懂,并且不依赖于具体的语言,所以适用范围很广.
用Java解析JSON格式文档,有很多现成的库,比如Gson或者Jackson等,也可以直接使用Android提供的JsonReader这个类,其实都可以,只不过有些比较简便.原理都差不多.
由于JSON是可以嵌套的,对象里面的值可以数字,字符串,浮点读书,也可以是另一对象,或者是数组.而这些对象或者数组中,又可以继续套着数组或者对象……一层套一层.这就使得解析的时候,一不小心就会出错.最常见的就是IllegelStateException.例如:


{
     "name": "zmychou",
     "age": 21,
     "Addr": "Beijing",
     "contact": [
        {"type":"cellphone","detail":["12345678900",10987654321]},
        {"type":"mail","detail":["zmychou@zmychou.com"]}
     ]
}

整个是一个大对象,然后里面contact的值是一个数组,数组又可以包含很多个对象……一直这样下去.而根据JSON 文件解析的参考文档RFC 4627的标注,解析JSON文档是按照起止分隔符进行,并且是深度优先.说的简单点,就是从文档其实部分开始,依次寻找一些特定的分隔符,比如右花括号{ 就是对象的开始,而右花括号}就是对象的结束,中括号也是一样.只要稍有不慎,就会使得这严格相对的起止出现差错,就会抛出IllegelStateException异常.

IllegalStateException主要有两种情况:
1. Expected a name but was NUMBER,其中的NUMBER也可换成STRING或者BOOLEAN等;
2. Expected a END_OBJECT but was END_ARRAY,其中的END_OBJECT和END_ARRAY也可以替换成BEGIN_OBJECT等.

造成1的原因很可能是使用nextName()时,没有使用next*()族(其中*可以使Int,Long等)或者skipValue()进行配套使用.前面说过,JSON解析是深度优先的,而JSON的结构是键值对的形式存在,如果只使用了nextName()忽略了next*()族或者skipValue()进行值的解析,那么,下次在使用nextName()的时候,其实定位到的是前一个键的值上面,就会抛出异常.例如,解析上面的例子:

public ArrayList<String> parser(Context context) {
    try {
        File file = openFile(context);
        JsonReader jr = new JsonReader(new InputStreamReader(new FileInputStream(file), "UTF-8"));
        jr.beginObject();
        Log.e("all!",jr.toString());
        JsonToken token = jr.peek();
        while (jr.hasNext()) {
            switch (jr.nextName()) {
                case "name":
                    Log.e("timestamp", jr.nextString());
                    break;
                case "age":
            //如果我们注释掉下面这句
                    //Log.e("finish", jr.nextInt() + "");
                    break;
                case "Addr":
                    Log.e("start", jr.nextString());
                    break;
                default:
            //或者我们缺少下面这句,就会出现异常
                    jr.skipValue();
                    break;
            }
        }
        jr.endObject();
        jr.close();
    } catch (FileNotFoundException e) {
        //TO-DO save log or tell user
    } catch (IOException e) {
        //TO-DO save log or tell user
    }
}

上例中,如果最后的default语句没有处理跳过,或者任意一个没有使用配套解析值的next*语句,就会抛出异常.比如,在nextName()的结果是age,但是现在我们不想解析出年龄了,我们就没管,break开始新一轮循环,那么此时nextName()定位到的就是age的值,也就是21,显然,这时的Token是NUMBER,而我们给的却是NAME,异常妥妥的.因此,如果使用了nextName(),在遇到不是我们希望解析的键值对时,用skipValue()跳过,使得状态正常.
对于第二种情况,就是没能正确找到对应对象的结束,很有可能是我们使用了beginObject()之后,忘记了配套的使用endObject(),beginArray()对也是类似的.也可能是我们陪错对,例如用beginObject()开头却使用了endArray()结尾,不过这种情况应该不多见.