Flutter数据扩展插件extension_data的使用

extension_data 是一个用于 Dart 和 Flutter 的插件，提供了多种编码和数据处理功能。以下是如何使用该插件的详细说明。

安装

在 pubspec.yaml 文件中添加依赖：

dependencies:
  extension_data: ^最新版本号

然后运行 flutter pub get 来获取新的依赖。

使用

基础用法

编码与解码

extension_data 提供了多种编码和解码的方法，包括 Base58、Base64 和 Hex 等。

import 'package:extension_data/extension_data.dart';

void main() {
  const str = 'extension_data';
  // utf8 编码
  final bytes = utf8.encode(str);
  const hexStr = '0x657874656e73696f6e5f64617461';
  const strBs64 = 'ZXh0ZW5zaW9uX2RhdGE=';
  const strBs58 = 'eJdhyKqktt8nj9vnTwe';

  // 测试编解码
  test('Test Codec', () {
    print('$str:  bytes: ${bytes.toList()}');
    // base58 编码
    expect(base58Encode(bytes), strBs58);
    expect(base58Decode(strBs58), bytes);
    // base64 编码
    expect(base64Encode(bytes), strBs64);
    expect(base64Decode(strBs64), bytes);
    // hex 编码
    expect(hexEncode(bytes), hexStr);
    expect(hexDecode(hexStr), bytes);
  });
}

数据类

extension_data 还提供了多种数据类，如 Base58Data, Base64Data, HexData 等。

test('Test Data', () {
  // base58 数据
  expect(Base58Data(strBs58).bytes, bytes);
  expect(Base58Data.fromBytes(bytes).value, strBs58);
  // base64 数据
  expect(Base64Data(strBs64).bytes, bytes);
  expect(Base64Data.fromBytes(bytes).value, strBs64);
  // hex 数据
  expect(HexData(hexStr).bytes, bytes);
  expect(HexData.fromBytes(bytes).value, hexStr);
});

扩展方法

extension_data 还提供了一些扩展方法，例如对 DateTime 类型的操作。

const timestampInMs = '1661966625123';

// 扩展方法示例
final dateTime = TimeUnit.milliseconds.parseTimestamp(timestampInMs);
assert(dateTime.toString() == '2022-09-01 01:23:45.123');

var d2 = timestampInMs.toDateTime(TimeUnit.milliseconds);
var atSameMomentAs = d2.isAtSameMomentAs(dateTime);
print('atSameMomentAs=$atSameMomentAs');

示例代码

以下是一个完整的示例代码，展示了如何使用 extension_data 插件进行编码、解码和数据处理。

import 'dart:convert';

import 'package:extension_data/extension_data.dart';

void main() {
  const str = 'extension_data';
  // utf8 编码
  const bytes = [
    101,
    120,
    116,
    101,
    110,
    115,
    105,
    111,
    110,
    95,
    100,
    97,
    116,
    97
  ];
  const hexStr = '0x657874656e73696f6e5f64617461';
  const strBs64 = 'ZXh0ZW5zaW9uX2RhdGE=';
  const strBs58 = 'eJdhyKqktt8nj9vnTwe';

  // 编解码示例
  final base58Str = base58Encode(utf8.encode(str));
  print(base58Str); // 输出: eJdhyKqktt8nj9vnTwe

  final rawStr = utf8.decode(base64Decode(strBs64));
  print(rawStr); // 输出: extension_data

  // 数据类示例
  print(Base64Data.fromBytes(bytes).value); // 输出: ZXh0ZW5zaW9uX2RhdGE=
  print(Base58Data(strBs58).bytes); // 输出: [101, 120, 116, 101, 110, 115, 105, 111, 110, 95, 100, 97, 116, 97]
  print(utf8.decode(HexData(hexStr).bytes.toList())); // 输出: extension_data
  print(utf8.decode(HexData(hexStr.replaceFirst('0x', '')).bytes.toList())); // 输出: extension_data
  print(HexData(hexStr).bytes.toBase58()); // 输出: eJdhyKqktt8nj9vnTwe

  // 扩展方法示例
  const timestampInMs = '1661966625123';
  final dateTime = TimeUnit.milliseconds.parseTimestamp(timestampInMs);
  assert(dateTime.toString() == '2022-09-01 01:23:45.123');

  var d2 = timestampInMs.toDateTime(TimeUnit.milliseconds);
  var atSameMomentAs = d2.isAtSameMomentAs(dateTime);
  print('atSameMomentAs=$atSameMomentAs'); // 输出: atSameMomentAs=true
}