Mapster 5.2.0

Mapster - The Mapper of Your Domain

Writing mapping method is machine job. Do not waste your time, let Mapster do it.

Get it

PM> Install-Package Mapster

Basic usage

Mapping to a new object

Mapster creates the destination object and maps values to it.

var destObject = sourceObject.Adapt<Destination>();

Mapping to an existing object

You make the object, Mapster maps to the object.

sourceObject.Adapt(destObject);

Queryable Extensions

Mapster also provides extensions to map queryables.

using (MyDbContext context = new MyDbContext())
{
    // Build a Select Expression from DTO
    var destinations = context.Sources.ProjectToType<Destination>().ToList();

    // Versus creating by hand:
    var destinations = context.Sources.Select(c => new Destination {
        Id = p.Id,
        Name = p.Name,
        Surname = p.Surname,
        ....
    })
    .ToList();
}

What's new in Mapster 5.0

• Generate dynamic proxy for interface
• UseDestinationValue
• Null propagating for property path
• Support multiple sources
• New plugins
  • Async support
  • Inject service to mapping
  • EF Core support

Why Mapster?

Performance & Memory efficient

Mapster was designed to be efficient on both speed and memory. You could gain 5x faster while using only 1/3 of memory. And you could gain to 12x faster with

• Roslyn Compiler
• FEC
• Mapster CodeGen

|                    Method |      Mean | Allocated |
|-------------------------- | ---------:|----------:|
|           'Mapster 5.0.0' | 141.84 ms | 125.12 MB |
|  'Mapster 5.0.0 (Roslyn)' |  60.48 ms | 125.12 MB |
|     'Mapster 5.0.0 (FEC)' |  58.17 ms | 119.02 MB |
| 'Mapster 5.0.0 (Codegen)' |  51.56 ms | 125.12 MB |
|     'ExpressMapper 1.9.1' | 299.05 ms | 241.85 MB |
|        'AutoMapper 9.0.0' | 708.06 ms | 364.69 MB |

Step into debugging

Step-into debugging lets you debug your mapping and inspect values as same as its your code.

Code Generation

Mapster CodeGen lets you do mapping with

• Validate mapping at compile time
• Getting raw performance
• Seeing your mapping code & debugging
• Finding usage of your models' properties

Change logs

https://github.com/MapsterMapper/Mapster/releases

Usages

https://github.com/MapsterMapper/Mapster/wiki

Acknowledgements

JetBrains kindly provides Mapster with a free open-source licence for their Resharper and Rider.

• Resharper makes Visual Studio a much better IDE
• Rider is fast & powerful cross platform .NET IDE