Snack3 一个新的微型JSON框架

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

snack3。基于jdk860kb,无其它依赖,非常小巧。

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

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

设计思路

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

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

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

项目源码

Meven配置

  1. <dependency>
  2. <groupId>org.noear</groupId>
  3. <artifactId>snack3</artifactId>
  4. <version>3.1.5.12</version>
  5. </dependency>

一、简单的代码演示

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

二、更多代码演示

  • 1.字符串化
  1. //将 java object 转为 json
  2. String json = ONode.stringify(user);
  • 2.序列化
  1. //1.序列化(通过@type申明类型)
  2. String json = ONode.serialize(user);
  3. //2.反序列化
  4. UserModel user = ONode.deserialize(json, UserModel.class);
  • 3.转换
  1. //1.1.将json string 转为 ONode
  2. ONode o = ONode.load(json);
  3. //1.2.将java bean 转为 ONode
  4. ONode o = ONode.load(user);
  5. //2.1.将 ONode 转为 string(由转换器决定,默认转换器为json)
  6. o.toString();
  7. //2.2.将 ONode 转为 json
  8. o.toJson();
  9. //2.3.将 ONode 转为XxxModel (例:UserModel)
  10. o.toObject(UserModel.class);
  11. //>将 ONode 转为 Map 或 List 或 常规值
  12. o.toObject(null);
  13. //>将 ONode 转为 自动类型的 Java Object
  14. o.toObject(Object.class);
  • 4.填充
  1. ONode o = ONode.load("{code:1,msg:'Hello world!'}");
  2. //填充java object
  3. List<UserModel> list = new ArrayList<>();
  4. //...
  5. o.get("data").get("list").fill(list);
  6. //填充string json
  7. o.get("data").get("list").fill("[{a:1,b:2},{a:2,c:3}]");
  • 5.一个应用示例(极光推送的rest api调用)
  1. public static void push(Collection<String> alias_ary, String text) {
  2. ONode data = new ONode().build((d)->{
  3. d.get("platform").val("all");
  4. d.get("audience").get("alias").addAll(alias_ary);
  5. d.get("options")
  6. .set("apns_production",false);
  7. d.get("notification").build(n->{
  8. n.get("ios")
  9. .set("alert",text)
  10. .set("badge",0)
  11. .set("sound","happy");
  12. });
  13. });
  14. String message = data.toJson();
  15. String author = Base64Util.encode(appKey+":"+masterSecret);
  16. Map<String,String> headers = new HashMap<>();
  17. headers.put("Content-Type","application/json");
  18. headers.put("Authorization","Basic "+author);
  19. HttpUtil.postString(apiUrl, message, headers);
  20. }
  • 5.数据遍历
  1. //遍历Object数据 方案1
  2. o.forEach((k,v)->{
  3. //...
  4. });
  5. //遍历Object数据 方案2
  6. for(Map.Entry<String,ONode> kv : n.obj().entrySet()){
  7. //...
  8. }
  9. //遍历Array数据 方案1
  10. o.forEach((v)->{
  11. //...
  12. });
  13. //遍历Array数据 方案2
  14. for(ONode v : o.ary()){
  15. //..
  16. }

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

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

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

  • 关于json object的操作
  1. -obj() -> Map<String,ONode> //获取节点对象数据结构体(如果不是对象类型,会自动转换)
  2. -contains(key:String) -> bool //是否存在对象子节点?
  3. -get(key:String) -> child:ONode //获取对象子节点(不存在,生成新的子节点并返回)
  4. -getOrNull(key:String) -> child:ONode //获取对象子节点(不存在,返回null)
  5. -getNew(key:String) -> child:ONode //生成新的对象子节点,会清除之前的数据
  6. -set(key:String,val:Object) -> self:ONode //设置对象的子节点(会自动处理类型)//val:为常规类型或ONode
  7. -setNode(key:String,val:ONode) -> self:ONode //设置对象的子节点,值为ONode类型
  8. -setAll(obj:ONode) -> self:ONode //设置对象的子节点,将obj的子节点搬过来
  9. -setAll(map:Map<String,T>) ->self:ONode //设置对象的子节点,将map的成员搬过来
  10. -setAll(map:Map<String,T>, (n,t)->..) ->self:ONode //设置对象的子节点,将map的成员搬过来,并交由代理处置
  11. -remove(key:String) //移除对象的子节点
  12. -forEach((k,v)->..) //遍历对象的子节点
  • 关于json array的操作
  1. -ary() -> List<ONode> //获取节点数组数据结构体(如果不是数组,会自动转换)
  2. -get(index:int) -> child:ONode //获取数组子节点(超界,返回空节点)
  3. -getOrNull(index:int) -> child:ONode //获取数组子节点(超界,返回null)
  4. -addNew() -> child:ONode //生成新的数组子节点
  5. -add(val) -> self:ONode //添加数组子节点 //val:为常规类型或ONode
  6. -addNode(val:ONode) -> self:ONode //添加数组子节点,值为ONode类型
  7. -addAll(ary:ONode) -> self:ONode //添加数组子节点,将ary的子节点搬过来
  8. -addAll(ary:Collection<T>) -> self:ONode //添加数组子节点,将ary的成员点搬过来
  9. -addAll(ary:Collection<T>,(n,t)->..) -> self:ONode //添加数组子节点,将ary的成员点搬过来,并交由代理处置
  10. -removeAt(index:int) //移除数组的子节点
  11. -forEach(v->..) //遍历数组的子节点
  • 关于json value的操作
  1. -val() -> OValue //获取节点值数据结构体(如果不是值类型,会自动转换)
  2. -val(val:Object) -> self:ONode //设置节点值 //val:为常规类型或ONode
  3. -getString() //获取值并以string输出 //如果节点为对象或数组,则输出json
  4. -getShort() //获取值并以short输出...(以下同...)
  5. -getInt()
  6. -getBoolean()
  7. -getLong()
  8. -getDate()
  9. -getFloat()
  10. -getDouble()
  11. -getDouble(scale:int)
  12. -getChar()

