0.前言

在上一篇中，我們知道了如何使用SqlSugar，但是也只是簡單的了解了如何使用，仿佛是套著鐐銬行走，這明顯不符合一個合格的程式員應有的素養，所以，這一篇我們將對其進行深挖，探究其背后的秘密，

1. 花式映射

在實際開發中，程式中的物體類和資料庫的表名并不能完全一致，造成的原因有很多，例如說團隊對資料庫的命名和對程式的命名有著不同的要求，資料庫是先建立的而程式是后開發的，又或者是程式只使用了資料庫中一部分表等等，

這時候就會與C#約定優于配置相違背，但是這也符合C#的設計哲學，因為配置也是C#的一部分，我們該如何從實際角度來完成表與物體類之間的關系建立呢？

那就讓我來帶著大家一起看看SqlSugar是否能優雅的完成這一部分：

1.1 Attribute設定

SqlSugar預制了一些Attribute，允許我們通過Attribute來為物體表與資料庫表之間建立關系：

• SugarTable：用來定義物體類映射的資料表

public SugarTable(string tableName);
public SugarTable(string tableName, string tableDescription);

這是SugarTable的兩個建構式，允許設定表名和資料表描述

• SugarColumn：用來定義屬性與資料表中的列的關系

public string ColumnDataType { get; set; }// 列的資料型別，填SQL 的資料型別
public string OldColumnName { get; set; }// 當做了表更新之后，用來生成資料庫用，此處填寫原列名
public bool IsNullable { get; set; }// 設定列是否允許為NULL
public int Length { get; set; } // 設定列的資料長度
public string ColumnDescription { get; set; }// 設定列的描述名稱
public bool IsIdentity { get; set; } 		// 設定該列是否是自增列
public bool IsPrimaryKey { get; set; }		//設定該列是主鍵
public bool IsIgnore { get; set; }			// 不作資料庫操作，true將不會進行查詢、添加等操作
public string ColumnName { get; set; }		// 設定對應的列名
public string DefaultValue { get; set; }	// 設定該列的默認值

SqlSugar的Attribute配置非常的簡單，只需要針對類與表的映射和屬性對列的映射做出配置即可，

1.2 動態配置

與EF等一樣，SqlSugar也支持動態配置，那么就跟著我一起去看看，如何實作動態配置吧：

SqlSugar支持的動態配置功能較少，最好是預先設計好了資料庫，然后使用動態配置做好關聯，

通過SugarClient設定資料表的動態配置：

Client.MappingTables.Add

方法有：

public void Add(string entityName, string dbTableName);
public void Add(string entityName, string dbTableName, string dbTableShortName);
public void Add(MappingTable table);

然后通過SugarClient設定列的動態配置：

Client.MmappingColumn.Add

方法有：

public void Add(string propertyName, string dbColumnName, string entityName);
public void Add(MappingColumn col);

顯然，動態配置并不支持設定列的其他內容，當然，SugarClient還可以配置忽略欄位：

Client.IgnoreColumns.Add

具體實作方法如下：

public void Add(string propertyName, string EntityName);
publiv void Add(IgnoreColumn col);

1.3 As 別名模式

SqlSugar在增刪改查的時候，為資料物體添加了別名處理，使用方法As(string newName)即可，

Queryable<T>().As("newName")   //select * from newName
Insertable
Updateable
Deleteable

類似與SQL的別名查詢

2. 外鍵關聯

SqlSugar中并沒有設定導航屬性的正式加載，而是添加了一個Mapper方法：在查詢的時候，呼叫Mapper映射外鍵關系，以達到導航屬性一起加載的功能，

首先需要注意的是，在SqlSugar中導航屬性需要配置為忽略，避免被直接決議為SQL，否則會提示Sequence contains no elements，

添加幾個示例類：

[SugarTable("P_Person")]
public class Person
{
    [SugarColumn(IsPrimaryKey = true, IsIdentity = true)]
    public int Id { get; set; }
    public string Name { get; set; }
    public int Age { get; set; }
    /// <summary>
    /// 忽略
    /// </summary>
    [SugarColumn(IsIgnore = true)]
    public Employee Employee { get; set; }
}

public class Employee
{
    [SugarColumn(IsPrimaryKey = true, IsIdentity = true)]
    public int Id { get; set; }
    public string Name { get; set; }
    public int PersonId { get; set; }
    [SugarColumn(IsIgnore = true)]
    public Person Person { get; set; }
    public int DeptId{get;set;}
    [SugarColumn(IsIgnore = true)]
    public Dept Dept{get;set;}
}

public class Dept
{
    [SugarColumn(IsPrimaryKey = true, IsIdentity = true)]
    public int Id { get; set; }
    public string Name { get; set; }
	[SugarColumn(IsIgnore = true)]
    public List<Employee> Employees{get;set;}
}

使用上一篇的Context類：

public class DefaultContext
{
    public SqlSugarClient Client { get; }

    public DefaultContext(string connectionString, DbType dbType)
    {
        Client = new SqlSugarClient(new ConnectionConfig
		{
            ConnectionString = connectionString,//"Data Source=./demo.db",
            DbType = dbType,
            IsAutoCloseConnection = true,
            InitKeyType = InitKeyType.Attribute
        });
        // == 新增

        Client.CodeFirst.InitTables<Person, Employee, Dept>();
        Client.Aop.OnLogExecuting = (sql, paramters) => 
        {
            Console.WriteLine(sql);
        };
    }
}

簡單介紹一下，

InitTables這個方法，SqlSugar提供了很多多載版本，但推薦使用以下三個：

void InitTables(string entitiesNamespace);
void InitTables(string[] entitiesNamespaces);
void InitTables(params Type[] entityTypes);

前兩個，可以約定物體類的命名空間，然后一次性初始化所有物體類，第三個初始化傳入的物體型別別實體，也可以 根據一定規則反射遍歷出需要的類，

OnLogExecuting是SqlSugar 的一個監聽事件（雖然它不是事件，但我個人覺得寫成事件模式比較好），作用是監控框架執行的SQL陳述句，可以用來除錯或者做日志監控等，

使用Mapper查詢一對一映射型別：

var results = context.Client.Queryable<Employee>().Mapper(t=>t.Person, p=>p.PersonId).ToList();

使用Mapper查詢一對多映射型別：

var results = context.Client.Queryable<Dept>().Mapper(p => p.Employees, p => p.Employees.First().DeptId).ToList();

需要注意的是，這兩個是固定寫法，

其中，一對一要求必須從主物件開始查詢，所謂主物件就是必須持有一個外鍵指向另一個表，

一對多要求從擁有集合屬性的那段（也就是其中的“一”）開始，關聯指示為 集合.First().外鍵 ，

還有一點就是SqlSugar的導航屬性必須手動加載，不會自動加載進來，所以完全不會出現深度遞回的問題，

3. 總結

這一篇我們一起探索了如何自定義表和物體類之間的映射關系，下一篇將為大家寫一個實用的模板類，包括資料庫基本查詢功能，以上是本篇內容，期待后續哦～

更多內容煩請關注我的博客《高先生小屋》

標籤：C#

上一篇：【VS】Visual Studio 就可以反編譯查看原始碼了，再見了 Reflector

下一篇：C# List轉換成DataTable