搜尋套件、儲存庫與 APP 分類

套件詳情v1.2.3

data_serializer

可攜式 Dart 套件,用於有效處理資料序列化/反序列化,包含一個動態的 BytesBuffer 以讀取/寫入資料。

AndroidiOSWebmacOSWindowsLinux
近 30 天下載
1.3萬
喜歡數
3
Pub 分數
150

安裝套件

flutter pub add data_serializer

套件介紹

根據套件公開資料產生的選型評估,僅供參考。

一個便攜式 Dart 套件,用於高效資料序列化與反序列化,具備動態 BytesBuffer,可低階讀取與寫入二進位資料。設計目標是簡化物件與序列化格式之間的轉換,支援跨平台使用,涵蓋 Android、iOS、Web、macOS、Windows 與 Linux。適用於需要高效率資料處理且開銷極小的應用情境。在網路通訊、檔案儲存或即時資料交換等場景中尤為實用,此時速度與可靠性至關重要。

適用情境

  • 二進位資料傳輸
  • 檔案格式解析
  • 即時數據處理
  • 跨平台數據共享
  • 網路協定實現

主要特色

  • 動態 BytesBuffer
  • 高效序列化
  • 跨平台支援
  • 底層資料操作
  • 高效能

適合對象

  • 高性能應用
  • 網路密集型應用
  • 嵌入式系統
  • 數據密集型工作流程
  • 自訂二進位格式

使用建議

  • 需要理解二進制數據
  • 僅限基本類型,不含自定義邏輯
  • 不適合複雜的JSON結構
  • 需要手動類型管理
  • 低階操作的學習曲線

原始 README

以下為關聯原始碼儲存庫的 README 原文快照,最新內容請造訪原始碼儲存庫。

data_serializer

pub package Null Safety Codecov Dart CI GitHub Tag New Commits Last Commits Pull Requests Code size License

Portable Dart package to handle data serialization/deserialization efficiently, including a dynamic BytesBuffer to read/write data.

API Documentation

See the API Documentation for a full list of functions, classes and extension.

Usage

import 'package:data_serializer/data_serializer.dart';

void main() {
  // Dynamic bytes buffer with initial capacity of 16 bytes.
  var buffer = BytesBuffer(16);

  // Write a unsigned int of 32 bits:
  buffer.writeInt32(0x10203040);

  // Write a `String` encoded using UTF-8:
  buffer.writeString('Hello!');

  // Write a unsigned int of 64 bits:
  buffer.writeUint64(9223372036854775807);

  // Write a data block (prefixed by 4 bytes for he data length).
  var dataBlock = [110, 120, 130, 140, 150, 160].toUint8List();
  buffer.writeBlock32(dataBlock);

  // Write all bytes:
  buffer.writeAll([210, 220]);

  // The current length of the buffer, expanded automatically:
  print('length: ${buffer.length}');

  // Change the current position cursor to `0`:
  buffer.seek(0);

  // Read a 32 bits int:
  var n32 = buffer.readUint32();
  print('n32: 0x${n32.toHex32()}');

  // Reads a `String` decoding from UTF-8:
  var s = buffer.readString();
  print('s: $s');

  // Read a 64 bits int:
  var n64 = buffer.readUint64();
  print('n64: $n64');

  // The current buffer position:
  print('position: ${buffer.position}');

  // Read a data block:
  var dataBlock2 = buffer.readBlock32();
  print('dataBlock2: $dataBlock2');

  // The position after read the data block:
  print('position: ${buffer.position}');

  // The remaining bytes in the buffer:
  var tailBytes = buffer.readRemainingBytes();
  print('tailBytes: $tailBytes');
}

OUTPUT:

length: 34
n32: 0x10203040
s: Hello!
n64: 9223372036854775807
position: 22
dataBlock2: [110, 120, 130, 140, 150, 160]
position: 32
tailBytes: [210, 220]

Browser/JavaScript compatibility

All the operations are tested to be compatible with JavaScript.

Note that JS only supports 53-bits integers. To avoid any issue serializing 64-bits integers, try to use BigInt serialization, or ensure that you are bellow the 53-bits range.

See the class DataSerializerPlatform if you need runtime information about integers support.

Test Coverage

Codecov

This package aims to always have a high test coverage percentage, over 95%. With that the package can be a reliable tool to support your important projects.

Source

The official source code is hosted @ GitHub:

  • https://github.com/gmpassos/data_serializer

Features and bugs

Please file feature requests and bugs at the issue tracker.

Contribution

Any help from the open-source community is always welcome and needed:

  • Found an issue?
    • Please fill a bug report with details.
  • Wish a feature?
    • Open a feature request with use cases.
  • Are you using and liking the project?
    • Promote the project: create an article, do a post or make a donation.
  • Are you a developer?
    • Fix a bug and send a pull request.
    • Implement a new feature.
    • Improve the Unit Tests.
  • Have you already helped in any way?
    • Many thanks from me, the contributors and everybody that uses this project!

If you donate 1 hour of your time, you can contribute a lot, because others will do the same, just be part and start with your 1 hour.

Author

Graciliano M. Passos: gmpassos@GitHub.

License

Apache License - Version 2.0

所屬分類

依賴

依賴清單 2 項

原始碼儲存庫

使用此套件的專案