Mapster 5.3.2
A fast, fun and stimulating object to object mapper. Kind of like AutoMapper, just simpler and way, way faster.
Install-Package Mapster -Version 5.3.2
dotnet add package Mapster --version 5.3.2
<PackageReference Include="Mapster" Version="5.3.2" />
paket add Mapster --version 5.3.2
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
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
| 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
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
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
| 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
Dependencies
-
.NETFramework 4.0
- No dependencies.
-
.NETFramework 4.5
- No dependencies.
-
.NETStandard 1.3
- Microsoft.CSharp (>= 4.3.0)
- NETStandard.Library (>= 1.6.1)
- System.Linq.Queryable (>= 4.3.0)
- System.Reflection.Emit (>= 4.3.0)
- System.Reflection.TypeExtensions (>= 4.3.0)
-
.NETStandard 2.0
- Microsoft.CSharp (>= 4.3.0)
- System.Reflection.Emit (>= 4.3.0)
Used By
GitHub repositories (9+)
Showing the top 5 GitHub repositories that depend on Mapster:
| Repository | Stars |
|---|---|
|
bing-framework/Bing.NetCore
Bing是基于 .net core 2.0 的框架，旨在提升团队的开发输出能力，由常用公共操作类（工具类、帮助类）、分层架构基类，第三方组件封装，第三方业务接口封装等组成。
|
|
|
nager/Nager.Date
Worldwide public holiday
|
|
|
fluentsprings/ExpressMapper
Mapping .Net types
|
|
|
agileobjects/AgileMapper
A zero-configuration, highly-configurable, unopinionated object mapper with viewable execution plans. Flattens, unflattens, deep clones, merges, updates and projects queries. Targets .NET 3.5+ and .NET Standard 1.0+
|
|
|
SkyChenSky/Sikiro.Tookits
Base And Frequently-used Tools Library.You can use it on nuget
|
Version History
| Version | Downloads | Last updated | ||
|---|---|---|---|---|
| 5.3.2 | 11,201 | 5/29/2020 | ||
| 5.3.1 | 9,267 | 5/12/2020 | ||
| 5.3.0 | 23,255 | 4/10/2020 | ||
| 5.2.0 | 24,593 | 3/14/2020 | ||
| 5.1.0 | 8,533 | 3/3/2020 | ||
| 5.0.0 | 26,831 | 2/2/2020 | ||
| 4.1.1 | 96,963 | 10/19/2019 | ||
| 4.1.0 | 150,428 | 6/15/2019 | ||
| 4.0.0 | 97,666 | 4/13/2019 | ||
| 3.3.2 | 58,583 | 3/6/2019 | ||
| 3.3.1 | 37,818 | 2/5/2019 | ||
| 3.3.0 | 5,188 | 1/29/2019 | ||
| 3.2.0 | 168,528 | 9/9/2018 | ||
| 3.1.8 | 201,268 | 11/16/2017 | ||
| 3.1.7 | 1,952 | 11/11/2017 | ||
| 3.1.6 | 35,513 | 10/15/2017 | ||
| 3.1.5 | 2,767 | 10/9/2017 | ||
| 3.1.4 | 3,700 | 10/1/2017 | ||
| 3.1.3 | 30,091 | 8/22/2017 | ||
| 3.1.1 | 17,573 | 6/19/2017 | ||
| 3.1.0 | 4,128 | 6/11/2017 | ||
| 3.0.4 | 4,651 | 5/28/2017 | ||
| 2.6.1 | 34,497 | 12/8/2016 | ||
| 2.6.0 | 1,241 | 12/3/2016 | ||
| 2.5.0 | 37,991 | 8/7/2016 | ||
| 2.4.3 | 2,582 | 7/14/2016 | ||
| 2.4.2 | 1,306 | 7/4/2016 | ||
| 2.4.1 | 1,323 | 6/22/2016 | ||
| 2.4.0 | 1,205 | 6/18/2016 | ||
| 2.3.0 | 9,251 | 3/18/2016 | ||
| 2.1.2 | 4,320 | 2/15/2016 | ||
| 2.1.1 | 1,328 | 1/29/2016 | ||
| 2.1.0 | 1,434 | 1/25/2016 | ||
| 2.0.4 | 1,132 | 1/21/2016 | ||
| 2.0.3 | 1,152 | 1/20/2016 | ||
| 2.0.2 | 1,073 | 1/19/2016 | ||
| 2.0.1 | 1,098 | 1/19/2016 | ||
| 2.0.0 | 1,072 | 1/19/2016 | ||
| 1.14.0 | 12,796 | 3/4/2015 | ||
| 1.12.0 | 1,443 | 3/2/2015 |
