zoukankan      html  css  js  c++  java

  • Snack3 一个新的微型JSON框架

    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 ）

    项目源码

    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]}}");
    6. //2.1.取一个属性的值
    7. String msg = n.get("msg").getString();
    9. //2.2.取列表里的一项
    10. int li2 = n.get("data").get("list").get(2).getInt();
    11. int li2 = n.select("data.list[2]").getInt(); //使用josn path
    13. //2.3.获取一个数组
    14. List<Integer> ary = n.get("data").get("list").toObject(ArrayList.class);
    15. List<Integer> ary = n.select("data.list").toObject(ArrayList.class); //使用josn path
    17. //3.1.设置值
    18. n.set("msg","Hello world2");
    19. n.get("msg").val("Hello world2"); //另一种设置方式
    21. //3.2.设置列表里的一项值为12
    22. n.get("data").get("list").get(2).val(12);
    23. n.select("data.list[2]").val(12); //使用josn path
    25. //3.3.清掉一个数组
    26. n.get("data").get("list").clear();
    27. 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);
    4. //2.反序列化
    5. UserModel user = ONode.deserialize(json, UserModel.class);
    • 3.转换
    1. //1.1.将json string 转为 ONode
    2. ONode o = ONode.load(json);
    4. //1.2.将java bean 转为 ONode
    5. ONode o = ONode.load(user);
    7. //2.1.将 ONode 转为 string（由转换器决定，默认转换器为json）
    8. o.toString();
    10. //2.2.将 ONode 转为 json
    11. o.toJson();
    13. //2.3.将 ONode 转为XxxModel (例：UserModel)
    14. o.toObject(UserModel.class);
    16. //>将 ONode 转为 Map 或 List 或 常规值
    17. o.toObject(null);
    19. //>将 ONode 转为 自动类型的 Java Object
    20. o.toObject(Object.class);
    • 4.填充
    1. ONode o = ONode.load("{code:1,msg:'Hello world!'}");
    3. //填充java object
    4. List<UserModel> list = new ArrayList<>();
    5. //...
    6. o.get("data").get("list").fill(list);
    8. //填充string json
    9. 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");
    5. d.get("audience").get("alias").addAll(alias_ary);
    7. d.get("options")
    8. .set("apns_production",false);
    10. d.get("notification").build(n->{
    11. n.get("ios")
    12. .set("alert",text)
    13. .set("badge",0)
    14. .set("sound","happy");
    15. });
    16. });
    18. String message = data.toJson();
    19. String author = Base64Util.encode(appKey+":"+masterSecret);
    21. Map<String,String> headers = new HashMap<>();
    22. headers.put("Content-Type","application/json");
    23. headers.put("Authorization","Basic "+author);
    25. HttpUtil.postString(apiUrl, message, headers);
    26. }
    • 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. }
    10. //遍历Array数据 方案1
    11. o.forEach((v)->{
    12. //...
    13. });
    14. //遍历Array数据 方案2
    15. for(ONode v : o.ary()){
    16. //..
    17. }

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

    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
    8. //检测操作
    9. //
    10. -isObject() -> bool //检查节点是否为对象
    11. -isArray() -> bool //检查节点是否为数组
    12. -isValue() -> bool //检查节点是否为值
    13. -isNull() -> bool //检查节点是否为null
    15. //公共
    16. //
    17. -nodeData() -> ONodeData //获取节点数据
    18. -nodeType() -> ONodeType //获取节点类型
    20. -cfg(cfg:Constants) -> self:ONode //切换配置
    21. -cfg() -> Constants //获取配置
    23. -build(n->..) -> self:ONode //节点构建表达式
    24. -select(jpath:String) -> new:ONode //使用JsonPath表达式选择节点（默认缓存路径编译）
    25. -select(jpath:String, useStandard:boolean)-> new:ONode //useStandard:使用标准模式,默认非标准
    26. -select(jpath:String, useStandard:boolean, cacheJpath:boolean)-> new:ONode //cacheJpath:是否缓存javaPath编译成果，默认缓存
    28. -clear() //清除子节点，对象或数组有效
    29. -count() -> int //子节点数量，对象或数组有效
    31. //值操作
    32. //
    33. -val() -> OValue //获取节点值数据结构体（如果不是值类型，会自动转换）
    34. -val(val:Object) -> self:ONode //设置节点值 //val:为常规类型或ONode
    35. -getString() //获取值并以string输出 //如果节点为对象或数组，则输出json
    36. -getShort() //获取值并以short输出...(以下同...)
    37. -getInt()
    38. -getBoolean()
    39. -getLong()
    40. -getDate()
    41. -getFloat()
    42. -getDouble()
    43. -getDouble(scale:int)
    44. -getChar()
    46. //对象操作
    47. //
    48. -obj() -> Map<String,ONode> //获取节点对象数据结构体（如果不是对象类型，会自动转换）
    49. -readonly() -> self:ONode //只读形态（get时，不添加子节点）
    50. -contains(key:String) -> bool //是否存在对象子节点?
    51. -rename(key:String,newKey:String) -> self:ONode //重命名子节点并返回自己
    52. -get(key:String) -> child:ONode //获取对象子节点（不存在，生成新的子节点并返回）
    53. -getOrNull(key:String) -> child:ONode //获取对象子节点（不存在，返回null）
    54. -getNew(key:String) -> child:ONode //生成新的对象子节点，会清除之前的数据
    55. -set(key:String,val:Object) -> self:ONode //设置对象的子节点（会自动处理类型）
    56. -setNode(key:String,val:ONode) -> self:ONode //设置对象的子节点，值为ONode类型
    57. -setAll(obj:ONode) -> self:ONode //设置对象的子节点，将obj的子节点搬过来
    58. -setAll(map:Map<String,T>) ->self:ONode //设置对象的子节点，将map的成员搬过来
    59. -setAll(map:Map<String,T>, (n,t)->..) ->self:ONode //设置对象的子节点，将map的成员搬过来，并交由代理处置
    60. -remove(key:String) //移除对象的子节点
    61. -forEach((k,v)->..) -> self:ONode //遍历对象的子节点
    63. //数组操作
    64. //
    65. -ary() -> List<ONode> //获取节点数组数据结构体（如果不是数组，会自动转换）
    66. -get(index:int) -> child:ONode //获取数组子节点（超界，返回空节点）
    67. -getOrNull(index:int) -> child:ONode //获取数组子节点（超界，返回null）
    68. -addNew() -> child:ONode //生成新的数组子节点
    69. -add(val) -> self:ONode //添加数组子节点 //val:为常规类型或ONode
    70. -addNode(val:ONode) -> self:ONode //添加数组子节点，值为ONode类型
    71. -addAll(ary:ONode) -> self:ONode //添加数组子节点，将ary的子节点搬过来
    72. -addAll(ary:Collection<T>) -> self:ONode //添加数组子节点，将ary的成员点搬过来
    73. -addAll(ary:Collection<T>,(n,t)->..) -> self:ONode //添加数组子节点，将ary的成员点搬过来，并交由代理处置
    74. -removeAt(index:int) //移除数组的子节点
    75. -forEach(v->..) -> self:ONode //遍历数组的子节点
    77. //特性操作（不破坏数据的情况上，添加数据；或用于构建xml dom）
    78. //
    79. -attrGet(key:String) -> String //获取特性
    80. -attrSet(key:String,val:String) -> self:ONode //设置特性
    81. -attrForeach((k,v)->..) -> self:ONode //遍历特性
    83. //转换操作
    84. //
    85. -toString() -> String //转为string （由字符串转换器决定，默认为json）
    86. -toJson() -> String //转为json string
    87. -toData() -> Object //转为数据结构体（Map,List,Value）
    88. -toObject(clz:Class<T>) -> T //转为java object（clz=Object.class：自动输出类型）
    90. -to(toer:Toer, clz:Class<T>) -> T //将当前节点通过toer进行转换
    91. -to(toer:Toer) -> T //将当前节点通过toer进行转换
    93. //填充操作（为当前节点填充数据；source 为 String 或 java object）
    94. -fill(source:Object) -> self:ONode //填充数据
    95. -fill(source:Object, fromer:Fromer) -> self:ONode //填充数据，由fromer决定处理
    97. /**
    98. * 以下为静态操作
    99. **/
    101. //加载操作（source 为 String 或 java object）
    102. //
    103. +load(source:Object) -> new:ONode //加载数据
    104. +load(source:Object, cfg:Constants) -> new:ONode
    105. +load(source:Object, cfg:Constants, fromer:Fromer) -> new:ONode
    107. //加载 string
    108. +loadStr(source:String) -> new:ONode //仅String
    109. //加载 java object
    110. +loadObj(source:Object) -> new:ONode //仅java object
    112. //字符串化操作
    113. //
    114. +stringify(source:Object) -> String //字符串化；
    116. //序列化操作
    117. //
    118. +serialize(source:Object) -> String //序列化（带@type属性）
    119. +deserialize(source:String) -> T //反序列化
    120. +deserialize(source:String, clz:Class<?>) -> T //反序列化
  • 相关阅读:
    生成函数学习笔记
    CF1437F Emotional Fishermen
    BZOJ 1443 [JSOI2009]游戏Game
    BZOJ 1018 [SHOI2008]堵塞的交通traffic
    访问量破1000之记录
    BZOJ 1022 [SHOI2008]小约翰的游戏John
    BZOJ1457 棋盘游戏
    BZOJ1874: [BeiJing2009 WinterCamp]取石子游戏
    BZOJ 1188 [HNOI2007]分裂游戏
    Codeforces Round #345 (Div. 2)
  • 原文地址：https://www.cnblogs.com/zgq123456/p/12695757.html
Copyright © 2011-2022 走看看