无耳 Solon (OpenSolon) | snack4 - Json Dom 应用参考

1、Json 数据类型和概念定义

类型	描述	分类	备注与示例
Undefined	未定义	空类型	表示不存在，例：`new ONode()`
Null	null	/	表示存在但为null，例：`new ONode(null)`

Boolean	布尔	值类型	例：`new ONode(true)`
Number	数字	值类型	例：`new ONode(11)`
String	字符串	值类型	例：`new ONode("hello")`
Date	时间	值类型	例：`new ONode(new Date())`

Array	数组	数组类型	例：`new ONode().asArray()`
Object	对象	对象类型	例：`new ONode().asObject()`

Object 的子项，为 KeyValue 形态，可称为：“成员”
- 成员分为：键和值
Array 的子项，可成为：“元素”
- 元素也为：值

2、Json Dom 构建主要方法说明

对象类型的 get，getOrNew，getOrNull，set，setAll：

方法	描述	备注
`get(key)`	获取，如果不存在则构建个空节点	在上面做什么都白做，但不会异常
`getOrNew(key)`	获取，如果不存在则构建个新节点（并加到父节点）
`getOrNull(key)`	获取，如果不存在则返回 null

`set(key, val)`	添加成员	符合 Json 数据类型规范
`setAll(map)`	添加一批成员

使用对象类型的方法时，会自动尝试将 null 转为 object 类型。如果不是 null 且不是 object 类型，则会出现转换异常。null 除了自动转换外，还可使用 .asObject() 手动初始化类型。

数组类型的 get，getOrNew，getOrNull，add，addAll：

方法	描述	备注
`get(index)`	获取，如果不存在则构建个空节点
`getOrNew(index)`	获取，如果不存在则构建个新节点（并加到父节点）
`getOrNull(index)`	获取，如果不存在则返回 null

`add(item)`	添加元素	符合 Json 数据类型规范
`addAll(collection)`	添加一批元素

index 支持负数，表过倒着取（例：get(-1) 表示倒数第1个）。关于 null 类型自动转换规则与对象类型相同。

节点辅助操作 fill，fillJson，then 方法

方法	描述	备注
`fill(obj)`	用一个对象填充自己（完全替换掉）	无视类型，会自动编码
`fillJson(json)`	用一个 json string 填充自己（完全替换掉）

`then(slf->{})`	然后（进一步链式操作自己）

节点获取方法归类

方法	描述	对应检测方法	备注
`getArray()`	尝试获取数组（List）	`isArray()`	最好先检测，否则可能会异常
`getObject()`	尝试获取对象（Map）	`isObject()`	最好先检测，否则可能会异常

`getValue()`	尝试获取值（Object）	`isValue()`
`getValueAs()`	尝试获取值（T）		如果类型不对，泛型强转会异常

`getString()`	尝试获取值 String	`isString()`	会尝试自动转换
`getBoolean()`	尝试获取值 Boolean	`isBoolean()`	会尝试自动转换
`getDate()`	尝试获取值 Date	`isDate()`	会尝试自动转换

`getNumber()`	尝试获取值 Number	`isNumber()`	最好先检测，否则可能会异常
`getShort()`	尝试获取值 Short		会尝试自动转换
`getInt()`	尝试获取值 Integer		会尝试自动转换
`getLong()`	尝试获取值 Long		会尝试自动转换
`getFloat()`	尝试获取值 Float		会尝试自动转换
`getDouble()`	尝试获取值 Double		会尝试自动转换

		`isUndefined()`	是否未定义
		`isNull()`	是否为 null
		`isEmpty()`	是否为空（空数组，或空对象，或空字符串）

3、Json Dom 应用参考

参考1

ONode oNode = new ONode();
oNode.set("id", 1);
oNode.getOrNew("layout").then(o -> {
    o.addNew().set("title", "开始").set("type", "start");
    o.addNew().set("title", "结束").set("type", "end");
});

oNode.get("id").getInt();
oNode.get("layout").get(0).get("title").getString();

oNode.getOrNew("list").fillJson("[1,2,3,4,5,6]");

参考2

//构建推送消息
ONode data = new ONode().asObject();
data.set("platform","val");
data.getOrNew("audience").getOrNew("alias").addAll(alias_ary);
data.getOrNew("options").set("apns_production", false);
String message = data.toJson();


//或者....用链式表达式单行构建
public static void push(Collection<String> alias_ary, String text)  {
    ONode data = new ONode().then((d)->{
        d.set("platform", "all");

        d.getOrNew("audience").getOrNew("alias").addAll(alias_ary);

        d.getOrNew("options")
                .set("apns_production",false);

        d.getOrNew("notification").then(n->{
            n.getOrNew("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);
}

Solon v3.7.3

1、Json 数据类型和概念定义

2、Json Dom 构建主要方法说明

3、Json Dom 应用参考