DbEntry 主页上已经有文档,虽然是写的英文,不过我的英文并不是很好,所以也都是很简单的,所以这一次准备写的两三篇文章,不准备全面介绍,也不准备按照原文档的顺序,而是以 DbEntry 的发展来简单介绍一下。
这第一篇先介绍一下执行 SQL。
DbEntry 开始于 2004 年,那个时候,还不是 ORM,开发它希望解决的问题是,简化执行 SQL,以及保证关闭数据库连接。
SqlConnection connection = new SqlConnection("connectionString");
connection.Open();
SqlCommand command = new SqlCommand("cmdText", connection);
command.ExecuteNonQuery();
command.Dispose();
connection.Close();
以上的代码能保证关闭数据库连接么?当然不能,只要 command 和 reader 执行中有任何一个异常,后面的关闭指令将不会被执行。所以正规的做法应该是:
using (SqlConnection connection = new SqlConnection("connectionString"))
{
connection.Open();
using (SqlCommand command = new SqlCommand("cmdText", connection))
{
command.ExecuteNonQuery();
}
}
作为最佳实践,上面这种使用 using 的方法是需要的,不过,因为其罗嗦,再写了10个这种代码后,遗漏掉一个还是可能的,所以,使用更简单的方法,让大家喜欢使用能保证连接关闭的方法,会更有效,这也是 DbEntry 的做法:
DbEntry.Context.ExecuteNonQuery("cmdText");
那么使用 DataReader 的通常的代码是什么样的呢?因为 DataReader 也需要及时的被关闭,我想大概是:
using (SqlConnection connection = new SqlConnection("connectionString"))
{
connection.Open();
using (SqlCommand command = new SqlCommand("cmdText", connection))
{
command.ExecuteNonQuery();
using(SqlDataReader reader = command.ExecuteReader())
{
// read data
}
}
}
DbEntry 中使用匿名方法(.net 3.5 中叫 lambada 表达式,语法形式稍有差异)来实现,和上面代码等效的代码是:
DbEntry.Context.ExecuteDataReader(new SqlStatement("cmdText"),
reader =>
{
// read data
});
DbEntry 也支持读取和更新 DataSet,读取的语法如下:
DataSet ds = DbEntry.Context.ExecuteDataset("cmdText");
DbEntry 对待 cmdText,和其它的框架有些不同,它会自动扫描 cmdText,如果发现它是一个 identity 的话,就自动把它当作存储过程来执行,反之则作为 SQL 语句来执行。当然,如果你想自己定义 cmdText 究竟是存储过程还是 SQL 语句,也是可以的。如果是存储过程,其参数类型,DbEntry 会自动查询数据库而得到,所以就不再需要填写类型了:
DataSet ds = DbEntry.Context.ExecuteDataset("cmdText", 13 "tom");
记得以前的 Application Block 里,有一个 SqlHelper,也是为了处理类似问题而做的,只不过其中使用了 Sql Server 特有的参数,使得它事实上只能用于 Sql Server。
事务的执行,在 DbEntry 里,使用的也是匿名方法:
DbEntry.UsingTransaction(delegate
{
DbEntry.Context.ExecuteNonQuery("cmdText1");
DbEntry.Context.ExecuteNonQuery("cmdText2");
});
大家也许注意到了,这里并没有像 TransactionScope 那样的 Commit 调用,这也正是匿名方法优于 using 语句之处,在这里,执行完 SQL 调用后,如果没有出现异常,DbEntry 就会自动调用 Commit 函数进行提交。
对于事务,DbEntry 有 UsingTransaction 和 NewTransaction 两个函数,区别在于 UsingTransaction 会尝试使用已经存在的事务,如果没有则新建一个事务,而 NewTransaction 总是会启动一个新的事务,一般来说,UsingTransaction 已经足够了。这个设计的好处在于,如果我们已经定义了一个函数A,其中使用了事务,而另一个函数B要调用函数A,而且希望自己调用的 SQL 和函数A的 SQL 在一个事务内,用这种方式很简单就能做到:
void FuncA()
{
DbEntry.UsingTransaction(delegate
{
DbEntry.Context.ExecuteNonQuery("cmdText1");
DbEntry.Context.ExecuteNonQuery("cmdText2");
});
}
void FuncB()
{
DbEntry.UsingTransaction(delegate
{
FuncA();
DbEntry.Context.ExecuteNonQuery("cmdText3");
DbEntry.Context.ExecuteNonQuery("cmdText4");
});
}
执行 SQL 是 DbEntry 的基石,ORM 部分也是调用这些方法完成 SQL 操作的,所以,这里的事务操作,对于混合了 ORM,SQL 和存储过程的情况,也同样有效。关于执行 SQL 就说这些吧,其中还有不少细节问题,可以参考主站的文档、单元测试以及源代码