DbUtility v3 背后的故事

时间

  • DbUtility v3构思了差不多大半年,真正开发到第一个版本发布到NuGet却只花了50天。中途大量时间在完善 Jumony 3,只有三周来开发DbUtility v3,其中总工时大概不超过20个小时。

  • DbUtility项目开始于2003年,2005年增加了实体转换的支持,2007年因为LINQ的发布,认为这个项目将来不会再有更新,遂开源,也是我开源的第一个项目,当时托管于Codeplex。

  • 每当我要快速搞定一个事情的时候,DbUtility总是最称手的工具,事实上在2007年之后DbUtility有四年没有任何修改,因为我觉得没有什么新的功能需要。

  • 如果不是眼馋.NET Framework 4.5新增的异步支持以及越来越多需要定制化查询结果(例如包装成Dictionary)的需求,DbUtility可能到现在都不会重写。

设计

  • DbUtility v3花了很长的时间来构思他的API设计,希望既能兼容之前的形式,保持简洁,流畅的特点,又利于扩展。下了很大的决心才最终敲定db.T( xxx ).ExecuteXXX()这样的形式,这与之前是不兼容的,所以新发布了一个NuGet包,避免原来的项目升级大面积的编译错误。

  • 利用扩展方法实现的API具有可以自行扩展以及整体切换的特点。这一风格是Jumony首创的,DbUtility把这个手法运用的更为娴熟了。

  • 同样花了很长的时间才敲定同时提供T和Template两个一模一样的方法,事实上T是Template的缩写。虽然具备智能提示可以非常便捷的输入Template,但我仍然认为,T这样的缩写,可以最大限度减少代码的行宽,不带来额外的噪声污染。

  • db.T( xxx )将不会执行查询,必须使用db.T( xxx ).ExecuteNonQuery()一直是整个设计中的一大痛处,因为可能会忘记写.ExecuteNonQuery。但是的确没有办法解决。

  • DbUtility的结果构建器,即ExecuteXXX方法,原本为了简洁是打算去掉Execute前缀的,例如:db.T( “SELECT * FROM Users” ).ExecuteEntities()原本是打算写成db.T( “SELECT * FROM Users” ).Entities()。但是由于考虑到某些查询构建器(即T(xxx))可能难以在一个方法内写完,需要多次调用构建最终的查询,此时执行查询的方法和构建查询的方法将没有明显的区分,故而依然保留Execute这个前缀。

    • 譬如说db.Table( "Users" ).Fields( "*" ).ExecuteEntities<User>()
  • 得益于新的架构设计,Jumony的结果构建器扩展方法写起来非常简单,所以我一口气提供了十几个用于构建不同类型结果的扩展方法。

技术

  • DbUtility拥有理论上性能最好的实体转换器,其原理是根据实体类型直接Emit一个转换器方法出来进行实体转换,而Emit出来的这个方法则巧妙地利用类型字典被缓存。这两项技术都是.NET的不传之秘,较之不使用这两项技术的实现方式性能不在一个数量级。

  • DbUtility的API将C#的泛型和类型推断运用到了极致,事实上诸如T这样的扩展方法,接受的第一个参数的类型是IDbExecutor,而SqlDbUtiltiy类型恰好实现了这个接口,所以可以调用。也就是说如果哪个数据库的查询器不支持参数化查询(没有实现这个借口),那么就点不出T出来。更神奇的是如果数据库查询器不支持异步查询,那么所有的异步API也会自动消失。

  • DbUtility的异步API实现贯彻了许多可以异步的地方,如打开数据库连接,执行查询。目前只剩下DataReader.Read方法没有调用异步版本,这将在后面的更新中解决。DbUtility恐怕也是第一个实现异步API的数据库访问帮助器。

  • Java移植项目在充分利用C#语法特性上简直令人发指,各种莫名其妙不符合.NET命名规则的API搞得各种乌烟瘴气。而DbUtility不仅仅充分利用了泛型、扩展方法一系列特性,更提供了运算符重载,可以非常直观的把参数化查询像拼接字符串一样拼接起来。

  • 在开发DbUtility v3的时候的确考虑过推出一个面向.NET Framework 3.5的版本,但是因为要同时维护两个版本过于费力。且DbUtility并非我的重心,故而作罢。但事实上删除DbUtility内所有的异步API,便可以得到在3.5下编译通过的代码。

 