关于序列化的特点

  • 对象
  1. {"@type":"...","a":1,"b":"2"}
  • 数组(可以精准反序列化列表类型;需要特性开启)
  1. [{"@type":"..."},[1,2,3]]

关于Json path的支持

  • 支持Json path的选择操作,不支持过滤操作。我称它为:Simple json path
支持操作 说明
$ 查询根元素(或当前元素)。
这将启动所有路径表达式(可以不输)。
* 通配符,必要时可用任何地方的名称或数字。
.. 深层扫描。 必要时在任何地方可以使用名称。
. 点,表示子节点
['' (, '')] 括号表示子项
[ (, )] 数组索引或索引
[start:end] 数组切片操作

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

附:完整的接口字典

  1. //初始化操作
  2. //
  3. -asObject() -> self:ONode //将节点切换为对象
  4. -asArray() -> self:ONode //将节点切换为数组
  5. -asValue() -> self:ONode //将节点切换为值
  6. -asNull() -> self:ONode //将节点切换为null
  7. //检测操作
  8. //
  9. -isObject() -> bool //检查节点是否为对象
  10. -isArray() -> bool //检查节点是否为数组
  11. -isValue() -> bool //检查节点是否为值
  12. -isNull() -> bool //检查节点是否为null
  13. //公共
  14. //
  15. -nodeData() -> ONodeData //获取节点数据
  16. -nodeType() -> ONodeType //获取节点类型
  17. -cfg(cfg:Constants) -> self:ONode //切换配置
  18. -cfg() -> Constants //获取配置
  19. -build(n->..) -> self:ONode //节点构建表达式
  20. -select(jpath:String) -> new:ONode //使用JsonPath表达式选择节点(默认缓存路径编译)
  21. -select(jpath:String, useStandard:boolean)-> new:ONode //useStandard:使用标准模式,默认非标准
  22. -select(jpath:String, useStandard:boolean, cacheJpath:boolean)-> new:ONode //cacheJpath:是否缓存javaPath编译成果,默认缓存
  23. -clear() //清除子节点,对象或数组有效
  24. -count() -> int //子节点数量,对象或数组有效
  25. //值操作
  26. //
  27. -val() -> OValue //获取节点值数据结构体(如果不是值类型,会自动转换)
  28. -val(val:Object) -> self:ONode //设置节点值 //val:为常规类型或ONode
  29. -getString() //获取值并以string输出 //如果节点为对象或数组,则输出json
  30. -getShort() //获取值并以short输出...(以下同...)
  31. -getInt()
  32. -getBoolean()
  33. -getLong()
  34. -getDate()
  35. -getFloat()
  36. -getDouble()
  37. -getDouble(scale:int)
  38. -getChar()
  39. //对象操作
  40. //
  41. -obj() -> Map<String,ONode> //获取节点对象数据结构体(如果不是对象类型,会自动转换)
  42. -readonly() -> self:ONode //只读形态(get时,不添加子节点)
  43. -contains(key:String) -> bool //是否存在对象子节点?
  44. -rename(key:String,newKey:String) -> self:ONode //重命名子节点并返回自己
  45. -get(key:String) -> child:ONode //获取对象子节点(不存在,生成新的子节点并返回)
  46. -getOrNull(key:String) -> child:ONode //获取对象子节点(不存在,返回null)
  47. -getNew(key:String) -> child:ONode //生成新的对象子节点,会清除之前的数据
  48. -set(key:String,val:Object) -> self:ONode //设置对象的子节点(会自动处理类型)
  49. -setNode(key:String,val:ONode) -> self:ONode //设置对象的子节点,值为ONode类型
  50. -setAll(obj:ONode) -> self:ONode //设置对象的子节点,将obj的子节点搬过来
  51. -setAll(map:Map<String,T>) ->self:ONode //设置对象的子节点,将map的成员搬过来
  52. -setAll(map:Map<String,T>, (n,t)->..) ->self:ONode //设置对象的子节点,将map的成员搬过来,并交由代理处置
  53. -remove(key:String) //移除对象的子节点
  54. -forEach((k,v)->..) -> self:ONode //遍历对象的子节点
  55. //数组操作
  56. //
  57. -ary() -> List<ONode> //获取节点数组数据结构体(如果不是数组,会自动转换)
  58. -get(index:int) -> child:ONode //获取数组子节点(超界,返回空节点)
  59. -getOrNull(index:int) -> child:ONode //获取数组子节点(超界,返回null)
  60. -addNew() -> child:ONode //生成新的数组子节点
  61. -add(val) -> self:ONode //添加数组子节点 //val:为常规类型或ONode
  62. -addNode(val:ONode) -> self:ONode //添加数组子节点,值为ONode类型
  63. -addAll(ary:ONode) -> self:ONode //添加数组子节点,将ary的子节点搬过来
  64. -addAll(ary:Collection<T>) -> self:ONode //添加数组子节点,将ary的成员点搬过来
  65. -addAll(ary:Collection<T>,(n,t)->..) -> self:ONode //添加数组子节点,将ary的成员点搬过来,并交由代理处置
  66. -removeAt(index:int) //移除数组的子节点
  67. -forEach(v->..) -> self:ONode //遍历数组的子节点
  68. //特性操作(不破坏数据的情况上,添加数据;或用于构建xml dom)
  69. //
  70. -attrGet(key:String) -> String //获取特性
  71. -attrSet(key:String,val:String) -> self:ONode //设置特性
  72. -attrForeach((k,v)->..) -> self:ONode //遍历特性
  73. //转换操作
  74. //
  75. -toString() -> String //转为string (由字符串转换器决定,默认为json)
  76. -toJson() -> String //转为json string
  77. -toData() -> Object //转为数据结构体(Map,List,Value)
  78. -toObject(clz:Class<T>) -> T //转为java object(clz=Object.class:自动输出类型)
  79. -to(toer:Toer, clz:Class<T>) -> T //将当前节点通过toer进行转换
  80. -to(toer:Toer) -> T //将当前节点通过toer进行转换
  81. //填充操作(为当前节点填充数据;source 为 String 或 java object)
  82. -fill(source:Object) -> self:ONode //填充数据
  83. -fill(source:Object, fromer:Fromer) -> self:ONode //填充数据,由fromer决定处理
  84. /**
  85. * 以下为静态操作
  86. **/
  87. //加载操作(source 为 String 或 java object)
  88. //
  89. +load(source:Object) -> new:ONode //加载数据
  90. +load(source:Object, cfg:Constants) -> new:ONode
  91. +load(source:Object, cfg:Constants, fromer:Fromer) -> new:ONode
  92. //加载 string
  93. +loadStr(source:String) -> new:ONode //仅String
  94. //加载 java object
  95. +loadObj(source:Object) -> new:ONode //仅java object
  96. //字符串化操作
  97. //
  98. +stringify(source:Object) -> String //字符串化;
  99. //序列化操作
  100. //
  101. +serialize(source:Object) -> String //序列化(带@type属性)
  102. +deserialize(source:String) -> T //反序列化
  103. +deserialize(source:String, clz:Class<?>) -> T //反序列化

评论关闭
IT干货网

微信公众号号:IT虾米 (左侧二维码扫一扫)欢迎添加!

浮点数计算精度丢失问题#W01