パッケージ、リポジトリ、アプリカテゴリを検索

パッケージ詳細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 件

ソースリポジトリ

このパッケージを使用しているプロジェクト