Skip to content

Codartizan/zson

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

47 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

zson

####专为测试人员打造的JSON解析器

当然,有很多很好的JSON解析的JAR包,比如JSONOBJECT,GSON,甚至也有为我们测试人员而打造的JSONPATH,但我还是自已实现了一下(之前也实现过,现在属于重构)。其主要特点是用一个类似于xpath的选择器来获取相应的值。


####特点

  • 无需层层解析
  • 根据给定的路径(类XPATH路径)来获取相应的值
  • 支持相对路径

####实现思路

思想是这样的,以这个JSON串为例(我自已随手写的):

{"a":"b","cb":{"a":1},"d":["a",{"a":3},{"a":2},""],"e":"b"}
{
    "a": "b",
    "cb": {
        "a": 1
    },
    "d": [
        "a",
        {
            "a": 3
        },
        {
            "a": 2
        },
        ""
    ],
    "e": "b"
}

我们在保证只扫描一次字符串的情况下,就把JSON串解析成功。于是,我先定义了一个List:

private List<Object> collections = new ArrayList<Object>();

collections用来存放这个JSON串中所有的LIST与MAP,在扫描时,一旦碰到{或[,就new一个Map或List,然后add到collections中去了:

image

存放进去后,我们需要一个map来记录collections里的list或map的状态,比如是否已经闭合了,是一个list还是一个map,在collections中的index:

private Map<String, Map<String, Integer>> index = new HashMap<String, Map<String, Integer>>();

image

可以看到,这个MAP的key是由1 1.1 1.2 1.1.1这样来组成的,所以,这个key就可以用来表示json的层级结构了,当然我还用了一个list来保存这些key的顺序:

private List<String> level = new ArrayList<String>();

image

这样一来,数据结构就很清晰了。接下来要做的事,就是在扫描中的一些判断了,保持以下几个点:

  1. 碰到[或{就new一个对象,并将对象存放到collections中去

  2. 碰到'\'需要转义的,得直接跳过去,并存放到扫描出来的临时变量中去。比如\{就不需要new一个对象

  3. 碰到"符号,就要打个标记,在下一个"出现之前,把扫描出来的都当成一个字符串放到临时变量中去。

  4. 碰到:符号,就要开始标记是个map的开始了,并把之后出现的字符串都存放到另一个临时变量中去。

  5. 碰到,符号,就要开始处理临时变量了,如果是map就把之前存的两个昨时变量,一个作为KEY,一个作为VALUE,都放到collections中对应的map中去,如果是list,则把之前存的第一个临时变量,放到collections对应的list中去。

  6. 碰到]或}符号,则表示一个list或map被解析完全了,则这时候要去更新index中的对应的list或map的状态了。

解析完了后,所有的数据都在collections index level这三个变量中了,于是,我们只需要定一个取数据的规则就行了,我用的是一种类似于xpath的语法格式来取值的,这时候只需要解析下这个xpath路径就可以得出这个key,然后在collections中拿值就可以了!


####使用方法

image

备注:上面的例子中,我们可以看到,类XPATH的路径支持绝对路径和相对路径,用*[]来表示一个list,[]里面放要获取的值在list中的index,比如/*[0]指获取list中的第1个值。用map的key来获取其对应的值!


####使用说明

Zson z = new Zson(); //new一个Zson对象

ZsonResult zr = z.parseJson(j); //解析JSON字符串后,得到一个ZsonResult对象
zr对象可用的方法:
Object getValue(String path) //返回一个除了List或Map的Object对象,如果是List或Map,会转换成为JSON字符串返回

Map<String, Object> getMap(String path) //返回一个Map对象

List<Object> getList(String path) //返回一个List对象

String toJsonString(Object obj) //将Map或List转换成为JSON字符串

####选择器path说明

示例一:

[
    {
        "firstName": "Eric",
        "lastName": "Clapton",
        "instrument": "guitar"
    },
    {
        "firstName": "Sergei",
        "lastName": "Rachmaninoff",
        "instrument": "piano"
    }
]
找出第二个firstName: /*[1]/firstName 
输出:Sergei

找出第一个Map: /*[0]  
输出:{"firstName": "Eric","lastName": "Clapton","instrument": "guitar"}

示例二:

{"a":["a"],"cb":{"a":1},"d":["a",{"a":[1,2]},{"a":2},""],"e":"b"}

路径: /d/*[1]/a 
输出:[1,2]

路径: /d/*[1]/a/*[0]
输出:1

####2016年4月16日更新日志

支持相对路径!
示例二中:
getValues()
zr.getValues("/a//*[0]"));//输出[a]
zr.getValues("//*[1]"));//输出[2]
说明:相对路径所得出来的值只显示非MAP或LIST的值,如果是MAP或LIST,则会被忽略!

####2016年6月16日更新日志

更加丰富的API:
String s1 = "[{ \"firstName\": \"Eric\", \"lastName\": \"Clapton\", \"instrument\": \"guitar\" },{ \"firstName\": \"Sergei\", \"lastName\": \"Rachmaninoff\", \"instrument\": \"piano\" }] ";
String s2 = "[0,1,2,3.14,4.00,\"3\",true,\"\"]";
String s3 = "{\"a\":[\"a1\"],\"cb\":{\"a\":1},\"d\":[\"a\",{\"a\":[1,20]},{\"a\":2},\"\"],\"e\":\"b\"}";
Zson z = new Zson();
ZsonResult zr1 = z.parseJson(s1);
System.out.println(zr1.getValue("/*[1]/firstName"));
System.out.println(zr1.getMap("/*[1]"));

ZsonResult zr2 = z.parseJson(s2);
System.out.println(zr2.getInteger("/*[1]"));
System.out.println(zr2.getLong("/*[2]"));
System.out.println(zr2.getDouble("/*[3]"));
System.out.println(zr2.getFloat("/*[4]"));
System.out.println(zr2.getString("/*[5]"));
System.out.println(zr2.getBoolean("/*[6]"));

ZsonResult zr3 = z.parseJson(s3);
System.out.println(zr3.getValues("//*[0]"));
System.out.println(zr3.getValues("//*[1]"));
System.out.println(zr3.getList("/a"));
System.out.println(zr3.getMap("/cb"));

####2016年6月28日更新日志

增加API:
removeValue(String path);
功能:移除JSON串中的某个map,list或值,path为绝对路径

getResult();
功能:返回解析完的整个数据对象

About

专为测试人员打造的JSON解析器

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages

  • Java 100.0%