【.NET 框架】—— Dapper框架的高级应用（二）

1.1.Dapper调用存储过程

存储过程是一组预编译的SQL语句。

使用存储过程有以下优点：

1.允许模块化程序设计，就是说只需要创建一次，在以后的程序中就可以调用该过程任意次。

2.允许更快地执行，如果某操作需要大量SQL语句或重复执行对应的SQL语句，存储过程比SQL语句执行的更快。

3.减少网络流量，例如一个需要数百行的SQL代码的操作有一条执行语句完成，不需要在网络中发送数百行代码。

4.更好的安全机制，对于没有权限执行存储过程的用户，也可以授权它们执行存储过程。

1.1.1.使用Dapper调用无参数的存储过程

这里我首先在数据库中创建了一个基于DapperDemo数据库的无参数的存储过程：dbo.P_stuMarkInfo，具体的存储过程语句已上传至github：https://github.com/devyf/Dapper-.git

这里我基于wiform界面按钮操作来调用我的后台存储过程，

点击“未通过考试学生名单”按钮，会调用后台在数据库对应创建的”dbo. P_stuMarkInfo”存储过程：

对应后台的无参存储过程点击调用执行代码：

/// <summary>
        /// 点击按钮，查询未能通过考试的学生名单，调用无参数的存储过程，默认及格线为60分
        /// </summary>
        /// <param name="sender"></param>
        /// <param name="e"></param>
        private void button1_Click(object sender, EventArgs e)
        {
            List<StuInfo> stuList = new List<StuInfo>();
            using (IDbConnection db = new SqlConnection(DBHelper.ConnString))
            {
                stuList = db.Query<StuInfo>("dbo.P_stuMarkInfo", //存储过程的名称
                    null, //存储过程的参数
                    null, //事务对象
                    true, //是否缓存
                    null, //获取或设置在终止执行命令的尝试并生成错误之间的等待时间
                    CommandType.StoredProcedure //指定的sql语句为存储过程类型
                    ).ToList();
            }

            if (stuList.Count > 0)
            {
                stuList.ForEach(stu => this.textBox1.Text += stu.StuName + " ");
            }
        }

执行效果如下：

1.1.2.使用Dapper调用有参数（有返回值）的存储过程

这里我继续添加sql来创建了一个有参数、有返回值的存储过程，如下：

----存储过程的创建：②带参数的存储过程
----笔试和机试的及格线由用户指定，并且统计出未通过考试的人数
if exists (select * from sysobjects where name='P_stuMarkInfo1')
drop proc P_stuMarkInfo1
go
create proc P_stuMarkInfo1
@writeLevel int,  ----输入参数：笔试及格线
@labLevel int,    ----输入参数：机试及格线
@examNum int output     ----输出参数：未通过考试的人数
as

select @examNum = count(*) from stuinfo where stuNo not in
(select stuNo from stumark where writtenExam >= @writeLevel and labExam>=@labLevel)


----执行存储过程
declare @countNum int
exec P_stuMarkInfo1 60, 60, @countNum output

print '未通过考试的人数：' + convert(varchar(20), (@countNum)) 

存储过程语句均已上传至github：https://github.com/devyf/Dapper-.git

具体存储过程创建时需要对应在当前数据库下执行并保存，如下图：

这里对应前台winform界面上输入和输出参数设置如下，点击”未通过考试学生人数”按钮可以调用后台的存储过程：

后台调用有参数的存储过程代码如下：

