本文共 9595 字，大约阅读时间需要 31 分钟。

Snack3 一个新的微型JSON框架

一个作品，一般表达作者的一个想法。因为大家想法不同，所有作品会有区别。就做技术而言，因为有很多有区别的框架，所以大家可以选择的框架很丰富。

snack3。基于jdk8，60kb，无其它依赖，非常小巧。

• 强调文档树的链式操控和构建能力
• 强调中间媒体，方便不同格式互转
• 支持序列化、反序列化
• 支持Json path查询

ONode 即 One node 之意；借签了 Javascript 所有变量由 var 申明，及 Xml dom 一切都是 Node 的设计。这应该也是与别的框架不同之处。

设计思路

• ONode是一个接口界面，内部由nodeType和nodeData组成。通过nodeType进行类型识别，通过nodeData容纳所有的类型数据。

• 采用Fromer->ONode->Toer的架构设计。这是重要的一个设计，可使转换具有很强的扩展能力，Fromer 和 Toer 各做一半工作，也可各自切换（有好处也会有坏处）。

• 强调非null操作，通过o.isNull()进行判断（留意后面-get(key | idx)接口的注释；可通过getOrNull(key | idx) 获取 null ）

项目源码

• github：
• gitee：

Meven配置

     
    
     org.noear
      
    
     snack3
      
    
     3.1.8
    
   

一、简单的代码演示

• 简单操控

//1.加载json// name支持没有引号// 字符串支持单引号（在java里写代码方便点；输出是标准的引号）ONode n = ONode.load("{code:1,msg:'Hello world',data:{list:[1,2,3,4,5]}}");//2.1.取一个属性的值String msg = n.get("msg").getString();//2.2.取列表里的一项int li2  = n.get("data").get("list").get(2).getInt();int li2  = n.select("data.list[2]").getInt(); //使用josn path //2.3.获取一个数组List
   
     ary = n.get("data").get("list").toObject(ArrayList.class);List
    
      ary = n.select("data.list").toObject(ArrayList.class); //使用josn path //3.1.设置值n.set("msg","Hello world2");n.get("msg").val("Hello world2"); //另一种设置方式//3.2.设置列表里的一项值为12n.get("data").get("list").get(2).val(12);n.select("data.list[2]").val(12); //使用josn path //3.3.清掉一个数组n.get("data").get("list").clear();n.select("data.list").clear(); //使用josn path
    
   

二、更多代码演示

• 1.字符串化

//将 java object 转为 jsonString json = ONode.stringify(user);

• 2.序列化

//1.序列化（通过@type申明类型）String json = ONode.serialize(user);//2.反序列化UserModel user = ONode.deserialize(json, UserModel.class);

• 3.转换

//1.1.将json string 转为 ONodeONode o = ONode.load(json); //1.2.将java bean 转为 ONodeONode o = ONode.load(user); //2.1.将 ONode 转为 string（由转换器决定，默认转换器为json）o.toString();//2.2.将 ONode 转为 jsono.toJson();//2.3.将 ONode 转为XxxModel (例：UserModel)o.toObject(UserModel.class);//>将 ONode 转为 Map 或 List 或 常规值o.toObject(null);//>将 ONode 转为 自动类型的 Java Objecto.toObject(Object.class);

• 4.填充

ONode o = ONode.load("{code:1,msg:'Hello world!'}");//填充java objectList
   
     list = new ArrayList<>();//...o.get("data").get("list").fill(list);//填充string jsono.get("data").get("list").fill("[{a:1,b:2},{a:2,c:3}]");
   

• 5.一个应用示例（极光推送的rest api调用）

public static void push(Collection
   
     alias_ary, String text)  {    ONode data = new ONode().build((d)->{        d.get("platform").val("all");        d.get("audience").get("alias").addAll(alias_ary);        d.get("options")                .set("apns_production",false);        d.get("notification").build(n->{            n.get("ios")                    .set("alert",text)                    .set("badge",0)                    .set("sound","happy");        });    });    String message = data.toJson();    String author = Base64Util.encode(appKey+":"+masterSecret);    Map
    
      headers = new HashMap<>();    headers.put("Content-Type","application/json");    headers.put("Authorization","Basic "+author);    HttpUtil.postString(apiUrl, message, headers);}
    
   

• 5.数据遍历

