HarmonyOS 使用 JSON解析与生成 的好处
一、轻量级与高效性
- 易于阅读和编写:JSON格式的数据易于人类阅读和编写,降低了数据处理的复杂性。
- 高效解析与生成:HarmonyOS的JSON解析库提供了一系列高效的函数和类,能够快速地将JSON字符串转换为JSON对象,或将JSON对象转换为JSON字符串,从而满足高效数据处理的需求。
二、灵活的数据模型
- 层次化和嵌套的数据组织:JSON允许数据以层次化和嵌套的方式组织,这使得它能够适应各种复杂的数据结构。
- 支持多种数据类型:JSON中的值可以是字符串、数字、布尔值、数组、对象或null,这种灵活性使得JSON能够表示多种类型的数据。
三、广泛的应用场景
- 跨平台数据交换:JSON作为一种通用的数据格式,可以在不同的操作系统、设备和编程语言之间进行数据交换,这使得HarmonyOS能够与其他系统或设备进行无缝的数据通信。
- 适用于多种应用:无论是前端开发、移动应用开发还是物联网设备,JSON都因其轻量级和易于处理的特点而被广泛应用。在HarmonyOS中,JSON同样被广泛应用于数据的传递和存储。
四、强大的数据处理能力
- 数据访问与修改:通过解析JSON对象,可以方便地访问和修改其中的数据,提高了数据处理的灵活性。
- 数据验证与校验:在JSON数据解析过程中,可以进行数据的验证和校验,确保接收到的数据符合预期的格式和规则,从而提高了数据的准确性和可靠性。
五、安全性与稳定性
- 符合安全标准:HarmonyOS的JSON解析库在设计和实现过程中遵循了相关的安全标准和规范,确保了数据处理的安全性。
- 稳定可靠:经过严格的测试和验证,HarmonyOS的JSON解析库具有高度的稳定性和可靠性,能够满足各种复杂应用场景的需求。
本模块实现了JSON文本的解析与生成功能:能够高效地将JSON格式的文本转换为相应的JavaScript对象或值,同时也支持将JavaScript对象序列化为标准的JSON字符串。
JSON解析与生成
1. JSON.parse ---- 解析JSON字符串
2. JSON.stringify ---- 转换为JSON字符串
3. JSON.has ---- 是否包含
4. JSON.remove ---- 删除
1. JSON.parse
parse(text: string, reviver?: Transformer, options?: ParseOptions): Object | null
用于解析JSON字符串生成对应ArkTS对象或null。
参数:
参数名 | 类型 | 必填 | 说明 |
---|---|---|---|
text | string | 是 | 有效的JSON字符串。 |
reviver | Transformer | 否 | 转换函数,传入该参数,可以用来修改解析生成的原始值。默认值是undefined。 |
options | ParseOptions | 否 | 解析的配置,传入该参数,可以用来控制解析生成的类型。默认值是undefined。 |
返回值:
类型 | 说明 |
---|---|
Object | null | 返回ArkTS对象或null。当入参是null时,返回null。 |
使用方式一:
传入有效的JSON字符串。
let jsonText = '{"name": "John", "age": 30, "city": "ChongQing"}';
let obj:object = JSON.parse(jsonText);
console.info((obj as object)?.["name"]); // 输出 John
输出:
输出结果:John
使用方式二:
转换函数,传入该参数,可以用来修改解析生成的原始值
function reviverFunc(key, value) {if (key === "age") {return value + 1;}return value;
}const jsonTextStr = '{"name": "John", "age": 30}';
let objRst:object = JSON.parse(jsonTextStr, reviverFunc);
console.info((objRst as object)?.["age"]); // 打印结果:31
输出:
输出结果:31
使用方式三:
解析的配置,传入该参数,可以用来控制解析生成的类型
let options: JSON.ParseOptions = {bigIntMode: JSON.BigIntMode.PARSE_AS_BIGINT,}let numberText = '{"largeNumber":11223344556677889911111}';let numberObj = JSON.parse(numberText,(key: string, value: string):Object | null => {if(key === "largeNumber"){console.info("password",value+"");return value;}return value;},options);console.info((numberObj as object)?.["largeNumber"]);// 打印结果: 11223344556677889911111
输出:
输出结果:11223344556677889911111
2. JSON.stringify
stringify(value: Object, replacer?: (number | string)[] | null, space?: string | number): string
该方法将一个ArkTS对象或数组转换为JSON字符串,对于容器支持线性容器转换,非线性的容器不支持。
参数:
参数名 | 类型 | 必填 | 说明 |
---|---|---|---|
value | Object | 是 | ArkTS对象或数组,对于容器支持线性容器转换,非线性的容器不支持。 |
replacer | number[] | string[] | null | 否 | 当参数是数组时,只有包含在这个数组中的属性名才会被序列化到最终的JSON字符串中;当参数为null或者未提供时,则对象所有的属性都会被序列化。默认值是undefined。 |
space | string | number | 否 | 指定缩进用的空格或字符串或空字符串,用于美化输出。当参数是数字时表示有多少个空格;当参数是字符串时,该字符串被当作空格;当参数没有提供时,将没有空格。默认值是空字符串。 |
返回值:
类型 | 说明 |
---|---|
string | 转换后的JSON字符串。 |
使用方式一:
ArkTS对象或数组,对于容器支持线性容器转换,非线性的容器不支持。
let arr = [1, 2];
let rstArrStr = JSON.stringify(exportObj, arr);
console.info(rstArrStr);
// 打印结果:"{"1":"John","2":30}"
输出:
输出结果:{"1":"John","2":30}
使用方式二:
当参数是数组时,只有包含在这个数组中的属性名才会被序列化到最终的JSON字符串中;当参数为null或者未提供时,则对象所有的属性都会被序列化
interface Person {name: string;age: number;city: string;}
let inputObj = {"name": "John", "age": 30, "city": "ChongQing"} as Person;
let rstStr = JSON.stringify(inputObj, ["name"]);
console.info("rstStr",rstStr);
// 打印结果:"{"name":"John"}"
输出:
输出结果:"{"name":"John"}"
使用方式三:
指定缩进用的空格或字符串或空字符串,用于美化输出。当参数是数字时表示有多少个空格;当参数是字符串时,该字符串被当作空格;当参数没有提供时,将没有空格
interface Person {name: string;age: number;city: string;}
let rstStrSpace = JSON.stringify(inputObj, ["name"], ' ');
console.info(rstStrSpace);
// 打印结果:
/*
"{"name": "John"
}"
*/let rstStrStar = JSON.stringify(inputObj, ["name"], '&&');
console.info(rstStrStar);
// 打印结果:
/*
"{
&&"name": "John"
}"
*/
3. JSON.has
has(obj: object, property: string): boolean
检查ArkTS对象是否包含某种属性,可用于JSON.parse解析JSON字符串之后的相关操作。has接口仅支持最外层为字典形式(即大括号而非中括号包围)的合法json串。
参数:
参数名 | 类型 | 必填 | 说明 |
---|---|---|---|
obj | object | 是 | ArkTS对象。 |
property | string | 是 | 属性名。 |
返回值:
类型 | 说明 |
---|---|
boolean | 返回ArkTS对象是否包含某种属性结果,true表示包含,false表示不包含。 |
使用方式:
const jsonText = '{"name": "John", "age": 30, "city": "ChongQing"}';
let inputObj = JSON.parse(jsonText);
let rstflag = JSON.has(inputObj, "name");
console.info("rstflag = " + rstflag);
// 打印结果:rstflag = true
输出:
输出结果:rstflag = true
4. JSON.remove
remove(obj: object, property: string): void
从ArkTS对象中删除某种属性,可用于JSON.parse解析JSON字符串之后的相关操作。remove接口仅支持最外层为字典形式(即大括号而非中括号包围)的合法json串。
参数:
参数名 | 类型 | 必填 | 说明 |
---|---|---|---|
obj | object | 是 | ArkTS对象。 |
property | string | 是 | 属性名。 |
使用方式:
const jsonText = '{"name": "John", "age": 30, "city": "ChongQing"}';
let inputObj = JSON.parse(jsonText);
JSON.remove(inputObj, "name");
let rstflag = JSON.has(inputObj, "name");
console.info("rstflag = " + rstflag);
// 打印结果:rstflag = false
输出:
输出结果:rstflag = false
还有其他问题 请参考官方文档
制作不易 点个关注再走吧。°(°¯᷄◠¯᷅°)°。