/// <summary>
        /// 点击按钮，通过设置的笔试成绩和机试成绩去动态调用带参数的存储过程
        /// </summary>
        /// <param name="sender"></param>
        /// <param name="e"></param>
        private void button2_Click(object sender, EventArgs e)
        {
            //准备存储过程的三个参数：两个是输入参数，一个是输出参数
            var param = new DynamicParameters();  //动态参数类
            try
            {
                param.Add("@writeLevel", int.Parse(this.writeLev.Text)); //存储过程的输入参数赋值
                param.Add("@labLevel", int.Parse(this.labLev.Text));
                param.Add("@examNum", 0, DbType.Int32, ParameterDirection.Output); //标注为输出参数
            }
            catch (Exception ex)
            {
                MessageBox.Show(ex.Message);
            }
          

            using (IDbConnection db = new SqlConnection(DBHelper.ConnString))
            {
                db.Execute("dbo.P_stuMarkInfo1",  //指定存储过程名称
                    param,  //存储过程参数
                    null,  //存储过程事务
                    null,  //执行等待时间
                    CommandType.StoredProcedure  //指定执行为存储过程类型
                    );
                //通过参数调用Get方法来获取返回值
                int outNum = param.Get<int>("@examNum");
                //放置到文本框中
                this.nopassNum.Text = outNum.ToString();
                MessageBox.Show("存储过程执行成功！");
            }
        }

1.2.Dapper执行事务操作

事务的概念：在关系型数据库中，一个事务可以是一条SQL语句，一组SQL语句或者整个程序。

事务特性：

事务是恢复和并发控制的基本单位。

事务应该具有4个属性：原子性、一致性、隔离性、持久性。这四个属性通常称为ACID特性。

原子性（atomicity）：一个事务是一个不可分割的工作单位，事务中包括的所有操作要么都做，要么都不做。

一致性（consistency）：事务必须是使数据库从一个一致性状态变到另一个一致性状态。一致性与原子性是密切相关的。

隔离性（isolation）：一个事务的执行不能被其它事务干扰。即一个事务内部的操作及使用的数据对并发的其它事务是隔离的，并发执行的各个事务之间不能互相干扰。

持久性（durability）：持久性也称为永久性（permanence），指一个事务一旦提交，它对数据库中数据的改变就应该是永久性的。接下来的其它操作或故障不应该对其有任何影响。

使用Dapper操作数据库事务，这里基于winform界面执行数据库中两张表（主表stuinfo、从表stumark）进行删除操作，使用Dapper操作事务进行提交、删除、回滚操作，具体后台代码如下：

/// <summary>
        /// 删除按钮点击执行事务操作
        /// </summary>
        /// <param name="sender"></param>
        /// <param name="e"></param>
        private void delBtn_Click(object sender, EventArgs e)
        {
            //执行界面操作，根据主表学生表的ID去删除相关联的信息
            //事务操作：根据输入的学生ID编号，删除从表，删除主表中的数据信息列
            int delId = int.Parse(this.txtDelID.Text);  //取出要删除的学生表的学号
            using (IDbConnection db = new SqlConnection(DBHelper.ConnString))
            {
                db.Open(); //基于事务操作的特殊性：执行事务之前需要优先开启连接
                //try catch语句使用外侧代码：快捷键：ctrl+k、ctrl+s
                //创建事务对象
                IDbTransaction transaction = db.BeginTransaction();  //开启数据库的事务
                try
                {
                    //根据用户输入的学号ID进行删除的操作：先删除从表，再删除主表的信息
                    string delSql1 = "delete from stuinfo where stuNo = @stuNo";  //主表
                    string delSql2 = "delete from stumark where stuNo = @stuNo";  //从表

                    //执行删除操作
                    db.Execute(delSql2, new { stuNo = delId }, transaction, null, null);
                    db.Execute(delSql1, new { stuNo = delId }, transaction, null, null);

                    //提交事务
                    transaction.Commit();
                    MessageBox.Show("删除成功！");
                }
                catch (Exception ex)
                {
                    //出现异常，需要回滚事务
                    transaction.Rollback();
                    MessageBox.Show("出现异常：" + ex.Message);
                }
                finally
                {
                    db.Close();
                }
            }
        }

执行删除从表、主表操作，成功从前台界面上删除ID为”1006”的数据：

对应数据库中也随即删除：

 

对应如果交换delSql1与delSql2的执行顺序，这时因为先删除主表，而在从表上有数据外键的关联，会执行数据回滚rollback操作，无法进行数据的删除操作：

可以看到catch异常之后，数据库中数据”1005”并未执行数据列的删除操作：

1.3.Dapper进行多表查询

Dapper框架可以基于数据库sql语句进行数据库字段映射，并使用splitOn进行类型与返回值之间的划分。

