好久沒有寫文章，工作甚忙，但每日還是關注.NET領域的開源專案。五一休息，放鬆了一下之後，今天就給大家介紹一個輕量級的物件對映工具Tiny Mapper：號稱是.NET平臺最快的物件對映元件。那就一起看看呢。

臨時更新：感謝@ 的意見，為了避免新手誤解，這裡說明一下，Tiny Mapper的對映關係在Bind的時候，其實是將對映關係儲存在一個靜態的私有字典中，大家在使用的時候可以不需要每次都配置或者Bind。方法比較靈活，例如：你可以在實體類中封裝一個方法，在方法內部進行對映關係的配置；你還可以將系統所有的配置對映關係放在一起，在使用前初始化一次就可以了。

1.Tiny Mapper基本介紹

    Tiny Mapper是一個.net平臺開源的物件對映元件。說到.NET平臺的物件對映，大名鼎鼎的可能就是AutoMapper。那先看看Tiny Mapper的特點

1.1 難以置信的快速

    這是Tiny Mapper標榜最大的特點之一：快。那究竟有多快，我們看看官方的測試截圖，由於時間緊張，我沒有進行測試對比，有空試試。

1.2 非常容易使用

    使用TinyMapper非常簡單，它的設計簡單，使用NuGet包，可以快速安裝使用，DLL也才50K大小不到，所以非常輕量級。

1.3 開源

    TinyMapper是一個開源專案，所以你可以參與更新和自己修改程式碼。 

2.Tiny Mapper 基本使用

    首先，通過NuGet下載安裝Tiny Mapper，如下圖：

    然後新增引用：

using Nelibur.ObjectMapper;
using Nelibur.ObjectMapper.Bindings;

    接下來，我們準備2個要相互對映的型別，Person和PersonDto，結構分別如下：

public class Person
{
	public String Id { get; set; }
	public String Name { get; set; }
	public Int32 Age { get; set; }
}
public class PersonDto
{
	public String Id { get; set; }
	public String Name { get; set; }
	public Int32 Age { get; set; }
}

    那我們在程式碼例如如何把其中一個類Person的物件對映為PersonDto呢？看看Tiny Mapper的使用，很簡單就2行：

/// <summary>最簡單的2個型別之間的對映</summary>
static void Test1()
{
	TinyMapper.Bind<Person,PersonDto>();
	//例項化一個Person物件
	var person = new Person
	{
		Id = Guid.NewGuid().ToString(),
		Name = "John",
		Age = 22
	};  
	//對映
	var personDto = TinyMapper.Map<PersonDto>(person);
}

    執行看看結果：

3.Tiny Mapper 指定配置使用

有時候物件的欄位名稱並不一樣，而且可能要忽略某些欄位，這個時候就要使用更加靈活的配置了。

看例子，為了演示，我們特意修改2個型別的欄位名稱不一樣.如下：

public class Person
{
	public String Id { get; set; }
	public String Name { get; set; }
	public Int32 Age { get; set; }
	
}
public class PersonDto
{
	public String Id { get; set; }
	//注意這裡的欄位名稱:UserName
	public String UserName { get; set; }
	public Int32 Age { get; set; }	
}

    對映程式碼和配置如下所示：

/// <summary>使用配置項指定和忽略欄位</summary>
static void Test2()
{
	TinyMapper.Bind<Person, PersonDto>(config =>
	{
		config.Ignore(x => x.Id);//忽略ID欄位
		config.Bind(x => x.Name, y => y.UserName);//將源型別和目標型別的欄位對應繫結起來
		config.Bind(x => x.Age, y => y.Age);//將源型別和目標型別的欄位對應繫結起來
	});
	var person = new Person
	{
		Id = Guid.NewGuid().ToString(),
		Name = "John",
		Age = 22
	};
	var personDto = TinyMapper.Map<PersonDto>(person);
}

    看看效果如何？我們指定的Id欄位忽略對映，以及將源物件的欄位對映到目標物件的指定欄位了:

4.Tiny Mapper複雜型別使用

    有時候物件的型別裡面巢狀著物件，或者陣列等等，其實這個時候的使用和上述完全一樣，這裡只是舉個例子，大家看看而已：

public class Person
{
	public String Id { get; set; }
	public String Name { get; set; }
	public Int32 Age { get; set; }
	public Address Address { get; set; }
	public List<String> Emails { get; set; }
}
public class PersonDto
{
	public String Id { get; set; }
	public String UserName { get; set; }
	public Int32 Age { get; set; }
	public Address Address { get; set; }
	public List<String> Emails { get; set; }
}
public sealed class Address
{
	public string Phone { get; set; }
	public string Street { get; set; }
	public string ZipCode { get; set; }
}

    對映的程式碼和第3節類似：

/// <summary>更復雜物件的對映例子</summary>
static void Test3()
{
	TinyMapper.Bind<Person, PersonDto>(config =>
	{
		config.Ignore(x => x.Id);//忽略ID欄位

		//將源型別和目標型別的欄位對應繫結起來
		config.Bind(x => x.Name, y => y.UserName);
		config.Bind(x => x.Age, y => y.Age);
		config.Bind(x => x.Address, y => y.Address);
		config.Bind(x => x.Emails, y => y.Emails);
	});
	var person = new Person
	{
		Id = Guid.NewGuid().ToString(),
		Name = "John",
		Age = 22,
		Address = new Address() { Phone = "1880393", Street = "Shanghai", ZipCode = "121212" },
		Emails = new List<string>() { "[email protected]", "[email protected]" }
	};
	var personDto = TinyMapper.Map<PersonDto>(person);
}

效果如下：

5.資源