首页 文章 精选 留言 我的

精选列表

搜索[crud],共2299篇文章
优秀的个人博客,低调大师

从环境搭建与 CRUD 实战说起

> 刚入行那会儿,我跟很多人一样 EF Core 一把梭。直到有一次做个报表接口,数据量不大但联了七八张表,EF 生成的 SQL 跑了 6 秒。换成 Dapper 手写 SQL,同样的查询 0.4 秒。从那之后,我手里所有对性能有要求的项目,数据访问层全是 Dapper。 这篇文章从零开始,把 Dapper 同步写法的核心讲清楚,顺带聊聊实际项目里真正会出问题的地方。 ![](https://developer.qcloudimg.com/http-save/yehe-2415476/8bf6ab64ea7ce048bbd729472f82f5ff.png) --- ## **Dapper 是什么** 一句话:你把 SQL 丢给它,它把结果映射成你的实体对象。 没有状态跟踪,没有变更检测,没有延迟加载——所以它快。Stack Overflow 自己就在生产环境跑它,日请求量你想想看。 --- ## **安装** Dapper 本体: ``` dotnet add package Dapper ``` 然后按数据库装驱动: - SQL Server:`Microsoft.Data.SqlClient` - MySQL / MariaDB:`MySqlConnector` - PostgreSQL:`Npgsql` - SQLite:`Microsoft.Data.Sqlite` - Oracle:`Oracle.ManagedDataAccess.Core` --- ## **连接管理——这比你想象的严重得多** 先说个真实的事。 去年我们一个订单服务,某天下午突然开始大面积超时,日志里全是 `Timeout expired`。查了半天发现新来的同事在一个定时任务里写了 `new SqlConnection(connStr)`,没有 `using`,也没调 `Close()`。这个任务每 30 秒跑一次,每次泄漏一个连接。跑了半天,连接池 100 个连接全部占满——剩下所有接口都在排队等连接。 ![](https://developer.qcloudimg.com/http-save/yehe-2415476/442f4368144892e7c533d0ba61bc4178.png) 所以这句请记住:**Dapper 不会帮你管理连接,你必须手动 `using**`。 标准写法就下面这样,别纠结,照抄: ``` string connectionString = "Server=.;Database=TestDB;Integrated Security=true;"; using (IDbConnection db = new SqlConnection(connectionString)) { db.Open(); // 你的操作 } ``` 另外,永远不要在类里搞一个 `static SqlConnection` 当全局单例用。连接池本身就是干这个的,你不需要自己缓存连接。 --- ## **实体类** 下面两个类后面全系列都在用: ``` public class User { public int Id { get; set; } public string Name { get; set; } public string Email { get; set; } public int Age { get; set; } public Address Address { get; set; } } public class Address { public int UserId { get; set; } public string City { get; set; } public string Street { get; set; } } ``` `User` 里有个 `Address` 导航属性,联表映射的时候用来装结果。 ![](https://developer.qcloudimg.com/http-save/yehe-2415476/57f8b53ff22dd1966a87d3bdc1a8cf50.png) --- ## **查询** 查多条用 `Query`,查单条用 `QueryFirstOrDefault`。区别很简单: ``` // 查列表 var users = db.Query("SELECT * FROM Users WHERE Age > @Age", new { Age = }).ToList(); // 查单条——查不到返回 null,不会抛异常,日常最常用 var user = db.QueryFirstOrDefault("SELECT * FROM Users WHERE Id = @Id", new { Id = }); ``` Dapper 的传参靠匿名对象,`new { Age = 18 }` 自动变成 `@Age` 参数。你别手拼 SQL 字符串,拼了就是注入漏洞。 `QueryFirst`、`QueryFirstOrDefault`、`QuerySingleOrDefault` 三个的区别:第一个查不到抛异常,第二个查不到返回 null,第三个查到多条抛异常。日常用第二个最多;按主键查的时候可以用 `QuerySingleOrDefault`,万一主键重复多返回一行能立刻报错,比悄悄用第一条强。 --- ## **增删改** 统一用 `Execute()`,返回受影响行数。插入更新删除全一个写法: ``` db.Execute("INSERT INTO Users (Name, Email, Age) VALUES (@Name, @Email, @Age)", new { Name = "Bob", Email = "bob@test.com", Age = }); db.Execute("UPDATE Users SET Name = @Name WHERE Id = @Id", new { Name = "Robert", Id = }); db.Execute("DELETE FROM Users WHERE Id = @Id", new { Id = }); ``` 没什么花头,就这么用。 --- ## **联表查询** 联表的坑在于 `splitOn` 参数。它告诉 Dapper:从结果集的第几列开始,后面的字段映射给第二个实体。 ``` string sql = @"SELECT u.Id, u.Name, a.City, a.Street FROM Users u JOIN Addresses a ON u.Id = a.UserId"; var users = db.Query(sql, (user, addr) => { user.Address = addr; return user; }, splitOn: "City" ).Distinct().ToList(); ``` `Id`、`Name` → `User`,`City`、`Street` → `Address`。`splitOn` 填的是 Address 的**第一个字段名**。 新手容易在这里翻车:`splitOn` 拼错了,或者列的先后顺序跟代码里实体顺序对不上,查出来的数据就全 null。这个问题我见过不下五次——没有报错,就是字段全是空,半天才反应过来。 --- ## **存储过程** 多一行参数的事: ``` var user = db.Query("GetUserById", new { Id = }, commandType: CommandType.StoredProcedure).FirstOrDefault(); ``` --- ## **事务** 事务的核心就一条:几条 SQL 共用一个 `IDbTransaction`,全部成功才提交,一条失败全回滚。 ![](https://developer.qcloudimg.com/http-save/yehe-2415476/8b03fdb02a548902209bacd87097accd.png) ``` using (IDbConnection db = new SqlConnection(connectionString)) { db.Open(); using (var tran = db.BeginTransaction()) { try { db.Execute("INSERT INTO Users(Name) VALUES (@Name)", new { Name = "TestUser" }, transaction: tran); db.Execute("UPDATE Logs SET Status='Done' WHERE Id=@Id", new { LogId = }, transaction: tran); tran.Commit(); } catch { tran.Rollback(); throw; } } } ``` 注意:操作里必须传 `transaction: tran`,漏传的话那条 SQL 就不在事务里了,回滚回不来,数据就脏了。 --- 第一章就到这。核心 API 这点东西其实不复杂,Dapper 的优势从来不是"功能多",而是"够用且快"。 下一篇讲异步写法。这是 Web API 逃不掉的话题,而且异步用不好比同步还危险——`.Result` 死锁的故事下章细说。 --- **(点击关注,修炼不迷路?**?) ▌转载请注明出处,渡人渡己 🌟 感谢道友结缘! 若本文助您突破修为瓶颈,不妨**【打赏灵**丹】或**【转发功**德】,让更多道友共参.NET天道玄机。修真之路漫漫,我们以代码为符,共绘仙途!

资源下载

更多资源
腾讯云软件源

腾讯云软件源

为解决软件依赖安装时官方源访问速度慢的问题,腾讯云为一些软件搭建了缓存服务。您可以通过使用腾讯云软件源站来提升依赖包的安装速度。为了方便用户自由搭建服务架构,目前腾讯云软件源站支持公网访问和内网访问。

Nacos

Nacos

Nacos /nɑ:kəʊs/ 是 Dynamic Naming and Configuration Service 的首字母简称,一个易于构建 AI Agent 应用的动态服务发现、配置管理和AI智能体管理平台。Nacos 致力于帮助您发现、配置和管理微服务及AI智能体应用。Nacos 提供了一组简单易用的特性集,帮助您快速实现动态服务发现、服务配置、服务元数据、流量管理。Nacos 帮助您更敏捷和容易地构建、交付和管理微服务平台。

Rocky Linux

Rocky Linux

Rocky Linux(中文名:洛基)是由Gregory Kurtzer于2020年12月发起的企业级Linux发行版,作为CentOS稳定版停止维护后与RHEL(Red Hat Enterprise Linux)完全兼容的开源替代方案,由社区拥有并管理,支持x86_64、aarch64等架构。其通过重新编译RHEL源代码提供长期稳定性,采用模块化包装和SELinux安全架构,默认包含GNOME桌面环境及XFS文件系统,支持十年生命周期更新。

Sublime Text

Sublime Text

Sublime Text具有漂亮的用户界面和强大的功能,例如代码缩略图,Python的插件,代码段等。还可自定义键绑定,菜单和工具栏。Sublime Text 的主要功能包括:拼写检查,书签,完整的 Python API , Goto 功能,即时项目切换,多选择,多窗口等等。Sublime Text 是一个跨平台的编辑器,同时支持Windows、Linux、Mac OS X等操作系统。

用户登录
用户注册