Stackoverflow/dapper的Dapper-Extensions用法(二)
2015-07-03 18:44
453 查看
之前翻译了Dapper-Extensions项目首页的readme.md,大家应该对这个类库的使用有一些了解了吧,接下来是wiki的文档翻译,主要提到了AutoClassMapper、KeyTypes、Predicates System的高级用法用法。
若不熟悉Dapper及Dapper-Extensions的,请移步:
《Dapper的基本使用》:http://www.cnblogs.com/Sinte-Beuve/p/4231053.html
《Stackoverflow/dapper的Dapper-Extensions用法(一)》:http://www.cnblogs.com/Sinte-Beuve/p/4612971.html
(扩展)《利用Dapper ORM搭建三层架构》:http://www.cnblogs.com/Sinte-Beuve/p/4230943.html
约定条件如下:
AutoClassMapper假定数据表名与POCOs名一致(Ex: Car table name and Car POCO name).。
每个POCOs必须包含一个属性名为Id或以Id结尾的。
如果有多个属性以Id结尾,Dapper Extensions会使用第一个"Id"属性作为主键。
如果Id属性的类型为整形,则它的 KeyType属性会被设成Identity。
如果Id属性的类型为GUID,则它的 KeyType属性会被设成GUID。
如果Id属性的类型为其他类型,则它的 KeyType属性会被设成Assigned。(此类型为用户自定义主键)。
通俗的话来讲,就是说数据库表名和POCOs的命名可能会因为英文语义或者说文化等的影响而不同,这时候Dapper Extensions提供给我们PluralizedAutoClassMapper,提供一些转换的规则。例如Person和Person。
下面的例子,使用CustomPluralizedMapper对来Person到Persons数据表进行映射。如果不重写,PluralizedAutoClassMapper默认会把Person映射到People表。
全局配置:
下列KeyTypes是可用的:
下面的已给例子,我们返回Active值为true的所有Persons。
Code
Generated SQL
IN Clause TODO: Demonstrate that you can pass an IEnumerable as the value to acheive WHERE x IN ('a','b') functionality
如果每个谓词组都实现了IPredicate,那么多谓词可以被同时添加到一起。
下面的例子,我们建立一个通过AND操作符连接的谓词组。
Code
Generated SQL
在下面的例子中,我们创建两个谓词组,并且把它们组合在第三个谓词组中。
Code
Generated SQL
以上就是Dapper-Extensions所有的文档了。
若不熟悉Dapper及Dapper-Extensions的,请移步:
《Dapper的基本使用》:http://www.cnblogs.com/Sinte-Beuve/p/4231053.html
《Stackoverflow/dapper的Dapper-Extensions用法(一)》:http://www.cnblogs.com/Sinte-Beuve/p/4612971.html
(扩展)《利用Dapper ORM搭建三层架构》:http://www.cnblogs.com/Sinte-Beuve/p/4230943.html
AutoClassMapper
在不确定的情况下Dapper Extensions使用一个默认的ClassMapper(AutoClassMapper)来处理POCO和数据表之间的映射。ClassMapper非常重要,它可以保证POCOs的纯净,不需要增加额外的attribute。你可以通过继承ClassMapper来自定义自己的映射规则去改变Dapper Extensions的行为。(这边我觉得文档有些问题,应该是继承AutoClassMapper,因为DefaultMapper是用来设置全局的映射器的而不是单表的自定义。)DapperExtensions.DapperExtensions.DefaultMapper = typeof(MyCustomClassMapper<>);
AutoClassMapper Assumptions
默认的AutoClassMapper是建立在数据库与POCOs之间有一定约束的条件下才可以工作的。约定条件如下:
AutoClassMapper假定数据表名与POCOs名一致(Ex: Car table name and Car POCO name).。
每个POCOs必须包含一个属性名为Id或以Id结尾的。
如果有多个属性以Id结尾,Dapper Extensions会使用第一个"Id"属性作为主键。
如果Id属性的类型为整形,则它的 KeyType属性会被设成Identity。
如果Id属性的类型为GUID,则它的 KeyType属性会被设成GUID。
如果Id属性的类型为其他类型,则它的 KeyType属性会被设成Assigned。(此类型为用户自定义主键)。
Customized PluralizedAutoClassMapper
英语有很多多元化(pluralization)的规则,PluralizedAutoClassMapper会提供给我们一些正确的多元化命名为任何可能的场景。但是仍然有很多情况,当你的数据库表名和默认的Dapper Extensions的多元化规则不相匹配时,你可以自定义该类,注入自己的规则。通俗的话来讲,就是说数据库表名和POCOs的命名可能会因为英文语义或者说文化等的影响而不同,这时候Dapper Extensions提供给我们PluralizedAutoClassMapper,提供一些转换的规则。例如Person和Person。
下面的例子,使用CustomPluralizedMapper对来Person到Persons数据表进行映射。如果不重写,PluralizedAutoClassMapper默认会把Person映射到People表。
public class CustomPluralizedMapper<T> : PluralizedAutoClassMapper<T> where T : class { protected override void Table(string tableName) { if(tableName.Equals("Person", StringComparison.CurrentCultureIgnoreCase)) { TableName = "Persons"; } base.Table(tableName); } }
全局配置:
DapperExtensions.DapperExtensions.DefaultMapper = typeof(CustomPluralizedMapper<>);
KeyTypes
KeyType这个enum允许Dapper Extensions知道如何去映射POCOs的主键。当你的POCOs被Dapper Extensions检查后,映射关系将被建立和缓存下下来。这个类型映射用于生产合适的SQL语句来进行子查询的调用。举个例子,在不确定的情况下,Dapper-Extensions必须知道哪一个属性是POCOs的标识。下列KeyTypes是可用的:
public enum KeyType { NotAKey, Identity, Guid, Assigned }
NotAKey
非主键属性映射到该枚举值。Identity
任何整形的主键将被映射成这个枚举值。Guid
Guid类型的主键属性被映射成这个枚举值。这个标识会使得Dapper Extensions在数据库执行插入命令前先生成一个新的Guid值。Dapper-Extensions生成COMB(see: GetNextGuid)Assigned
任意非Guid和整形的主键将会映射到该枚举值。这个标识会使得Dapper Extensions在数据库执行插入命令前不会生成一个key。再者,Dapper-Extensions在插入后不会获得任意一个键的值,总而言之,这个是由开发者决定的。即自定义主键值或者是联合主键时的标识。Predicates
谓词系统在Dapper-Extensions中是非常容易去使用的。现在我们使用下面这个Model来展开它的用法。public class Person { public int Id { get; set; } public string FirstName { get; set; } public string LastName { get; set; } public bool Active { get; set; } public DateTime DateCreated { get; set; } }
Simple FieldPredicate Operation
为了创建一个简单的谓词,我们仅仅创建一个字段谓词并且把它传给查询操作。FieldPredicate需要一个一般的类型,允许使用强类型。下面的已给例子,我们返回Active值为true的所有Persons。
Code
using (SqlConnection cn = new SqlConnection(_connectionString)) { cn.Open(); var predicate = Predicates.Field<Person>(f => f.Active, Operator.Eq, true); IEnumerable<Person> list = cn.GetList<Person>(predicate); cn.Close(); }
Generated SQL
SELECT [Person].[Id] , [Person].[FirstName] , [Person].[LastName] , [Person].[Active] , [Person].[DateCreated] FROM [Person] WHERE ([Person].[Active] = @Active_0)
IN Clause TODO: Demonstrate that you can pass an IEnumerable as the value to acheive WHERE x IN ('a','b') functionality
Compound Predicate (Predicate Group)复合谓词
复合谓词谓词可以通过谓词组来实现。对于每个谓词组,你必须选择一个操作符(AND/OR),每个被添加到组中的谓词将会被加入具体的操作。如果每个谓词组都实现了IPredicate,那么多谓词可以被同时添加到一起。
下面的例子,我们建立一个通过AND操作符连接的谓词组。
Code
using (SqlConnection cn = new SqlConnection(_connectionString)) { cn.Open(); var pg = new PredicateGroup { Operator = GroupOperator.And, Predicates = new List<IPredicate>() }; pg.Predicates.Add(Predicates.Field<Person>(f => f.Active, Operator.Eq, true)); pg.Predicates.Add(Predicates.Field<Person>(f => f.LastName, Operator.Like, "Br%")); IEnumerable<Person> list = cn.GetList<Person>(pg); cn.Close(); }
Generated SQL
SELECT [Person].[Id] , [Person].[FirstName] , [Person].[LastName] , [Person].[Active] , [Person].[DateCreated] FROM [Person] WHERE (([Person].[Active] = @Active_0) AND ([Person].[LastName] LIKE @LastName_1))
Multiple Compound Predicates (Predicate Group)
只要每个谓词组都实现了IPredicate,你可以创建复杂的复合谓词,并把它们联合起来。在下面的例子中,我们创建两个谓词组,并且把它们组合在第三个谓词组中。
Code
using (SqlConnection cn = new SqlConnection(_connectionString)) { cn.Open(); var pgMain = new PredicateGroup { Operator = GroupOperator.Or, Predicates = new List<IPredicate>() }; var pga = new PredicateGroup { Operator = GroupOperator.And, Predicates = new List<IPredicate>() }; pga.Predicates.Add(Predicates.Field<Person>(f => f.Active, Operator.Eq, true)); pga.Predicates.Add(Predicates.Field<Person>(f => f.LastName, Operator.Like, "Br%")); pgMain.Predicates.Add(pga); var pgb = new PredicateGroup { Operator = GroupOperator.And, Predicates = new List<IPredicate>() }; pgb.Predicates.Add(Predicates.Field<Person>(f => f.Active, Operator.Eq, false)); pgb.Predicates.Add(Predicates.Field<Person>(f => f.FirstName, Operator.Like, "Pa%", true /* NOT */ )); pgMain.Predicates.Add(pgb); IEnumerable<Person> list = cn.GetList<Person>(pgMain); cn.Close(); }
Generated SQL
SELECT [Person].[Id] , [Person].[FirstName] , [Person].[LastName] , [Person].[Active] , [Person].[DateCreated] FROM [Person] WHERE ((([Person].[Active] = @Active_0) AND ([Person].[LastName] LIKE @LastName_1)) OR (([Person].[Active] = @Active_2) AND ([Person].[FirstName] NOT LIKE @FirstName_3)))
PropertyPredicate
TODOExists Predicate
var subPred = Predicates.Field<User>(u => u.Email, Operator.Eq, "someone@somewhere.com"); var existsPred = Predicates.Exists<User>(subPred); var existingUser = cn.GetList<User>(existsPred , null, tran).FirstOrDefault();
以上就是Dapper-Extensions所有的文档了。
相关文章推荐
- 【iOS开发系列】更换头像(相机、相册)
- android Handler 消息传递机制
- Android自定义带消息提醒控件
- 【iOS开发系列】隐藏状态栏
- android Intent几种常见的flags
- iOS Code Signing 学习笔记
- android音乐播放器开发 SweetMusicPlayer 智能负载直插式歌词
- android Activity的四种launchMode
- device mapper的使用
- unity里利用C# 读写XML
- [转] iOS开发之使用lipo命令制作模拟器与真机通用静态库
- ios说说自己的计划是什么样的发展论坛
- Objective-C(十、NSRange,point,size,rect,NSNumber,NSValue,NSNull)——iOS开发基础
- iOS基本内存管理:autorelease和autoreleasepool
- 六款值得推荐的android(安卓)开源框架简介
- iOS线程池
- GitHub上最火的40个Android开源项目
- 关于WrapPanel和RadioButton相互配合使用实WrapPanel现动态添加或删除项
- unity3D粒子系统基础属性
- com.android.support:appcompat-v7:21.+