SuperAPI AI 工具集

dotnet-dapper-query-builder

通用与其它

查看项目

更新于 10-16 03:03

技能介绍

用途:该技能用于在 .NET Clean Architecture 项目中生成基于 Dapper 的优化读取查询,面向 CQRS 的 Query 侧数据访问。

主要能力:包含基础单行/多行查询、多映射处理一对多关联、分页与动态过滤查询、CTE 公共表表达式、SQL 连接工厂等模板,并给出参数化、列别名、DTO 投影等最佳实践。

使用方式:在 Query Handler 中注入 ISqlConnectionFactory,通过 CreateConnection() 获取 IDbConnection;使用 QueryFirstOrDefaultAsync、QueryAsync、ExecuteScalarAsync 等方法执行参数化 SQL,连接使用 using 释放。列名以 AS 别名映射到 DTO,如 e.created_at AS CreatedAt。分页采用 OFFSET/FETCH,CTE 用于复杂逻辑。

适用场景:.NET CQRS 读取侧、高并发查询、复杂联接与报表、需要直接控制 SQL 的数据访问场景。

限制:资料未提供安装命令、依赖版本、收费或平台信息;ILIKE 为 PostgreSQL 特性,连接工厂示例使用 Npgsql;动态 WHERE 拼接需继续遵循参数化规则以避免注入。