🏆作者:科技、互联网行业优质创作者
🏆专注领域:.Net技术、软件架构、人工智能、数字化转型、DeveloperSharp、微服务、工业互联网、智能制造
🏆欢迎关注我(Net数字智慧化基地),里面有很多高价值技术文章,是你刻苦努力也积累不到的经验,能助你快速成长。升职+涨薪!!
DeveloperSharp系列近期又被制造业ERP、民航飞行App、建筑BIM、电力掌上营业厅、等多家大型采用,站在巨人的肩膀上你能走的更远。
支持.Net Core2.0及以上,支持.Net Framework4.0及以上
本文要介绍的主角-DeveloperSharp框架中的DataAccess数据库访问技术(续),提供了一种结合“原生Sql+轻量级ORM”操作各类数据库的工具。
该工具几乎只使用了一个方法/函数,却实现了几乎所有的数据操作功能。它已成功应用到了人工智能、产业互联网、智慧医疗、等多个大型项目上。
此工具在IDataAccess接口中提供。
IDataAccess所在的命名空间是:DeveloperSharp.Framework.QueryEngine(需从NuGet引用DeveloperSharp包)(提示:最新版已解决部署为“服务”时报错的问题)
它主要提供了如下四大功能:
(1) 执行Sql语句
(2) 执行Sp存储过程
(3) 创建参数(输入/输出/返回)
(4) 事务
它初始化的代码如下:
若是在.Net Core环境下,代码如下:
using DeveloperSharp.Framework.QueryEngine;
--------------------------//在Startup.cs或Program.cs文件中进行Services.AddTransient<IDataAccess>((t) => {DatabaseInfo DIF;DIF.DatabaseType = DatabaseType.SQLServer; //设置数据库类型DIF.ConnectionString = "Server=localhost;Database=YZZ;Uid=sa;Pwd=123";return DataAccessFactory.Create(DIF);});
若是在.Net Framework环境下,代码如下:
using DeveloperSharp.Framework.QueryEngine;
--------------------------DatabaseInfo DIF;DIF.DatabaseType = DatabaseType.SQLServer; //设置数据库类型DIF.ConnectionString = "Server=localhost;Database=YZZ;Uid=sa;Pwd=123";IDataAccess IDA = DataAccessFactory.Create(DIF);
注意:通过对DatabaseType属性的设定,提供了对所有种类数据库的支持(包括:MySql、Oracle、PostgreSQL、SqlServer、Sqlite、Firebird、达梦、以及人大金仓KingbaseES、神舟通用, 南大通用, 翰高, Access、等)
【示例1:查询】
下面,首先直接给出一个“查询多数据+选出单数据+参数”的使用示例,代码如下:
//查询多数据var Students1 = IDA.SqlExecute<stu>("select * from t_Student");//查询多数据(带参数)var Students2 = IDA.SqlExecute<stu>("select * from t_Student where Id>@IdMin and Name like @LikeName", new { IdMin = 2, LikeName = "%周%" });//另一种写法1var IdMin = IDA.CreateParameterInput("IdMin", DbType.Int32, 2);var LikeName = IDA.CreateParameterInput("LikeName", DbType.String, 50, "%周%");var Students3 = IDA.SqlExecute<stu>("select * from t_Student where Id>@IdMin and Name like @LikeName", LikeName, IdMin);//另一种写法2var Students4 = IDA.SqlExecute<stu>("select * from t_Student").Where(t => t.Id > 2 && t.Name.Contains("周"));//选出单数据var OneStudent = Students2.FirstOrDefault();
其中stu实体类代码如下形式:
//此实体类中的Id、Name、Age、Birth、MyLevel属性名,要与数据表中的字段名一一对应public class stu{public int? Id { get; set; }//数据库中该字段若存在Null值,类型后需要加问号?public string Name { get; set; }public int? Age { get; set; }public DateTime? Birth { get; set; }public Level? MyLevel { get; set; }//也可以使用枚举,会自动转换}public enum Level{Student=100,//学生Teacher=200,//老师Manager=300,//管理员Principle=400//校长}
注意:(1)DbType类型的命名空间是System.Data
(2)若没有定义stu实体类,也可以用dynamic替代
【示例2:分页】
承接上面“示例1”的代码,若我们要对Students1、Students2进行分页操作(比如:每页20条,取出第5页),相关代码如下:
using DeveloperSharp.Extension;//调用“分页功能”需要引用此命名空间
--------------------------var Page1 = Students1.PagePartition(20, 5);var Page2 = Students2.PagePartition(20, 5);//一气呵成的写法var Page3 = IDA.SqlExecute<stu>("select * from t_Student").PagePartition(20, 5);
分页后获得的PagePiece对象中所包含的各类属性/参数,可参看这篇文章:高效分页
【示例3:增/删/改】
前面谈完“查询”,我们接下来谈谈“增/删/改”的使用方式,下面是一个“修改数据+参数+事务”的使用示例:
try{//开启事务IDA.TransactionBegin();//修改数据(多语句)int affectedRows1 = IDA.SqlExecute("insert into t_Student(Name,Age)values('ww','96');update t_Student set Age=100 where Id=1006");//修改数据(带参数)int affectedRows2 = IDA.SqlExecute("insert into t_Student(Name,Age)values(@N,@A)", new { N = "孙悟空", A = 200 });//另一种写法var NewAge = IDA.CreateParameterInput("NewAge", DbType.Int32, 200);var NewName = IDA.CreateParameterInput("NewName", DbType.String, 50, "孙悟空");int affectedRows3 = IDA.SqlExecute("insert into t_Student(Name,Age)values(@NewName,@NewAge)", NewName, NewAge);//完成事务IDA.TransactionCommit();}catch{//回滚事务IDA.TransactionRollBack();}
【示例4:输出参数】
前面几个示例都只用到了“输入参数”,下面我们看看“输出参数”怎么使用,示例代码如下:
var op1 = IDA.CreateParameterOutput("TotalCount", DbType.Int32);//此项为输出参数var op2 = IDA.CreateParameterOutput("MyName", DbType.String, 50);//此项为输出参数//以下sql语句混杂了多个“输入”与“输出”参数,注意看IDA.SqlExecute("insert into Friend(Birth,Name,height)values(@B,@N,@h);" +"select @TotalCount=count(*) from Friend;" +"select @MyName=Name from Friend where Id=@Id",new { N = "杨小伟", B = "1999-02-28 12:03:45", h = 11.023, Id = 2 },op1, op2);int tc = Convert.ToInt32(op1.Value);string mn = op2.Value.ToString();
【示例5:存储过程】
最后,我们来谈谈如何调用存储过程。我们创建一个存储过程(以下是Sql Server为例),它带有输入、输出、返回三种类型的参数,代码如下:
CREATE PROCEDURE Test5@B as datetime,@N as nvarchar(50),@h as float,@TotalCount as int output,@MyName as nvarchar(50) output,@Id as int
AS
BEGINinsert into Friend(Birth,Name,height)values(@B,@N,@h);select @TotalCount=count(*) from Friend;select @MyName=Name from Friend where Id=@Id;return @TotalCount+100;
END
调用该存储过程的示例代码如下:
var op1 = IDA.CreateParameterOutput("TotalCount", DbType.Int32);//输出参数var op2 = IDA.CreateParameterOutput("MyName", DbType.String, 50);//输出参数var op3 = IDA.CreateParameterReturn();//返回参数IDA.SpExecute("Test5", new { N = "杨小伟", B = "1999-02-28 12:03:45", h = 11.023, Id = 2 }, op1, op2, op3);int tc = Convert.ToInt32(op1.Value);string mn = op2.Value.ToString();int ret = Convert.ToInt32(op3.Value);
(注意:上述使用的是SpExecute,而不是SqlExecute)
上述存储过程中并没有返回“结果集”的语句,现在我们给它添加“结果集”的返回,代码如下:
CREATE PROCEDURE Test6@B as datetime,@N as nvarchar(50),@h as float,@TotalCount as int output,@MyName as nvarchar(50) output,@Id as int
AS
BEGINselect * from Friend --返回“结果集”insert into Friend(Birth,Name,height)values(@B,@N,@h);select @TotalCount=count(*) from Friend;select @MyName=Name from Friend where Id=@Id;return @TotalCount+100;
END
此时调用该存储过程的示例代码稍作修改为如下:
var op1 = IDA.CreateParameterOutput("TotalCount", DbType.Int32);//输出参数var op2 = IDA.CreateParameterOutput("MyName", DbType.String, 50);//输出参数var op3 = IDA.CreateParameterReturn();//返回参数//获得“结果集”,可做其它用途var lstResult = IDA.SpExecute<dynamic>("Test6", new { N = "杨小伟", B = "1999-02-28 12:03:45", h = 11.023, Id = 2 }, op1, op2, op3);int tc = Convert.ToInt32(op1.Value);string mn = op2.Value.ToString();int ret = Convert.ToInt32(op3.Value);
学习+灵活使用以上5个示例,就能满足几乎所有的数据操作需求。
另外,你有没有发现,上述所有的数据操作几乎只用了一个方法来实现:SqlExecute/ SqlExecute<T>
IDataAccess内功能方法详细说明(辅助参考):
SqlExecute<T> (异步为:SqlExecuteAsync<T>)
声明:IEnumerable<T> SqlExecute<T>(string cmdText, params IDataParameter[] Params) where T : class, new()
用途:执行Sql语句(Select类)
参数:(1)string cmdText -- Sql语句(2)params IDataParameter[] Params -- 参数组
返回:IEnumerable<T> -- 多数据结果集SqlExecute<T> (异步为:SqlExecuteAsync<T>)
声明:IEnumerable<T> SqlExecute<T>(string cmdText, object InputParams, params IDataParameter[] Params) where T : class, new()
用途:执行Sql语句(Select类)
参数:(1)string cmdText -- Sql语句(2)object InputParams -- 输入参数对象(3)params IDataParameter[] Params -- 参数组
返回:IEnumerable<T> -- 多数据结果集SqlExecute (异步为:SqlExecuteAsync)
声明:int SqlExecute(string cmdText, params IDataParameter[] Params)
用途:执行Sql语句(Insert/Update/Delete类)
参数:(1)string cmdText -- Sql语句(2)params IDataParameter[] Params -- 参数组
返回:int -- 受影响的行数SqlExecute (异步为:SqlExecuteAsync)
声明:int SqlExecute(string cmdText, object InputParams, params IDataParameter[] Params)
用途:执行Sql语句(Insert/Update/Delete类)
参数:(1)string cmdText -- Sql语句(2)object InputParams -- 输入参数对象(3)params IDataParameter[] Params -- 参数组
返回:int -- 受影响的行数SpExecute<T> (异步为:SpExecuteAsync<T>)
声明:IEnumerable<T> SpExecute<T>(string cmdText, params IDataParameter[] Params) where T : class, new()
用途:执行Sp存储过程(Select类)
参数:(1)string cmdText -- Sp存储过程名(2)params IDataParameter[] Params -- 参数组
返回:IEnumerable<T> -- 多数据结果集SpExecute<T> (异步为:SpExecuteAsync<T>)
声明:IEnumerable<T> SpExecute<T>(string cmdText, object InputParams, params IDataParameter[] Params) where T : class, new()
用途:执行Sp存储过程(Select类)
参数:(1)string cmdText -- Sp存储过程名(2)object InputParams -- 输入参数对象(3)params IDataParameter[] Params -- 参数组
返回:IEnumerable<T> -- 多数据结果集SpExecute (异步为:SpExecuteAsync)
声明:int SpExecute(string cmdText, params IDataParameter[] Params)
用途:执行Sp存储过程(Insert/Update/Delete类)
参数:(1)string cmdText -- Sp存储过程名(2)params IDataParameter[] Params -- 参数组
返回:int -- 受影响的行数SpExecute (异步为:SpExecuteAsync)
声明:int SpExecute(string cmdText, object InputParams, params IDataParameter[] Params)
用途:执行Sp存储过程(Insert/Update/Delete类)
参数:(1)string cmdText -- Sp存储过程名(2)object InputParams -- 输入参数对象(3)params IDataParameter[] Params -- 参数组
返回:int -- 受影响的行数
🏆欢迎订阅我的专栏(.NET/C#中大型项目开发),里面有很多高价值技术文章,能助你涨薪+升职!让你快速成长为相关领域的架构师、领航员。也能让普通中小企业轻松享有大型互联网分布式系统解决方案。
🏆同时,专栏(.NET/C#中大型项目开发)的内容也能教你采用最简单的方式开发.NET/C#中大型应用——理清技术脉络、形成思维体系、获取最佳实践、框架开发能力。让你具备挑战百万年薪的基础,逐渐成为国内一流.NET/C#从业者。