EntityAxis.KeyMappers 1.0.0

EntityAxis.KeyMappers

EntityAxis.KeyMappers provides key mapping implementations for EntityAxis, allowing seamless conversion between application and database key types.

✨ Features

• Generic key mappers for common scenarios:
  • IdentityKeyMapper<T> for when key types are the same
  • StringToGuidKeyMapper for string-to-Guid conversion
  • StringToIntKeyMapper for string-to-integer conversion
• Easy to extend with custom key mappers
• Stateless implementations for optimal performance

📦 Installation

dotnet add package EntityAxis.KeyMappers

🧱 Available Key Mappers

IdentityKeyMapper<T>

A default implementation for when the application and database key types are the same. This mapper performs no conversion and simply returns the input key.

// Register in DI container
services.AddSingleton<IKeyMapper<int, int>, IdentityKeyMapper<int>>();

StringToGuidKeyMapper

Converts between string keys in the application layer and GUID keys in the database.

// Register in DI container
services.AddSingleton<IKeyMapper<string, Guid>, StringToGuidKeyMapper>();

StringToIntKeyMapper

Converts between string keys in the application layer and integer keys in the database.

// Register in DI container
services.AddSingleton<IKeyMapper<string, int>, StringToIntKeyMapper>();

🧪 Creating Custom Key Mappers

You can create custom key mappers by implementing the IKeyMapper<TAppKey, TDbKey> interface:

public class CustomKeyMapper : IKeyMapper<string, long>
{
    public long ToDbKey(string appKey) => long.Parse(appKey);
    public string ToAppKey(long dbKey) => dbKey.ToString();
}

🧠 Best Practices

• Register key mappers as singletons since they are stateless
• Ensure your key mappers handle edge cases (null values, invalid formats, etc.)
• Consider adding validation in your key mappers to catch conversion issues early
• Use the IdentityKeyMapper when your application and database key types are the same

🔗 Related Packages

• EntityAxis.Abstractions: Defines common CRUD contracts (IGetById, ICreate, etc.) and domain-friendly interfaces for clean application layers.
• EntityAxis.EntityFramework: Drop-in base classes for EF Core integration
• EntityAxis.MediatR: Generic MediatR handlers for Create/Read/Update/Delete
• EntityAxis.Registration: Offers IServiceCollection extension methods to register handlers, validators, and mapping configuration easily in your DI container.

📜 License

This project is licensed under the MIT License.