概述dart:convert是Dart标准库的核心模块之一提供了JSON编码和解码的完整功能。在Flutter开发中特别是在鸿蒙平台上进行数据交换时dart:convert是处理JSON数据的基础工具。本文将深入探讨dart:convert库的核心API、高级用法和性能优化技巧。1. dart:convert库简介dart:convert库提供了多种数据转换功能其中与JSON相关的主要包括json.encode() / jsonEncode()将Dart对象编码为JSON字符串json.decode() / jsonDecode()将JSON字符串解码为Dart对象JsonEncoder自定义JSON编码器JsonDecoder自定义JSON解码器JsonCodecJSON编解码器组合1.1 导入方式importdart:convert;2. 核心API详解2.1 jsonDecode() - 解码JSON字符串StringjsonString{city: 北京, temperature: 28};MapString,dynamicdatajsonDecode(jsonString);参数说明sourceJSON字符串reviver可选转换函数用于修改解码过程中的值返回值MapString, dynamic或Listdynamic基础类型String、int、double、bool、null2.2 jsonEncode() - 编码为JSON字符串MapString,dynamicdata{city:北京,temperature:28,};StringjsonStringjsonEncode(data);参数说明object要编码的Dart对象toEncodable可选转换函数处理无法直接编码的对象2.3 json.decode() 与 jsonDecode() 的区别两者功能相同但命名风格不同// 旧风格不推荐MapString,dynamicdatajson.decode(jsonString);// 新风格推荐MapString,dynamicdatajsonDecode(jsonString);3. 高级用法3.1 使用JsonEncoder自定义编码JsonEncoderencoderJsonEncoder.withIndent( );StringprettyJsonencoder.convert({city:北京,temperature:28,});常用构造函数构造函数说明JsonEncoder()默认编码器JsonEncoder.withIndent(indent)带缩进的编码器JsonEncoder(toEncodable)自定义转换函数3.2 使用JsonDecoder自定义解码JsonDecoderdecoderJsonDecoder();dynamicdatadecoder.convert(jsonString);3.3 使用reviver函数修改解码结果MapString,dynamicdatajsonDecode(jsonString,(key,value){if(keytemperature){return(valueasnum).toDouble();}returnvalue;},);3.4 使用toEncodable处理自定义对象classWeather{finalStringcity;finalint temperature;Weather({requiredthis.city,requiredthis.temperature});}WeatherweatherWeather(city:北京,temperature:28);StringjsonStringjsonEncode(weather,toEncodable:(object){if(objectisWeather){return{city:object.city,temperature:object.temperature,};}returnobject;},);4. 格式化输出4.1 美化JSON格式MapString,dynamicdata{weather:{city:北京,temperature:28,forecast:[28,29,30]}};// 美化输出StringprettyJsonJsonEncoder.withIndent( ).convert(data);print(prettyJson);输出结果{weather:{city:北京,temperature:28,forecast:[28,29,30]}}4.2 压缩JSON格式StringcompactJsonjsonEncode(data);print(compactJson);输出结果{weather:{city:北京,temperature:28,forecast:[28,29,30]}}5. 编码自定义对象5.1 实现toJson()方法classWeather{finalStringcity;finalint temperature;Weather({requiredthis.city,requiredthis.temperature});MapString,dynamictoJson(){return{city:city,temperature:temperature,};}}WeatherweatherWeather(city:北京,temperature:28);StringjsonStringjsonEncode(weather);5.2 实现fromJson()工厂方法classWeather{finalStringcity;finalint temperature;Weather({requiredthis.city,requiredthis.temperature});factoryWeather.fromJson(MapString,dynamicjson){returnWeather(city:json[city]asString,temperature:(json[temperature]asnum).toInt(),);}}MapString,dynamicdatajsonDecode(jsonString);WeatherweatherWeather.fromJson(data);6. 处理特殊数据类型6.1 DateTime类型处理MapString,dynamicdata{city:北京,updateTime:DateTime.now(),};StringjsonStringjsonEncode(data,toEncodable:(object){if(objectisDateTime){returnobject.toIso8601String();}returnobject;},);6.2 枚举类型处理enumWeatherCondition{sunny,cloudy,rainy}WeatherConditionconditionWeatherCondition.sunny;StringjsonStringjsonEncode({condition:condition.name},);7. 性能优化7.1 避免重复编码解码// 缓存编码结果MapString,String_jsonCache{};StringgetCachedJson(Stringkey,MapString,dynamicdata){if(!_jsonCache.containsKey(key)){_jsonCache[key]jsonEncode(data);}return_jsonCache[key]!;}7.2 使用JsonCodec复用编解码器JsonCodeccodecJsonCodec();MapString,dynamicdatacodec.decode(jsonString);Stringencodedcodec.encode(data);8. 鸿蒙平台兼容性8.1 编码一致性在鸿蒙平台上确保使用UTF-8编码importdart:convert;// 编码Listintbytesutf8.encode(jsonString);// 解码Stringdecodedutf8.decode(bytes);8.2 平台特定数据处理dynamicdecodeJson(StringjsonString){try{returnjsonDecode(jsonString);}catch(e){print(JSON解析失败:$e);returnnull;}}9. 完整示例importdart:convert;voidmain(){// 原始数据MapString,dynamicweatherData{city:北京,temperature:28,humidity:65,wind:{direction:东南风,speed:3},forecast:[28,29,30],isRainy:false,updateTime:DateTime.now().toIso8601String(),};// 编码为JSON字符串压缩格式StringcompactJsonjsonEncode(weatherData);print(压缩格式:$compactJson);// 编码为JSON字符串美化格式StringprettyJsonJsonEncoder.withIndent( ).convert(weatherData);print(\n美化格式:\n$prettyJson);// 解码JSON字符串MapString,dynamicdecodedDatajsonDecode(prettyJson);// 提取数据StringcitydecodedData[city]asString;int temperature(decodedData[temperature]asnum).toInt();print(\n解析结果:);print(城市:$city);print(温度:${temperature}°C);}10. 总结dart:convert库提供了完整的JSON编解码功能是Flutter开发中处理JSON数据的基础工具。通过掌握核心API和高级用法开发者可以高效地处理各种JSON数据格式。下一章将介绍序列化与反序列化的完整实现。核心知识点回顾dart:convert提供jsonEncode()和jsonDecode()两个核心函数使用JsonEncoder.withIndent()实现美化输出自定义对象需要实现toJson()和fromJson()方法使用reviver和toEncodable参数处理特殊类型在鸿蒙平台上确保使用UTF-8编码推荐使用新命名风格jsonEncode()/jsonDecode()
概述dart:convert是Dart标准库的核心模块之一提供了JSON编码和解码的完整功能。在Flutter开发中特别是在鸿蒙平台上进行数据交换时dart:convert是处理JSON数据的基础工具。本文将深入探讨dart:convert库的核心API、高级用法和性能优化技巧。1. dart:convert库简介dart:convert库提供了多种数据转换功能其中与JSON相关的主要包括json.encode() / jsonEncode()将Dart对象编码为JSON字符串json.decode() / jsonDecode()将JSON字符串解码为Dart对象JsonEncoder自定义JSON编码器JsonDecoder自定义JSON解码器JsonCodecJSON编解码器组合1.1 导入方式importdart:convert;2. 核心API详解2.1 jsonDecode() - 解码JSON字符串StringjsonString{city: 北京, temperature: 28};MapString,dynamicdatajsonDecode(jsonString);参数说明sourceJSON字符串reviver可选转换函数用于修改解码过程中的值返回值MapString, dynamic或Listdynamic基础类型String、int、double、bool、null2.2 jsonEncode() - 编码为JSON字符串MapString,dynamicdata{city:北京,temperature:28,};StringjsonStringjsonEncode(data);参数说明object要编码的Dart对象toEncodable可选转换函数处理无法直接编码的对象2.3 json.decode() 与 jsonDecode() 的区别两者功能相同但命名风格不同// 旧风格不推荐MapString,dynamicdatajson.decode(jsonString);// 新风格推荐MapString,dynamicdatajsonDecode(jsonString);3. 高级用法3.1 使用JsonEncoder自定义编码JsonEncoderencoderJsonEncoder.withIndent( );StringprettyJsonencoder.convert({city:北京,temperature:28,});常用构造函数构造函数说明JsonEncoder()默认编码器JsonEncoder.withIndent(indent)带缩进的编码器JsonEncoder(toEncodable)自定义转换函数3.2 使用JsonDecoder自定义解码JsonDecoderdecoderJsonDecoder();dynamicdatadecoder.convert(jsonString);3.3 使用reviver函数修改解码结果MapString,dynamicdatajsonDecode(jsonString,(key,value){if(keytemperature){return(valueasnum).toDouble();}returnvalue;},);3.4 使用toEncodable处理自定义对象classWeather{finalStringcity;finalint temperature;Weather({requiredthis.city,requiredthis.temperature});}WeatherweatherWeather(city:北京,temperature:28);StringjsonStringjsonEncode(weather,toEncodable:(object){if(objectisWeather){return{city:object.city,temperature:object.temperature,};}returnobject;},);4. 格式化输出4.1 美化JSON格式MapString,dynamicdata{weather:{city:北京,temperature:28,forecast:[28,29,30]}};// 美化输出StringprettyJsonJsonEncoder.withIndent( ).convert(data);print(prettyJson);输出结果{weather:{city:北京,temperature:28,forecast:[28,29,30]}}4.2 压缩JSON格式StringcompactJsonjsonEncode(data);print(compactJson);输出结果{weather:{city:北京,temperature:28,forecast:[28,29,30]}}5. 编码自定义对象5.1 实现toJson()方法classWeather{finalStringcity;finalint temperature;Weather({requiredthis.city,requiredthis.temperature});MapString,dynamictoJson(){return{city:city,temperature:temperature,};}}WeatherweatherWeather(city:北京,temperature:28);StringjsonStringjsonEncode(weather);5.2 实现fromJson()工厂方法classWeather{finalStringcity;finalint temperature;Weather({requiredthis.city,requiredthis.temperature});factoryWeather.fromJson(MapString,dynamicjson){returnWeather(city:json[city]asString,temperature:(json[temperature]asnum).toInt(),);}}MapString,dynamicdatajsonDecode(jsonString);WeatherweatherWeather.fromJson(data);6. 处理特殊数据类型6.1 DateTime类型处理MapString,dynamicdata{city:北京,updateTime:DateTime.now(),};StringjsonStringjsonEncode(data,toEncodable:(object){if(objectisDateTime){returnobject.toIso8601String();}returnobject;},);6.2 枚举类型处理enumWeatherCondition{sunny,cloudy,rainy}WeatherConditionconditionWeatherCondition.sunny;StringjsonStringjsonEncode({condition:condition.name},);7. 性能优化7.1 避免重复编码解码// 缓存编码结果MapString,String_jsonCache{};StringgetCachedJson(Stringkey,MapString,dynamicdata){if(!_jsonCache.containsKey(key)){_jsonCache[key]jsonEncode(data);}return_jsonCache[key]!;}7.2 使用JsonCodec复用编解码器JsonCodeccodecJsonCodec();MapString,dynamicdatacodec.decode(jsonString);Stringencodedcodec.encode(data);8. 鸿蒙平台兼容性8.1 编码一致性在鸿蒙平台上确保使用UTF-8编码importdart:convert;// 编码Listintbytesutf8.encode(jsonString);// 解码Stringdecodedutf8.decode(bytes);8.2 平台特定数据处理dynamicdecodeJson(StringjsonString){try{returnjsonDecode(jsonString);}catch(e){print(JSON解析失败:$e);returnnull;}}9. 完整示例importdart:convert;voidmain(){// 原始数据MapString,dynamicweatherData{city:北京,temperature:28,humidity:65,wind:{direction:东南风,speed:3},forecast:[28,29,30],isRainy:false,updateTime:DateTime.now().toIso8601String(),};// 编码为JSON字符串压缩格式StringcompactJsonjsonEncode(weatherData);print(压缩格式:$compactJson);// 编码为JSON字符串美化格式StringprettyJsonJsonEncoder.withIndent( ).convert(weatherData);print(\n美化格式:\n$prettyJson);// 解码JSON字符串MapString,dynamicdecodedDatajsonDecode(prettyJson);// 提取数据StringcitydecodedData[city]asString;int temperature(decodedData[temperature]asnum).toInt();print(\n解析结果:);print(城市:$city);print(温度:${temperature}°C);}10. 总结dart:convert库提供了完整的JSON编解码功能是Flutter开发中处理JSON数据的基础工具。通过掌握核心API和高级用法开发者可以高效地处理各种JSON数据格式。下一章将介绍序列化与反序列化的完整实现。核心知识点回顾dart:convert提供jsonEncode()和jsonDecode()两个核心函数使用JsonEncoder.withIndent()实现美化输出自定义对象需要实现toJson()和fromJson()方法使用reviver和toEncodable参数处理特殊类型在鸿蒙平台上确保使用UTF-8编码推荐使用新命名风格jsonEncode()/jsonDecode()
