Skip to content

CoreSystem.Serialization

Production-ready serialization abstraction for .NET 8, .NET 9 and .NET 10.

CoreSystem.Serialization provides a unified serialization abstraction for .NET applications, allowing you to work with JSON, MessagePack, or Protocol Buffers through a single API.

NuGet Downloads License .NET

Features

  • Unified serialization abstraction (IPayloadSerializer)
  • JSON, MessagePack, and Protocol Buffers support
  • Dependency Injection integration
  • Configurable serializer selection
  • Common exception model (CoreSerializationException)
  • Lightweight and reusable

Installation

dotnet add package CoreSystem.Serialization

Quick Start

builder.Services.AddCoreSerialization();

public sealed class OrderService(IPayloadSerializer serializer)
{
    public byte[] Serialize(Order order) => serializer.Serialize(order);

    public Order? Deserialize(byte[] payload) => serializer.Deserialize<Order>(payload);
}

Formats

Serializer Selected via SerializerType Notes
JSON SerializerType.Json Default, human readable
MessagePack SerializerType.MessagePack Compact binary
Protobuf SerializerType.Protobuf Schema-driven binary

The concrete serializer classes are internal; select one with options.DefaultSerializer and consume it through IPayloadSerializer.

Contributing

Issues, discussions and pull requests are welcome.