文档章节

Snack3 一个新的微型JSON框架

刘之西东
 刘之西东
发布于 2019/11/21 21:39
字数 1586
阅读 40
收藏 0

Snack3 一个新的微型JSON框架

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

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

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

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

设计思路

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

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

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

项目源码

Meven配置

<dependency>
  <groupId>org.noear</groupId>
  <artifactId>snack3</artifactId>
  <version>3.1.5.12</version>
</dependency>

一、简单的代码演示

  • 简单操控
//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<Integer> ary = n.get("data").get("list").toObject(ArrayList.class);
List<Integer> 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.设置列表里的一项值为12
n.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 转为 json
String 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 转为 ONode
ONode o = ONode.load(json); 

//1.2.将java bean 转为 ONode
ONode o = ONode.load(user); 

//2.1.将 ONode 转为 string(由转换器决定,默认转换器为json)
o.toString();

//2.2.将 ONode 转为 json
o.toJson();

//2.3.将 ONode 转为XxxModel (例:UserModel)
o.toObject(UserModel.class);

//>将 ONode 转为 Map 或 List 或 常规值
o.toObject(null);

//>将 ONode 转为 自动类型的 Java Object
o.toObject(Object.class);

  • 4.填充
ONode o = ONode.load("{code:1,msg:'Hello world!'}");

//填充java object
List<UserModel> list = new ArrayList<>();
//...
o.get("data").get("list").fill(list);

//填充string json
o.get("data").get("list").fill("[{a:1,b:2},{a:2,c:3}]");
  • 5.一个应用示例(极光推送的rest api调用)
public static void push(Collection<String> 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<String,String> headers = new HashMap<>();
    headers.put("Content-Type","application/json");
    headers.put("Authorization","Basic "+author);

    HttpUtil.postString(apiUrl, message, headers);
}
  • 5.数据遍历
//遍历Object数据 方案1
o.forEach((k,v)->{
  //...
});
//遍历Object数据 方案2
for(Map.Entry<String,ONode> kv : n.obj().entrySet()){
  //...    
}

//遍历Array数据 方案1
o.forEach((v)->{
  //...
});
//遍历Array数据 方案2
for(ONode v : o.ary()){
  //..
}

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

List<UserModel> 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<String,ONode>             //获取节点对象数据结构体(如果不是对象类型,会自动转换)
-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<String,T>) ->self:ONode             //设置对象的子节点,将map的成员搬过来
-setAll(map:Map<String,T>, (n,t)->..) ->self:ONode  //设置对象的子节点,将map的成员搬过来,并交由代理处置
-remove(key:String)     //移除对象的子节点
-forEach((k,v)->..)     //遍历对象的子节点
  • 关于json array的操作
-ary() -> List<ONode>                   //获取节点数组数据结构体(如果不是数组,会自动转换)
-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<T>) -> self:ONode                //添加数组子节点,将ary的成员点搬过来
-addAll(ary:Collection<T>,(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]]  

© 著作权归作者所有

刘之西东

刘之西东

粉丝 3
博文 28
码字总数 27523
作品 3
杭州
CTO(技术副总裁)
私信 提问
加载中

评论(0)

微型 ORM 框架 - Snack3

Snack3 for java 一个微型JSON框架 基于jdk8,70kb。有序列化反序列化、解析和转换、支持 Json path 查询。 <dependency><groupId>org.noear</groupId><artifactId>snack3</artifactId><vers......

刘之西东
2019/12/27
589
0
八年磨一剑,Python Web 框架 Flask 1.0 正式发布

Flask 1.0 已正式发布,Flask 是一个微型的 Python 开发的 Web 框架,最初构建于 2010 年,至今已发展 8 年。 示例代码: 更新亮点: 不再支持 Python 2.6 和 3.3 。 CLI 更加灵活。 如果安装...

王练
2018/04/27
7.5K
28
微型Java Web框架--pippo

它是一个开源(Apache许可证)微型Java Web框架,拥有最少的依赖,以及快速的学习曲线。 该项目的目标是创建一个微型的Web框架在Java中这应该是易于使用和破解。 其概念是不是新的 (灵感来自...

李三石
2014/11/09
905
0
『练手』手写一个独立Json算法 JsonHelper

背景: > 一直使用 Newtonsoft.Json.dll 也算挺稳定的。 > 但这个框架也挺闹心的: > 1、影响编译失败:https://www.cnblogs.com/zihuxinyu/archive/2013/05/06/3063181.html (我也经常遇到...

InkFx
2017/11/24
0
0
100个常用的 PHP 类库、资源和技巧小结

收集整理一些常用的PHP类库, 资源以及技巧. 以便在工作中迅速的查找所需... 学习资源 PHP相关的有参考价值的社区,博客,网站,文章,书籍,视频等资源 PHP网站(PHP Websites) PHP The Right Way ...

牛奋Debug
2017/10/26
154
0

没有更多内容

加载失败,请刷新页面

加载更多

java关键字 —— new、this、static

  java关键字,也叫保留字(50个),是java有特殊意义的标识符,不能用作参数名、变量名、方法名、类名、包名等。   现在我们讲讲其中三个关键字的使用吧~~~ 一、new关键字 1. 用途:新建...

osc_s2b5kacl
21分钟前
15
0
java 集合框架的工具类Collections

sort(),max(),binarySearch(),fill() public class CollectionsDemo { public static void main(String[] args) { replaceAllDemo(); } public static void replaceAll......

osc_r9yyhhqz
22分钟前
25
0
创龙基于Xilinx Kintex-7系列高性价比FPGA开发板散热风扇接口、SATA接口

处理器 Xilinx Kintex-7系列FPGA处理器,芯片型号为XC7K325T-2FFG676I,兼容XC7K160T/410T-2FFG676I,高达326K逻辑单元,840个DSP Slice,硬件如下图: 散热风扇接口 开发板引出1个散热风扇接...

Tronlong创龙
23分钟前
27
0
【经验分享】学习Java的好书有哪些?Java书籍清单

Java书籍是程序员学习提升技能的重要学习渠道,通过书籍Java程序员可以学习当前流行、重要的相关技能。经典的书经受时间的考验,随着岁月的流逝变得越来越重要,让我们不断的学习和进步。 为...

osc_b1kaj6np
23分钟前
22
0
java Collections的reverseOrder(),SynList()

Collections的reverseOrder(比较器)返回相反的比较器,可以逆转比较器。 SynList()可以让非同步变成同步,底层实现synchronized(){}。 swap交换元素位置。 Collections.shuffle()随机重新排序...

osc_2gkfj43j
24分钟前
27
0

没有更多内容

加载失败,请刷新页面

加载更多

返回顶部
顶部