[非专业翻译] Mapster - 数据类型
[非专业翻译] Mapster - 数据类型
系列介绍
[非专业翻译] 是对没有中文文档进行翻译的系列博客,文章由机翻和译者自己理解构成,和原文相比有所有不同,但意思基本一致。
因个人能力有限,如有谬误之处还请指正,多多包涵。
正文
本文将说明 Mapster 中的 数据类型
基本类型
基本类型的转换 ,例如: int/bool/dobule/decimal
,包括可空的基本类型。
只要C#支持类型转换的类型,那么在 Mapster 中也同样支持转换。
decimal i = 123.Adapt<decimal>(); //equal to (decimal)123;
枚举类型
Mapster 会自动把枚举映射到数字类型,同样也支持 字符串到枚举 和 枚举到字符串的映射。
.NET 默认实现 枚举/字符串 转换非常慢,Mapster 比 .NET 的默认实现快两倍。
在 Mapster 中,字符串转枚举,如果字符串为空或空字符串,那么枚举将初始化为第一个枚举值。
在Mapster中,也支持标记的枚举。
var e = "Read, Write, Delete".Adapt<FileShare>();
//FileShare.Read | FileShare.Write | FileShare.Delete
对于不同类型的枚举,Mapster 默认将值映射为枚举。调用 EnumMappingStrategy
方法可以指定枚举映射方式,如:
TypeAdapterConfig.GlobalSettings.Default
.EnumMappingStrategy(EnumMappingStrategy.ByName);
字符串类型
在 Mapster 中,将其它类型映射为字符串时,Mapster 将调用类型的 ToString
方法。
如果将字符串映射为类型时,Mapster 将调用类型的 Parse
方法。
var s = 123.Adapt<string>(); // 等同于: 123.ToString();
var i = "123".Adapt<int>(); // 等同于: int.Parse("123");
集合
包括列表、数组、集合、包括各种接口的字典之间的映射: IList<T>
, ICollection<T>
, IEnumerable<T>
, ISet<T>
, IDictionary<TKey, TValue>
等等…
var list = db.Pocos.ToList();
var target = list.Adapt<IEnumerable<Dto>>();
可映射对象
Mapster 可以使用以下规则映射两个不同的对象
- 源类型和目标类型属性名称相同。 例如:
dest.Name = src.Name
- 源类型有
GetXXXX
方法。例如:dest.Name = src.GetName()
- 源类型属性有子属性,可以将子属性的赋值给符合条件的目标类型属性,例如:
dest.ContactName = src.Contact.Name
或dest.Contact_Name = src.Contact.Name
示例:
class Staff {
public string Name { get; set; }
public int GetAge() {
return (DateTime.Now - this.BirthDate).TotalDays / 365.25;
}
public Staff Supervisor { get; set; }
...
}
struct StaffDto {
public string Name { get; set; }
public int Age { get; set; }
public string SupervisorName { get; set; }
}
var dto = staff.Adapt<StaffDto>();
//dto.Name = staff.Name, dto.Age = staff.GetAge(), dto.SupervisorName = staff.Supervisor.Name
可映射对象类型包括:
- 类
- 结构体
- 接口
- 实现
IDictionary<string, T>
接口的字典类型 - Record 类型 (类、结构体、接口)
对象转换为字典的例子:
var point = new { X = 2, Y = 3 };
var dict = point.Adapt<Dictionary<string, int>>();
dict["Y"].ShouldBe(3);
Record 类型的例子:
class Person {
public string Name { get; }
public int Age { get; }
public Person(string name, int age) {
this.Name = name;
this.Age = age;
}
}
var src = new { Name = "Mapster", Age = 3 };
var target = src.Adapt<Person>();
自动映射 Record 类型有一些限制:
- Record 类型属性必须没有
set
- 只有一个非空构造函数
- 构造函数中的所有参数名称必须与属性名称相同
如果不符合以上规则,需要增加额外的 MapToConstructor
配置
目前学习.NET Core 最好的教程 .NET Core 官方教程 ASP.NET Core 官方教程
如果您认为这篇文章还不错或者有所收获,您可以点击右下角的【推荐】支持,或请我喝杯咖啡【赞赏】,这将是我继续写作,分享的最大动力!
作者:玩双截棍的熊猫
声明:原创博客!请在转载时在文章开头注明本人博客地址。如发现错误,欢迎批评指正。凡是转载于本人的文章,不能设置打赏功能,如有特殊需求请与本人联系!