优势

很多人会问我,DbUtility的优势在哪里?

事实上我一点儿都不想讨论这个问题,从根本上来说,DbUtility仅仅只是因为用了太多年非常顺手所以改进了一下让其与时俱进而已。

由于是超轻量级的数据库访问框架,代码量甚至都不过千行,可以说大家都是一样的,半斤八两没有区别。除非哪个不用Emit来做实体转换(这种垃圾应该赶紧扔掉)会造成性能下降。

但是总的来说,DbUtility仍然有一些特有的东西是其他轻量级框架难以企及的:

异步数据库查询
DbUtility v3率先推出了异步数据库查询实现,并将在后面不断完善。
可扩展的API
DbUtility v3采用了和Jumony项目一样的可扩展API设计,任何人任何第三方都可以在不修改现有代码之下对现有API进行扩展。
可替换和自定义的API
不仅仅是可以扩展现有API,甚至可以把整个API给替换掉。简单来说,如果你喜欢,甚至可以把DbUtility的API给换成Dapper一模一样的,但最终还是以DbUtility的核心在驱动。
参数化查询抽象
在v3的设计中,增加了抽象的参数化查询对象,参数化查询对象是与数据库无关的,在支持参数化查询的数据库,将会尝试采用参数化查询。而在不支持参数化查询的数据库,则尝试将参数值进行相应处理,以避免注入式问题。
结构化查询抽象
在将来,DbUtility 还将增加结构化查询抽象,将SQL查询抽象为语法树,通过方法来构建。在执行时再根据实际的数据库转换为相应的语法查询。
查询执行器、查询、结果构建器分离架构
吸取之前的经验,新的架构可以使得三部分独立的扩展,和谐的统一。

事实上DbUtility是一个面向真正程序员的超轻量数据访问框架,其拥有极大的可扩展性,并且扩展起来极为简便。这是DbUtility相较于其他超轻量数据访问框架的最大优势。

未来

DbUtility 即将到来的功能包括:

  • 更丰富的配置项

    • 例如不要总是异步打开连接(因为连接池内很可能已经存在连接)
    • 查询超时时间
  • 更好的异步支持(异步的Read调用)
  • 更好的存储过程支持
  • 查询日志记录和查询事件追踪(例如执行了哪些查询,执行了多久)。

在未来的版本中将会添加:

  • 更多的数据库支持(譬如Excel?!)
  • 结构化的 SQL 查询构建工具
  • 自定义类型映射(例如XML字段映射到XDocument)

以及更多,,,,

 

参与

DbUtility是一个开源项目,其足够轻便和简单,所以参与到DbUtility的开发过程中也是非常简单的,您可以通过以下的方式来参与:

DbUtility v3 背后的故事的更多相关文章

  1. 更好的 java 重试框架 sisyphus 背后的故事

    sisyphus 综合了 spring-retry 和 gauva-retrying 的优势,使用起来也非常灵活. 今天,让我们一起看一下西西弗斯背后的故事. 情景导入 简单的需求 产品经理:实现一个 ...

  2. 背后的故事之 - 快乐的Lambda表达式(一)

    快乐的Lambda表达式(二) 自从Lambda随.NET Framework3.5出现在.NET开发者眼前以来,它已经给我们带来了太多的欣喜.它优雅,对开发者更友好,能提高开发效率,天啊!它还有可能 ...

  3. 背后的故事之 - 快乐的Lambda表达式(二)

    快乐的Lambda表达式 上一篇 背后的故事之 - 快乐的Lambda表达式(一)我们由浅入深的分析了一下Lambda表达式.知道了它和委托以及普通方法的区别,并且通过测试对比他们之间的性能,然后我们 ...

  4. ASP.NET Web API自身对CORS的支持: EnableCorsAttribute特性背后的故事

    从编程的角度来讲,ASP.NET Web API针对CORS的实现仅仅涉及到HttpConfiguration的扩展方法EnableCors和EnableCorsAttribute特性.但是整个COR ...

  5. DbUtility v3

    DbUtility v3 历史 七年前,也就是2007年,我在博客园写了一篇博文,开源并发布了恐怕是我第一个开源项目,DbUtility.其设计的初衷就是为了简化ADO.NET繁琐的数据库访问过程,提 ...

  6. printf背后的故事

    printf背后的故事 说起编程语言,C语言大家再熟悉不过.说起最简单的代码,Helloworld更是众所周知.一条简单的printf语句便可以完成这个简单的功能,可是printf背后到底做了什么事情 ...

  7. using关键字背后的故事!

    using关键字的作用: 1:可以引入命名空间2:可以释放资源 *****不能使用using语句完全替换掉(try-catch-finally)语句(无法进行异常处理) 在出了using语句的{}后, ...

  8. Mac OS X 背后的故事

    Mac OS X 背后的故事 作者: 王越  来源: <程序员>  发布时间: 2013-01-22 10:55  阅读: 25840 次  推荐: 49   原文链接   [收藏]   ...

  9. 联想手机#P1来了#P1背后的故事系列

    http://bbs.lenovo.com/forum.php?mod=viewthread&fid=928&tid=560992&extra=page%3D1 联想手机#P1 ...

随机推荐

  1. li进度条宽度和颜色按顺序显示的效果。

    实际项目中li和里边的数值是动态生成的,需要控制它的宽度和颜色,效果如图: 如果能实现颜色按数值规律变化就好了,目前颜色是固定到数组中的. 实例代码如下: <!DOCTYPE html>& ...

  2. CSS :first-child 选择器 和 HTML DOM firstChild 属性

    CSS 选择器参考手册 实例 选择属于其父元素的首个子元素的每个 <p> 元素,并为其设置样式: p:first-child { background-color:yellow; } 亲自 ...

  3. git下载指定版本的代码

    1. git fetch https://github.com/angular/angular.js.git v1.5.8 或 2. git pull https://github.com/angul ...

  4. Android 刷新相册

    Android4.4之前: sendBroadcast(new Intent(Intent.ACTION_MEDIA_MOUNTED,Uri.parse("file://" + f ...

  5. 实现Discuz论坛客户端应用源码

    通过使用该源码,开发者可以迅速地将Discuz论坛迁移到Android客户端中.不需要任何的开发工作即可拥有属于自己论坛的Android客户端 源码下载:http://code.662p.com/vi ...

  6. Android中的HTTP通信

    前言:近期在慕课网学习了慕课网课程Android中的HTTP通信,就自己总结了一下,其中参考了不少博文,感谢大家的分享. 文章内容包括:1.HTTP简介2.HTTP/1.0和HTTP/1.1之间的区别 ...

  7. [Unity游戏开发]向量在游戏开发中的应用(三)

    本文已同步发表在CSDN:http://blog.csdn.net/wenxin2011/article/details/51088236 在上一篇博客中讲了利用向量点乘在游戏开发中应用的几种情景.本 ...

  8. Linux Bond 技术学习资料

    Bond 技术原理 Bond 就是将多块网卡虚拟成为一块网卡的技术,通过 bond 技术让多块网卡看起来是一个单独的以太网接口设备并具有相同的 IP 地址. Bond 的原理是网卡在混杂 (promi ...

  9. RHEL 6.6安装桌面环境GNOME

    在测试服务器(Red Hat Enterprise Linux Server release 6.6)需要安装桌面系统环境,于是选择GNOME桌面环境安装. 一:检查系统的运行级别以及是否安装了桌面环 ...

  10. Linux监控工具介绍系列——free

    在Linux系统中,我们查看.监控系统内存使用情况,一般最常用的命令就是free.free命令其实非常简单,参数也非常简单,但是里面很多知识点未必你都掌握了.下面总结一下我所了解的free命令.如有不 ...