轻量ORM-SqlRepoEx （十五）最佳实践之数据映射(Map)
简介：sqlrepoex是 .net平台下兼容.net standard 2.0人一个轻型的orm。解决了lambda转sql语句这一难题，sqlrepoex使用的是lambda表达式，所以，对c#程序员来说，是非常简单的，其语法特点与linq to sql极为相似。不仅实现了完整的select、insert、update、delete等语句解析器，同时，也实现了select、where、order by等子句，这些语句与子句均支持导出sql语句，使得拼接复杂场景sql语句变得轻松，sqlrepoex很快其原生数据访问与dapper不相上下，sqlrepoex本身支持sql server与mysql方言，同时通过sqlrepoex.normal支持非方言sql。sqlrepoex没侵入性，仅通过简单的几个特性，就能让类与数据库关联起来；
*本系列以静态工厂为例；
*数据来源于northwind数据库；
*完整的代码见 https://github.com/azthinker/sqlrepoex2.0startguid https://gitee.com/azthinker/sqlrepoex2.0startguid
1、从 sqlrepoex 2.2.1 起，标识数据据字段的特性标识改为使用system.componentmodel.dataannotations中的声明，降低使用难度，当然 sqlrepoex 中自定义的特性依然是支持的。
2、只有以类属性定义的，才能作为数据字段使用， sqlrepoex 只反身属性。
3、sqlrepoex 不使用xml文件来映射关系
一、表名
1、如果不使用任何特性， sqlrepoex会将当前类名当成数名。
如：
public sealed class azproducts
{
...
}
会返回形如 select ... from azproducts
显然，azcategories在数据库中不存在，当然，如果类名与数据库中对应的表名一至，是可以不用标识的。
2、使用 table 特性，定义在system.componentmodel.dataannotations中
[table("products")]
public sealed class azproducts
{
...
}
会返回形如 select ... from products
3、使用 tablename特性，定义在sqlrepoex.core.customattribute中
[tablename("products")]
public sealed class azproducts
{
...
}
同样会返回形如 select ... from products
当然，使用哪种，按各自的喜好
二、关键字段
1、如果未使用任何特性，在使用，for() 方法时，不会自动的产生where条件语句。
[table("products")]
public sealed class azproducts
{
public int productid { get; set; }
...
}
当使用
azproducts azproducts = new azproducts { productname2 = "testvalue", productid = 82 };
var resultupdate = repository.delete().for(azproducts);
只会产生
delete [dbo].[products]
当然，这不所期望的
2、使用 key 特性 table 定义在system.componentmodel.dataannotations中
[table("products")]
public sealed class azproducts
{
[key]
public int productid { get; set; }
...
}
会返回形如 delete [dbo].[products] where [productid] = 82;
3、使用 keyfield 特性 table定义在sqlrepoex.core.customattribute中
[tablename("products")]
public sealed class azproducts
{
[keyfield]
public int productid { get; set; }
...
}
同样会返回形如 delete [dbo].[products] where [productid] = 82;
三、标识字段（自增字段）
1、如果未使用任何特性，在使用，for() 方法时，在增加操作时，不会返回自增自段的实际值。
[table("products")]
public sealed class azproducts
{
public int productid { get; set; }
...
}
当使用
azproducts azproducts = new azproducts { productname2 = "testvalue" };
var resultinsert = repository
.insert()
.for(azproducts);
只会产生
insert [dbo].[products]([productname],[supplierid],[categoryid],[quantityperunit],[unitprice],[unitsinstock],[unitsonorder],[reorderlevel],[discontinued])
values('testvalue',null,null,null,null,null,null,null,0);
2、使用 databasegenerated 特性，定义在system.componentmodel.dataannotations中
[table("products")]
public sealed class azproducts
{
[key]
[databasegenerated(databasegeneratedoption.identity)]
public int productid { get; set; }
...
}
会返回形如
insert [dbo].[products]([productname],[supplierid],[categoryid],[quantityperunit],[unitprice],[unitsinstock],[unitsonorder],[reorderlevel],[discontinued])
values('testvalue',null,null,null,null,null,null,null,0);
select [productid],[productname] as productname2,[supplierid],[categoryid],[quantityperunit],[unitprice],[unitsinstock],[unitsonorder],[reorderlevel],[discontinued]
from [dbo].[products]
where [productid] = scope_identity();
3、使用 identityfield 特性，定义在sqlrepoex.core.customattribute中
[tablename("products")]
public sealed class azproducts
{
[keyfield]
[identityfield]
public int productid { get; set; }
...
}
同样会返回形如
insert [dbo].[products]([productname],[supplierid],[categoryid],[quantityperunit],[unitprice],[unitsinstock],[unitsonorder],[reorderlevel],[discontinued])
values('testvalue',null,null,null,null,null,null,null,0);
select [productid],[productname] as productname2,[supplierid],[categoryid],[quantityperunit],[unitprice],[unitsinstock],[unitsonorder],[reorderlevel],[discontinued]
from [dbo].[products]
where [productid] = scope_identity();
四、非字段属性
1、如果未使用任何特性，如下面属性 public string supplier { get; set; }。此属性在数据库中无对应的字段
[table("products")]
public sealed class azproducts
{
[key]
[databasegenerated(databasegeneratedoption.identity)]
public int productid { get; set; }
public string supplier { get; set; }
...
}
当使用
var result = repository.query();
会产生形如
select productid,supplier ....
2、使用 notmapped 特性，定义在system.componentmodel.dataannotations中
[table("products")]
public sealed class azproducts
{
[key]
[databasegenerated(databasegeneratedoption.identity)]
public int productid { get; set; }
[notmapped]
public string supplier { get; set; }
...
}
当使用
var result = repository.query();
时，supplier 不会出现在查询语句中，但要注意，当使用选择器来查询时，何然会出现在select语句中；
如 var result = repository.query().select(c=>c.productid,c=>c.supplier);
3、使用 nondatabasefield 特性，定义在sqlrepoex.core.customattribute中
[tablename("products")]
public sealed class azproducts
{
[key]
[databasegenerated(databasegeneratedoption.identity)]
public int productid { get; set; }
[nondatabasefield]
public string supplier { get; set; }
...
}
当使用
var result = repository.query();
时，supplier 不会出现在查询语句中，但要注意，当使用选择器来查询时，何然会出现在select语句中；
如 var result = repository.query().select(c=>c.productid,c=>c.supplier);
五、指定属性对应的数据库字段名
有时，类属性名与数据库中的字段名不完全是一一对应的，所以需要指定实际字段名
使用 column 特性，定义在system.componentmodel.dataannotations中，sqlrepoex中没有对应的特性。
如下列类中的 productname2 属性，对应的数据库字段实为 productname
[tablename("products")]
public sealed class azproducts
{
[key]
[databasegenerated(databasegeneratedoption.identity)]
public int productid { get; set; }
[nondatabasefield]
public string supplier { get; set; }
[column("productname")]
public string productname2 { get; set; }
...
}