在鸿蒙中json函数怎么用

在鸿蒙系统中JSON函数的使用指南：轻松解析与生成JSON数据

在移动应用开发中,JSON（JavaScript Object Notation）作为一种轻量级的数据交换格式，因其易读性和灵活性被广泛使用，鸿蒙系统（HarmonyOS）提供了丰富的JSON处理能力，帮助开发者高效解析和生成JSON数据，本文将详细介绍鸿蒙系统中JSON函数的核心用法，包括JSON字符串与对象/数组的转换、数据解析、异常处理等关键场景，助力开发者快速上手。

鸿蒙JSON处理的核心模块：@ohos.data.json

鸿蒙系统通过@ohos.data.json模块提供JSON相关的核心API，支持将JSON字符串转换为JavaScript对象/数组（解析），以及将JavaScript对象/数组转换为JSON字符串（序列化），在使用前，需先导入该模块：

import data_json from '@ohos.data.json';

JSON字符串解析：将文本转为对象/数组

当需要从服务器、本地文件或用户输入中获取JSON格式数据时，需通过parse()方法将其转换为JavaScript对象或数组，以便进一步操作。

解析JSON对象

若JSON字符串表示一个键值对对象（如{"name":"张三", "age":30}），可通过parse()直接转换为JavaScript对象：

let jsonString = '{"name":"张三", "age":30, "isStudent":false}';
let jsonObj = data_json.parse(jsonString);
// 访问对象属性
console.log(jsonObj.name);    // 输出：张三
console.log(jsonObj.age);     // 输出：30
console.log(jsonObj.isStudent); // 输出：false

解析JSON数组

若JSON字符串表示数组（如[1, 2, "a", {"key":"value"}]），转换后可直接通过索引访问元素：

let jsonArrayString = '[1, 2, "a", {"city":"北京"}]';
let jsonArray = data_json.parse(jsonArrayString);
// 访问数组元素
console.log(jsonArray[0]);      // 输出：1
console.log(jsonArray[3].city); // 输出：北京

解析嵌套JSON

JSON支持复杂嵌套结构（对象内嵌套数组或数组内嵌套对象），parse()方法会自动处理层级关系：

let nestedJsonString = '{"user":{"name":"李四", "hobbies":["篮球", "阅读"]}, "score":95}';
let nestedObj = data_json.parse(nestedJsonString);
// 访问嵌套数据
console.log(nestedObj.user.name);        // 输出：李四
console.log(nestedObj.user.hobbies[1]);  // 输出：阅读
console.log(nestedObj.score);            // 输出：95

JSON序列化：将对象/数组转为字符串

当需要将JavaScript对象或数组通过网络发送、存储到本地或传递给其他组件时，需通过stringify()方法将其转换为JSON字符串。

序列化普通对象

将简单JavaScript对象转换为JSON字符串：

let userObj = {name:"王五", age:25, isDeveloper:true};
let jsonString = data_json.stringify(userObj);
console.log(jsonString); 
// 输出：{"name":"王五","age":25,"isDeveloper":true}

序列化数组

将JavaScript数组转换为JSON字符串,数组中的对象也会被自动序列化：

let arr = [1, "hello", {id:100, status:"ok"}];
let arrJsonString = data_json.stringify(arr);
console.log(arrJsonString); 
// 输出：[1,"hello",{"id":100,"status":"ok"}]

序列化嵌套结构

处理包含多层嵌套的对象或数组,stringify()会递归转换所有层级：

let nestedObj = {
    company:"华为",
    employees:[
        {name:"赵六", dept:"研发"},
        {name:"钱七", dept:"设计"}
    ]
};
let nestedJsonString = data_json.stringify(nestedObj);
console.log(nestedJsonString); 
// 输出：{"company":"华为","employees":[{"name":"赵六","dept":"研发"},{"name":"钱七","dept":"设计"}]}

格式化输出（缩进美化）

若希望JSON字符串格式更易读（如调试时输出），可通过第三个参数space指定缩进：

let userObj = {name:"孙八", age:28, hobbies:["coding", "travel"]};
let formattedJson = data_json.stringify(userObj, null, 2); // 缩进2个空格
console.log(formattedJson);
/* 输出：
{
  "name": "孙八",
  "age": 28,
  "hobbies": [
    "coding",
    "travel"
  ]
}
*/

异常处理：JSON解析的健壮性保障

JSON字符串格式错误（如缺少引号、逗号、括号不匹配等）会导致parse()抛出异常，开发时需通过try-catch捕获错误，避免应用崩溃：

let invalidJsonString = '{"name":"周九", age:30}'; // 属性名缺少引号，格式错误
try {
    let jsonObj = data_json.parse(invalidJsonString);
    console.log(jsonObj);
} catch (error) {
    console.error("JSON解析失败:", error.message); 
    // 输出：JSON解析失败: Unexpected token a in JSON at position 14（具体错误信息因场景而异）
    // 此处可提示用户或进行错误恢复逻辑
}

实战场景：网络数据解析与本地存储

结合鸿蒙的网络和存储能力,JSON函数在实际开发中常用于处理服务器数据和本地配置。

场景1：解析HTTP响应的JSON数据

假设通过鸿蒙的http模块获取服务器返回的用户列表数据（JSON格式），解析后显示在界面上：

import http from '@ohos.net.http';
// 模拟HTTP请求（实际开发中使用http模块发起请求）
let httpRequest = http.createHttp();
httpRequest.request("https://example.com/api/users", {
    method: http.RequestMethod.GET,
    header: {'Content-Type': 'application/json'}
}, (err, data) => {
    if (!err) {
        let responseJson = data.result.toString(); // 服务器返回的是JSON字符串
        try {
            let userList = data_json.parse(responseJson); // 解析为对象数组
            console.log("用户列表:", userList);
            // 将userList传递给UI组件显示（如List组件）
        } catch (parseError) {
            console.error("解析用户数据失败:", parseError);
        }
    }
});

场景2：将对象存储到本地偏好设置

鸿蒙的Preferences模块可存储键值对数据，若需存储复杂对象，可先通过stringify()转换为JSON字符串：

import data_preferences from '@ohos.data.preferences';
// 假设已获取preferences实例（通过context获取）
let preferences = ...; 
let appConfig = {theme:"dark", fontSize:16, notifications:true};
let configJson = data_json.stringify(appConfig); // 序列化为JSON字符串
// 存储到本地
preferences.put("appConfig", configJson).then(() => {
    preferences.flush(); // 提交异步操作
    console.log("配置存储成功");
});
// 读取时反向解析
preferences.get("appConfig", "").then((value) => {
    if (value) {
        let loadedConfig = data_json.parse(value); // 解析为对象
        console.log("加载的配置:", loadedConfig);
    }
});

注意事项

1. JSON格式规范：待解析的字符串必须严格符合JSON格式（属性名必须用双引号、字符串值需用双引号、不能有注释等），否则会抛出异常。
2. 循环引用：若JavaScript对象中存在循环引用（如对象A的某个属性指向对象A本身），stringify()会报错，需提前处理循环引用。
3. 特殊字符处理：stringify()会自动转义字符串中的特殊字符（如换行符、引号等），无需手动处理。

鸿蒙系统通过@ohos.data.json模块为开发者提供了简洁高效的JSON处理能力：parse()方法轻松实现JSON字符串到对象/数组的转换，stringify()方法则支持对象/数组的序列化输出，结合异常处理和实际应用场景（如网络数据解析、本地存储），开发者可以灵活应对JSON相关的开发需求，提升应用的数据交互效率，这些核心函数，是鸿蒙应用开发中处理结构化数据的重要基础。