//遍历Object数据 方案1o.forEach((k,v)->{  //...});//遍历Object数据 方案2for(Map.Entry
   
     kv : n.obj().entrySet()){  //...    }//遍历Array数据 方案1o.forEach((v)->{  //...});//遍历Array数据 方案2for(ONode v : o.ary()){  //..}
   

三、混合加载与转换代码演示

List
   
     list = new ArrayList<>();//..ONode o = ONode.load("{code:1,msg:'succeed'}");o.get("data").get("list").fill(list);
   

关于三组类型接口的设计（Json object,array,value）

• 关于json object的操作

-obj() -> Map
   
                 //获取节点对象数据结构体（如果不是对象类型，会自动转换）-contains(key:String) -> bool           //是否存在对象子节点?-get(key:String) -> child:ONode         //获取对象子节点（不存在，生成新的子节点并返回）-getOrNull(key:String) -> child:ONode   //获取对象子节点（不存在，返回null）-getNew(key:String) -> child:ONode      //生成新的对象子节点，会清除之前的数据-set(key:String,val:Object) -> self:ONode           //设置对象的子节点（会自动处理类型）//val:为常规类型或ONode-setNode(key:String,val:ONode) -> self:ONode        //设置对象的子节点，值为ONode类型-setAll(obj:ONode) -> self:ONode                    //设置对象的子节点，将obj的子节点搬过来-setAll(map:Map
    
     ) ->self:ONode             //设置对象的子节点，将map的成员搬过来-setAll(map:Map
     
      , (n,t)->..) ->self:ONode  //设置对象的子节点，将map的成员搬过来，并交由代理处置-remove(key:String)     //移除对象的子节点-forEach((k,v)->..)     //遍历对象的子节点
     
    
   

• 关于json array的操作

-ary() -> List
   
                       //获取节点数组数据结构体（如果不是数组，会自动转换）-get(index:int)  -> child:ONode                 //获取数组子节点（超界，返回空节点）-getOrNull(index:int)  -> child:ONode           //获取数组子节点（超界，返回null）-addNew() -> child:ONode                        //生成新的数组子节点-add(val) -> self:ONode                         //添加数组子节点 //val:为常规类型或ONode-addNode(val:ONode) -> self:ONode               //添加数组子节点，值为ONode类型-addAll(ary:ONode)  -> self:ONode               //添加数组子节点，将ary的子节点搬过来-addAll(ary:Collection
    
     ) -> self:ONode                //添加数组子节点，将ary的成员点搬过来-addAll(ary:Collection
     
      ,(n,t)->..) -> self:ONode      //添加数组子节点，将ary的成员点搬过来，并交由代理处置-removeAt(index:int)    //移除数组的子节点-forEach(v->..)         //遍历数组的子节点
     
    
   

• 关于json value的操作

-val() -> OValue                //获取节点值数据结构体（如果不是值类型，会自动转换）-val(val:Object) -> self:ONode  //设置节点值 //val:为常规类型或ONode-getString()    //获取值并以string输出 //如果节点为对象或数组，则输出json-getShort()     //获取值并以short输出...(以下同...)-getInt()-getBoolean()-getLong()-getDate()-getFloat()-getDouble()-getDouble(scale:int)-getChar()

关于序列化的特点

• 对象

{"@type":"...","a":1,"b":"2"}

• 数组（可以精准反序列化列表类型；需要特性开启）

[{"@type":"..."},[1,2,3]]

关于Json path的支持

• 支持完整的Json path的选择操作

例：n.select("$.store.book[0].title") 或 n.select("$['store']['book'][0]['title']")

附：完整的接口字典

