諾禾

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().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; }
///

/// 疏忽
/// 
[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 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().Mapper(t=>t.Person, p=>p.PersonId).ToList();
運用Mapper查詢一對多映射類型：

var results = context.Client.Queryable().Mapper(p => p.Employees, p => p.Employees.First().DeptId).ToList();
需求留意的是，這兩個是固定寫法。

其中，一對一請求必需從主對象開端查詢。所謂主對象就是必需持有一個外鍵指向另外一個表。

一對多請求從具備匯合屬性的那段（也就是其中的「一」）開端，關聯指示爲 匯合.First().外鍵 。

還有一點就是SqlSugar的導航屬性必需手動加載，不會自動加載進來，因此完整不會呈現深度遞歸的問題。

3. 總結這一篇咱們一同探究瞭如何自定義表和實體類之間的映射關係，下一篇將爲你們寫一個適用的模板類，包括數據庫根本查詢功用。以上是本篇內容，等待後續哦～