下面基于两个实例来简单介绍一下Dapper进行多表查询返回值划分案例：

实例一：

①首先基于之前的dbo.stuinfo表与dbo.stumark表进行多表连接查询，对应sql语句与查询结果如下：

②基于这个连接查询的结果，使用Dapper框架进行Query查询封装查询映射，具体代码如下：

private void button1_Click(object sender, EventArgs e)
        {
            using (IDbConnection db = new SqlConnection(DBHelper.ConnString))
            {
                var sql = "select * from stuinfo inner join stumark on stuinfo.stuNo = stumark.stuNo";

                //执行查询：多表(类型一，类型二，返回值)
                var list = db.Query<StuInfo, StuMark, StuInfo>(
                    sql,
                    (students, score) => { return students; }, //变量students对应的StuInfo类型，scores对应StuMark类型
                    null,  //存储过程的参数
                    null,  //事务
                    true,  //缓存
                    splitOn: "stuNo" //该参数是用来划分查询中的字段是属于哪个表的 splitOn可以省略
                    );

                /*splitOn:stuNo 划分查询中的字段是属于哪个表的，也就是查询结构映射到哪个实体，上边的sql运行时，会从查询结果所有
                 字段列表的最后一个字段进行匹配，一直找到stuNo这个字段（大小写不计），找到的第一个stuNo字段匹配就是Query参数中
                 StuInfo类的stuNo属性，那么从stuNo到最后一个字段都属于StuInfo，StuNo以前的字段都被映射到StuMark这张表
                 通过(T,P)=>(return T)把两个类的实例解析出来*/
                this.dgvContent.DataSource = list;
            }
        }

执行界面点击操作，加载数据库查询映射结果如下图所示：

实例二：

继续使用查询语句进行数据分割操作，这里同样创建了两个数据点击显示按钮界面进行查询操作：

查看数据后台代码：

 private void button1_Click(object sender, EventArgs e)
        {
            using (IDbConnection db = new SqlConnection(DBHelper.ConnString))
            {
                List<Customer> userList = new List<Customer>();
                string sql = @"select u.*, r.* from UserInfo u 
                               inner join UserRole ur on ur.UserId = u.UserId
                               inner join Role r on r.RoleId = ur.RoleId";
                userList = db.Query<Customer, Role, Customer>( //第三个参数是返回值类型
                    sql,
                    (user, role) => { user.Role = role; return user; },
                    null,
                    null,
                    true,
                    "RoleId",   //分割数据列字符串
                    null,
                    null
                    ).ToList();
                this.dataGridView1.DataSource = userList;
                //打印其中单个字符
                if (userList.Count > 0)
                {
                    userList.ForEach(item => Console.WriteLine("userName:" + item.Username + "passWord:" + item.PasswordHash +
                        "Role:" + item.Role));
                }
            }

        }

        private void button2_Click(object sender, EventArgs e)
        {
            using (IDbConnection db = new SqlConnection(DBHelper.ConnString))
            {
                List<User> userList = new List<User>();
                string sql = @"select u.UserId, u.UserName, u.PasswordHash, r.RoleId, r.RoleName from UserInfo u
                               inner join UserRole ur on ur.UserId = u.UserId
                               inner join Role r on r.RoleId = ur.RoleId";
                Dictionary<int, User> dic = new Dictionary<int, User>();
               
                userList = db.Query<User, Role, User>(
                    sql,
                    (user, role) => 
                    {
                        User tempUser;
                        if (!dic.TryGetValue(user.UserId, out tempUser))
                        {
                            tempUser = user;
                            dic.Add(user.UserId, tempUser);
                        }
                        tempUser.Role.Add(role);
                        return user;
                    },
                    null,
                    null,
                    true,
                    "RoleId",
                    null,
                    null
                    ).ToList();

                    this.dataGridView2.DataSource = userList;
                //打印其中单个字符
                if (userList.Count > 0)
                {
                    userList.ForEach(item => Console.WriteLine("userName:" + item.Username + "passWord:" + item.PasswordHash +
                        "Role:" + item.Role.First().RoleName));
                }
            }
        }

查询结果如下图所示：