//初始化操作//-asObject() -> self:ONode  //将节点切换为对象-asArray()  -> self:ONode  //将节点切换为数组-asValue()  -> self:ONode  //将节点切换为值-asNull()   -> self:ONode  //将节点切换为null//检测操作//-isObject() -> bool  //检查节点是否为对象-isArray()  -> bool  //检查节点是否为数组-isValue()  -> bool  //检查节点是否为值-isNull()   -> bool  //检查节点是否为null//公共//-nodeData() -> ONodeData //获取节点数据-nodeType() -> ONodeType //获取节点类型-cfg(cfg:Constants) -> self:ONode   //切换配置-cfg() -> Constants 				//获取配置-build(n->..) -> self:ONode     	//节点构建表达式-select(jpath:String) -> new:ONode 	                    //使用JsonPath表达式选择节点（默认缓存路径编译）-select(jpath:String, useStandard:boolean)-> new:ONode  //useStandard:使用标准模式,默认非标准-select(jpath:String, useStandard:boolean, cacheJpath:boolean)-> new:ONode   //cacheJpath:是否缓存javaPath编译成果，默认缓存-clear()        //清除子节点，对象或数组有效-count() -> int //子节点数量，对象或数组有效//值操作//-val() -> OValue                //获取节点值数据结构体（如果不是值类型，会自动转换）-val(val:Object) -> self:ONode  //设置节点值 //val:为常规类型或ONode-getString()    //获取值并以string输出 //如果节点为对象或数组，则输出json-getShort()     //获取值并以short输出...(以下同...)-getInt()-getBoolean()-getLong()-getDate()-getFloat()-getDouble()-getDouble(scale:int)-getChar()//对象操作//-obj() -> Map
   
                         //获取节点对象数据结构体（如果不是对象类型，会自动转换）-readonly() -> self:ONode                       //只读形态（get时，不添加子节点）-contains(key:String) -> bool                   //是否存在对象子节点?-rename(key:String,newKey:String) -> self:ONode //重命名子节点并返回自己-get(key:String) -> child:ONode                 //获取对象子节点（不存在，生成新的子节点并返回）-getOrNull(key:String) -> child:ONode           //获取对象子节点（不存在，返回null）-getNew(key:String) -> child:ONode              //生成新的对象子节点，会清除之前的数据-set(key:String,val:Object) -> self:ONode           //设置对象的子节点（会自动处理类型）-setNode(key:String,val:ONode) -> self:ONode        //设置对象的子节点，值为ONode类型-setAll(obj:ONode) -> self:ONode                    //设置对象的子节点，将obj的子节点搬过来-setAll(map:Map
    
     ) ->self:ONode             //设置对象的子节点，将map的成员搬过来-setAll(map:Map
     
      , (n,t)->..) ->self:ONode  //设置对象的子节点，将map的成员搬过来，并交由代理处置-remove(key:String)                   //移除对象的子节点-forEach((k,v)->..) -> self:ONode     //遍历对象的子节点//数组操作//-ary() -> List
      
                          //获取节点数组数据结构体（如果不是数组，会自动转换）-get(index:int)  -> child:ONode                 //获取数组子节点（超界，返回空节点）-getOrNull(index:int)  -> child:ONode           //获取数组子节点（超界，返回null）-addNew() -> child:ONode                        //生成新的数组子节点-add(val) -> self:ONode                         //添加数组子节点 //val:为常规类型或ONode-addNode(val:ONode) -> self:ONode               //添加数组子节点，值为ONode类型-addAll(ary:ONode)  -> self:ONode               //添加数组子节点，将ary的子节点搬过来-addAll(ary:Collection
       
        ) -> self:ONode                //添加数组子节点，将ary的成员点搬过来-addAll(ary:Collection
        
         ,(n,t)->..) -> self:ONode //添加数组子节点，将ary的成员点搬过来，并交由代理处置-removeAt(index:int) //移除数组的子节点-forEach(v->..) -> self:ONode //遍历数组的子节点//特性操作（不破坏数据的情况上，添加数据；或用于构建xml dom）//-attrGet(key:String) -> String //获取特性-attrSet(key:String,val:String) -> self:ONode //设置特性-attrForeach((k,v)->..) -> self:ONode //遍历特性//转换操作//-toString() -> String //转为string （由字符串转换器决定，默认为json）-toJson() -> String //转为json string-toData() -> Object //转为数据结构体（Map,List,Value）-toObject(clz:Class
         
          ) -> T //转为java object（clz=Object.class：自动输出类型）-to(toer:Toer, clz:Class
          
           ) -> T //将当前节点通过toer进行转换-to(toer:Toer) -> T //将当前节点通过toer进行转换//填充操作（为当前节点填充数据；source 为 String 或 java object）-fill(source:Object) -> self:ONode //填充数据-fill(source:Object, fromer:Fromer) -> self:ONode //填充数据，由fromer决定处理/** * 以下为静态操作**///加载操作（source 为 String 或 java object）//+load(source:Object) -> new:ONode //加载数据+load(source:Object, cfg:Constants) -> new:ONode+load(source:Object, cfg:Constants, fromer:Fromer) -> new:ONode//加载 string+loadStr(source:String) -> new:ONode //仅String//加载 java object+loadObj(source:Object) -> new:ONode //仅java object//字符串化操作//+stringify(source:Object) -> String //字符串化；//序列化操作//+serialize(source:Object) -> String //序列化（带@type属性）+deserialize(source:String) -> T //反序列化+deserialize(source:String, clz:Class
           ) -> T //反序列化