dart:convert包详解

dart:convert 包提供了在 JSON、UTF-8 和 Base64 等数据格式之间转换的支持。在 Dart 应用程序中，经常需要将数据从一种格式转换为另一种格式，比如将 JSON 字符串转换为对象，或者将对象转换为 JSON 字符串。dart:convert 包提供了丰富的 API，以支持这些常见的数据格式转换操作。

1.JSON 数据格式

JSON（JavaScript Object Notation）是一种轻量级的数据交换格式，常用于 Web 应用程序中，也被广泛地应用于移动应用程序、后端服务器和物联网等领域。在 Dart 应用程序中，dart:convert 包提供了支持 JSON 格式的编码和解码 API，使得开发人员可以轻松地将 Dart 对象转换为 JSON 字符串，或者将 JSON 字符串转换为 Dart 对象。

1.1JsonEncoder

JsonEncoder 类提供了将 Dart 对象编码为 JSON 字符串的功能。在使用 JsonEncoder 进行编码时，可以通过设置 toEncodable 参数来指定一个自定义的编码函数，用于将无法直接编码为 JSON 的对象进行编码。默认情况下，JsonEncoder 使用 Dart 内置的编码函数将对象编码为 JSON 字符串。

import 'dart:convert';

void main() {
  var obj = {'name': 'John', 'age': 30};
  var encoder = JsonEncoder();
  var jsonStr = encoder.convert(obj);
  print(jsonStr); // {"name":"John","age":30}
}

1.2JsonDecoder

JsonDecoder 类提供了将 JSON 字符串解码为 Dart 对象的功能。在使用 JsonDecoder 进行解码时，可以通过设置 reviver 参数来指定一个自定义的解码函数，用于将 JSON 中的某些值进行转换。默认情况下，JsonDecoder 将 JSON 解码为对应的 Dart 对象。

import 'dart:convert';

void main() {
  var jsonStr = '{"name":"John","age":30}';
  var decoder = JsonDecoder();
  var obj = decoder.convert(jsonStr);
  print(obj); // {name: John, age: 30}
}

2.UTF-8 数据格式

UTF-8 是一种 Unicode 字符编码方式，支持大多数的字符集。在 Dart 应用程序中，dart:convert 包提供了支持 UTF-8 格式的编码和解码 API，使得开发人员可以轻松地将 Dart 字符串转换为 UTF-8 字节序列，或者将 UTF-8 字节序列转换为 Dart 字符串。

2.1Utf8Encoder

Utf8Encoder 类提供了将 Dart 字符串编码为 UTF-8 字节序列的功能。

import 'dart:convert';

void main() {
  var str = 'Hello, world!';
  var encoder = Utf8Encoder();
  var bytes = encoder.convert(str);
  print(bytes); // [72, 101, 108, 108, 111, 44, 32, 119, 111, 114, 108, 100, 33]
}

2.2Utf8Decoder

Utf8Decoder 类提供了将 UTF-8 字节序列解码为 Dart 字符串的功能。

import 'dart:convert';

void main() {
  var bytes = [72, 101, 108, 108, 111, 44, 32, 119, 111, 114, 108, 100, 33];
  var decoder = Utf8Decoder();
  var str = decoder.convert(bytes);
  print(str); // Hello, world!
}

3.Base64 数据格式

Base64 是一种用于将二进制数据编码为 ASCII 字符串的编码方式，通常用于在网络上传输二进制数据，也常用于数据的加密和解密。在 Dart 应用程序中，dart:convert 包提供了支持 Base64 格式的编码和解码 API，使得开发人员可以轻松地将 Dart 字符串或字节序列转换为 Base64 字符串，或者将 Base64 字符串转换为 Dart 字符串或字节序列。

3.1Base64Encoder

Base64Encoder 类提供了将 Dart 字符串或字节序列编码为 Base64 字符串的功能。

import 'dart:convert';

void main() {
  var str = 'Hello, world!';
  var encoder = Base64Encoder();
  var base64Str = encoder.convert(str.codeUnits);
  print(base64Str); // SGVsbG8sIHdvcmxkIQ==
}

3.2Base64Decoder

Base64Decoder 类提供了将 Base64 字符串解码为 Dart 字符串或字节序列的功能。

import 'dart:convert';

void main() {
  var base64Str = 'SGVsbG8sIHdvcmxkIQ==';
  var decoder = Base64Decoder();
  var bytes = decoder.convert(base64Str);
  var str = String.fromCharCodes(bytes);
  print(str); // Hello, world!
}

除了以上提到的常用 API 之外，dart:convert 包还提供了其他许多有用的 API，例如支持 ASCII 编码和解码的 AsciiEncoder 和 AsciiDecoder 类，支持 HTML 实体编码和解码的 HtmlEscape 和 HtmlEscapeMode 类，以及支持 UTF-16 数据格式的 Utf16Encoder 和 Utf16Decoder 类等等。这些 API 可以帮助开发人员在 Dart 应用程序中更方便地处理不同格式的数据。

dart:convert