Len.StronglyTypedId 1.2.0

StronglyTypedId

A base implementation of strongly typed ids that supports Newtonsoft.Json, System.Text.Json, EntityFramework Core, and Swashbuckle.AspNetCore.

Getting started

1. Install the package into your application or library.

    Package Manager : Install-Package Len.StronglyTypedId
    CLI : dotnet add package Len.StronglyTypedId 

2. Use record to define a strongly typed id:

    [StronglyTypedId]
    public partial record struct OrderId(Guid Value);

or

    [StronglyTypedId]
    public partial record OrderId(Guid Value);

Note: Only the record type is supported and cannot be nested, abstract, or generic.Support for serialization and deserialization of Newtonsoft.Json(version 13.0.0 or above) and System.Text.Json.

EntityFramework Core (version 7.0.0 or above)

Add the converter for a strongly typed id to the configuration of DbContext.

    protected override void ConfigureConventions(ModelConfigurationBuilder configurationBuilder)
    {
        base.ConfigureConventions(configurationBuilder);

        //...other

        StronglyTypedIds.ApplyTo(configurationBuilder);
    }

Swashbuckle.AspNetCore

Add the converter for a strongly typed id to the configuration of Swagger.

    services.AddSwaggerGen(options =>
    {
        StronglyTypedIds.ApplyTo(options);
    });