TheWolf.Mapper 1.0.1

TheWolf.Mapper

A .NET Standard Library for a simple mapping of objects to another objects. As exmaple entity to dto and reverse.

Installing

Install the latest nuget package from https://www.nuget.org/packages/TheWolf.Mapper/.

Install-Package TheWolf.Mapper

You can also use the nuget package manager for searching and installing this package.

Basic usage

Create a new class which inherits from the MapperBase<ObjectA, ObjectB>.

public class ExampleMapper : MapperBase<ExampleEntity, ExampleDto>
{
    
}

Create an instance and map your objects.

var mapper = new ExampleMapper();
var exampleDto = mapper.Map(exampleEntity);

If the target property has the same type as the source property and also both has the same name, it automatically maps the value.

Special mappings

The function names for create special mappings has a specifically structure.

[target property type] CreateMap[target type][target property name]([source type] sourceType)

An example looks like:

DateTime CreateMapExampleDtoTime(ExampleEntity exampleEntity)

So a special mapping can be implemented very easily.

public int? CreateMapExampleDtoExampleChildEntitesCount(ExampleEntity entity)
{
    return entity.ExampleChildEntities?.Count;
}

Dependency Injection

If there are moments which has to be implemented with DI, there is a way to do this.

For an example in .NET Core you can register your mappers like this:

 var serviceProvider = new ServiceCollection().AddSingleton(typeof(IMapperBase<ExampleEntity, ExampleDto>), typeof(ExampleMapper))

So now, you can add constructor DI actions.

public class ExampleMapper : MapperBase<ExampleEntity, ExampleDto>
{
    private readonly ILogger<ExampleMapper> _logger;

    public ExampleMapper(ILogger<ExampleMapper> logger)
    {
        _logger = logger;
    }
}    

In that case you can use the mapper with GetService().

var mapper = serviceProvider.GetService(typeof(IMapperBase<ExampleEntity, ExampleDto>)) as ExampleMapper;