BinaryConverter

Provides async object-to-byte and byte-to-object conversion using Ceras for performance, with a fallback to JSON serialization for compatibility. Supports JToken through a custom converter (Important for Account and DataHandler systems especially)

Types

BinaryConverter

Static class providing serialization and deserialization logic for arbitrary object graphs.

  • Fields:

    • JsonSerializerOptions _options: Internal configuration for JSON fallback, including a custom JTokenConverter

  • Nested Types:

    • JTokenConverter: Custom converter that handles serialization and deserialization of JToken values using System.Text.Json.

Methods

Task<byte[]> NCObjectToByteArrayAsync(T obj, SerializerConfig? config = null, CancellationToken cancellationToken = default)

Attempts to serialize the object using Ceras. Falls back to JSON if the object isn't compatible.

  • Parameters:

    • obj: The object to serialize.
    • config: Optional Ceras configuration.
    • cancellationToken: Optional cancellation support.

  • Returns: byte[]

Task<T?> NCByteArrayToObjectAsync(byte[] data, SerializerConfig? config = null, CancellationToken cancellationToken = default)

Attempts to deserialize data using Ceras. Falls back to JSON deserialization if Ceras fails.

  • Parameters:

    • data: The byte array representing the serialized object.
    • config: Optional Ceras configuration.
    • cancellationToken: Optional cancellation support.

  • Returns: T?