发现很少有人使用微软SqlHelper,大多数人都是自己实现或把微软的进行阉割。其原因大概有以下几个:
1、有些人认为微软的SqlHelper很多东西没有必要,担心影响性能。
2、微软的SqlHelper有60多个方法,加上缓存类有70多个。由于类的方法的低耦合使得源码阅读困难。
3、自己实现也不难,因为是自己写的,使用时思路更清晰,而且改动更灵活。
那是因为很多人看到这么多方法给吓着了,根本没有把源码从头到尾认真看一遍。就算看也是看几个方法就看晕了,一大堆方法重载,各方法之间相互引用。
很不幸,本人就是看了几次到中途就绕晕了的人。每当被绕晕的时候就总觉得,太没必要了,微软把简单的东西给搞得这么复杂,自己写的简单完全能满足要求,就放弃了。
可前两天发生一件事,让我觉得是应该好好看看微软的原版了,于时就有了下面这些笔记。
一、SqlHelper是密封类,并且不能实例化。
注意:微软的SqlHelper类中并没有读写配置文件的代码,像这样“public static string ConnectionString = ConfigurationManager.ConnectionStrings["connstring"].ConnectionString;”。甚至,在类库要通过添加.net组件System.Configuration才能使用ConnectionManager类,其原因就是它使SqlHelper的可移植性变差。你想想,如果没有这行代码,我把SqlHelper编译成DLL文件,那么这个DLL在别的项目添加组件引用就可以使用了。如果有了这行代码,编译成DLL文件,在别的项目除了添加引用外,还要在配置文件添加一个连接字符串,这个连接字符的名字是什么呢?一般这个连接字符串的名称通过文档或口述方式获取,如果在传输过程中丢失了,那这个DLL还怎么用。
二、对方法进行分类
这样分一下类,应该清晰多了吧?(图中用红线圈的2区5个方法是对红线1区5个方法的补充,一一对应。后面详细讲解它们之间的关系。)
从图中我们看到,SqlHelper是由两上类组成的,一个是真正的SqlHelper内,另一个是辅助类,为查询操作提供缓存。
为了简便,我们先抛开缓存类,那么SqlHelper类可以分为两部分,私有方法和公开方法。
注意:用蓝线圈出来的是OleDb下没有ExecuteXmlReader方法,即:你要把这个类改成OleDb的去掉蓝线圈的几个方法。
三、各个击破之私有方法
SqlHelper类中私有方法只有5个,有1个私有的枚举。不多!
但是我们从下面这张图可以看出它们的重要性
其中图中最左边两个是“AssignParameterValues”方法(2重载),作用是为参数列表赋值。
从右到左第二列的那个是“
PrepareCommand ”方法,从图中可看到它的地位可不一般,几乎所有的类到最后都要调用它。其实它是职责是为执行命令作准备工作,比如最常见的打开数据库连接就在其中完成。它旁边那个是它的小弟,作用是为命令添加参数。
最上面那一个是“
ExecuteReader ”,是数据阅读器都最终都是调用了它。它和其他4个有些区别,注意区分。
四、各个击破之公共方法
这个太多,我们以以其中一个为准,详细说明,其余的以此类推。
前面第二节我们说:“图中用红线圈的2区5个方法是对红线1区5个方法的补充,一一对应”,
我们这以第一个方法为例(上图中行号176——417的9个重载+行号1782——1867的三个方法),看看微软是怎么重载的。
文字一大堆,不如来个表格直观,各方法要求参数如下:
方法名称 | 连接类型 | 执行T-SQL语句 | 存储过程 | 参数(带*号的为可null) | |
1 | ExecuteNonQuery | 字符串 | Yes | Yes | No |
2 | ExecuteNonQuery | 字符串 | Yes | Yes | Yes* |
3 | ExecuteNonQuery | 字符串 | No | Yes | Yes* |
4 | ExecuteNonQuery | 连接对象 | Yes | Yes | No |
5 | ExecuteNonQuery | 连接对象 | Yes | Yes | Yes* |
6 | ExecuteNonQuery | 连接对象 | No | Yes | Yes* |
7 | ExecuteNonQuery | 事务 | Yes | Yes | No |
8 | ExecuteNonQuery | 事务 | Yes | Yes | Yes* |
9 | ExecuteNonQuery | 事务 | No | Yes | Yes* |
10 | ExecuteNonQueryTypedParams | 字符串 | No | Yes | Yes |
11 | ExecuteNonQueryTypedParams | 连接对象 | No | Yes | Yes |
12 | ExecuteNonQueryTypedParams | 事务 | No | Yes | Yes |
看到没有,方法虽多,但没有重复的吧。你可能会说,怎么没重复的,第一个和第二个就重复了,调用第二个方法如果没参数传个null不就和第一个方法重复了么?
其实,重载了这么多就是为了消除可null参数,也就是说,在外部调用SqlHelper中方法时永远不要为参数传递null值,如果不是为了这点,上面的12个方法完全可以压缩成2个。
不信,我们就来试试看,是不是能压缩成2个方法。先看张图片
这张图是总图的部分放大,由图我们可以清楚的看到12个方法的引用关系,可以看到1、2、3、4、6、10、11最终都调用了5,12、7、9最终都调用了8.
也就是说,如果可以参数可以传null的话,我们只需要5和8两个方法就行了(一个执行普通连接,一个执行事务)。
由此可以推出,如果是全图的话,就只要右边三列的方法就可以了,其余左边三列都是对右边三列的包装。
为什么不能使用可空参数?和前面提到的不推荐读配置文件是一个道理,为了可移植性。因为在SqlHelper发布成DLL后,调用时如何知道那些参数可接受null值那些参数不可接受null值呢!
到此为止吧,剩下的按也就是按这个思路来就行了,
最后补充一点,读源码的时候在重载方法的XML注释进行编号,容易阅读。不然光靠参数来分辨容易搞晕。
像这样,结合上面的表格,就清楚的知道了第一个方法引用的是第二个方法。