Snack3 一个新的微型JSON框架
2019-12-11 14:55
1221 查看
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配置
<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]]
关于Json path的支持
- 支持完整的
Json path
的选择操作
支持操作 | 说明 |
---|---|
$ | 查询根元素(或当前元素)。 这将启动所有路径表达式(可以不输)。 |
* | 通配符,必要时可用任何地方的名称或数字。 |
.. | 深层扫描。 必要时在任何地方可以使用名称。 |
. | 点,表示子节点 |
['' (, '')] | 括号表示子项 |
[ (, )] | 数组索引或索引 |
[start:end] | 数组切片操作 |
例:
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<String,ONode> //获取节点对象数据结构体(如果不是对象类型,会自动转换) -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<String,T>) ->self:ONode //设置对象的子节点,将map的成员搬过来 -setAll(map:Map<String,T>, (n,t)->..) ->self:ONode //设置对象的子节点,将map的成员搬过来,并交由代理处置 -remove(key:String) //移除对象的子节点 -forEach((k,v)->..) -> self:ONode //遍历对象的子节点 //数组操作 // -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->..) -> 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>) -> T //转为java object(clz=Object.class:自动输出类型) -to(toer:Toer, clz:Class<T>) -> 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 //反序列化
相关文章推荐
- Python微型web开发框架flask介绍及一个小例子
- Flask 一个Python的微型WEB开发框架
- php实现的一个简单json rpc框架实例
- Comet4J(Comet for Java)是一个纯粹基于AJAX(XMLHTTPRequest)的服务器推送框架,消息以JSON方式传递
- dotweb——go语言的一个微型web框架(一)
- dotweb——go语言的一个微型web框架(二)启动dotweb
- Flask 详细介绍 Flask 是一个微型的 Python 开发的 Web 框架,基于Werkzeug WSGI工具箱和Jinja2 模板引擎。 Flask使用BSD授权。 Flask也被称为“mi
- dotweb——go语言的一个微型web框架(三)路由注册
- 使用ASIRequest框架 封装一个专门用于数据json串获取的类
- django框架-写一个接口返回json
- JSON 超级快速入门 完 搭建一个超级不规范的REST框架
- 如何解决jersey框架中以json格式返回数组,当数组中元素一个时json格式不对
- Comet4J(Comet for Java)是一个纯粹基于AJAX(XMLHTTPRequest)的服务器推送框架,消息以JSON方式传递,具备长轮询、长连接、自动选择三种工作模式。
- [Android]打造一个Android通用的JSON数据解析框架
- php实现的一个简单json rpc框架实例
- 如何解决jersey框架中以json格式返回数组,当数组中元素一个时json格式不对
- 动手实现一个简单的java web框架
- 推荐一个国产简洁易用前段框架
- 分享一个免费的离线JS版本的JSON数据树形查看器
- 微型发布系统:Android+FastJSON+PHP