- 花式映射
在实践开发中，程序中的实体类和数据库的表名并不能完整分歧，形成的缘由有很多，例如说团队对数据库的命名和对程序的命名有着不同的请求，数据库是先树立的而程序是后开发的，又或者是程序只运用了数据库中一局部表等等。
这时分就会与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的别名查询
- 外键关联
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的导航属性必需手动加载，不会自动加载进来，所以完整不会呈现深度递归的问题。
- 总结
这一篇我们一同探究了如何自定义表和实体类之间的映射关系，下一篇将为大家写一个适用的模板类，包括数据库根本查询功用。以上是本篇内容，等待后续哦～