DbEntry 之执行 SQL

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 就说这些吧，其中还有不少细节问题，可以参考主站的文档、单元测试以及源代码。