EssaLab.StronglyTypedIds.Convertors.Json
2.0.0
dotnet add package EssaLab.StronglyTypedIds.Convertors.Json --version 2.0.0
NuGet\Install-Package EssaLab.StronglyTypedIds.Convertors.Json -Version 2.0.0
<PackageReference Include="EssaLab.StronglyTypedIds.Convertors.Json" Version="2.0.0"> <PrivateAssets>all</PrivateAssets> <IncludeAssets>runtime; build; native; contentfiles; analyzers</IncludeAssets> </PackageReference>
<PackageVersion Include="EssaLab.StronglyTypedIds.Convertors.Json" Version="2.0.0" />
<PackageReference Include="EssaLab.StronglyTypedIds.Convertors.Json"> <PrivateAssets>all</PrivateAssets> <IncludeAssets>runtime; build; native; contentfiles; analyzers</IncludeAssets> </PackageReference>
paket add EssaLab.StronglyTypedIds.Convertors.Json --version 2.0.0
#r "nuget: EssaLab.StronglyTypedIds.Convertors.Json, 2.0.0"
#:package EssaLab.StronglyTypedIds.Convertors.Json@2.0.0
#addin nuget:?package=EssaLab.StronglyTypedIds.Convertors.Json&version=2.0.0
#tool nuget:?package=EssaLab.StronglyTypedIds.Convertors.Json&version=2.0.0
EssaLab.StronglyTypedIds.Convertors.Json
The System.Text.Json source generator providing reflection-free JSON interoperability for EssaLab Strongly Typed IDs.
Responsibilities
Operating gracefully within ASP.NET Core presentation architectures, this library enforces high-performance and resilient serialization pipelines:
- Automated Type-Safe Serialization: Replaces generic string or object mapping operations with robust, pre-compiled
JsonConverter<T>classes tailored exactly to the target structure. - Zero-Reflection Overhead: Serialization configurations are deeply integrated during Roslyn Source Generation phases. This strictly removes runtime reflection penalties conventionally associated with custom JsonConverters, maximizing Web API throughput requests.
- Metadata Fingerprint Detection: Bypasses naive API Controller scanning mechanisms. The generator interacts with dependent Assembly Metadata Fingerprints to effortlessly discover Domain Level IDs regardless of where or whether they appear strictly in
[ApiController]surface DTOs. - Centralized Extensibility: Produces the globally addressable extension
AddStronglyTypedIdConverters(this JsonSerializerOptions). This configures the entire HTTP pipeline to comprehend Domain IDs reliably.
Best Practices
Install this package specifically in projects managing external API configuration and presentation routing (e.g., YourApplication.WebApi or YourApplication.Api). Configure your host services once to apply the mapping:
builder.Services.ConfigureHttpJsonOptions(options =>
{
// Injects all Strongly Typed ID serializers seamlessly
options.SerializerOptions.AddStronglyTypedIdConverters();
});
Learn more about Target Frameworks and .NET Standard.
-
.NETStandard 2.0
- No dependencies.
NuGet packages
This package is not used by any NuGet packages.
GitHub repositories
This package is not used by any popular GitHub repositories.
| Version | Downloads | Last Updated |
|---|---|---|
| 2.0.0 | 119 | 3/28/2026 |
| 1.0.0-preview | 138 | 3/13/2026 |