登录/ 注册
 找回密码
 立即注册
关闭

CSDN热搜

程序园 精品问答 技术交流 资源下载
返回列表 发新帖
首页 › 业界区 › 业界 ›ShadowSql.net之正确使用方式

ShadowSql.net之正确使用方式

但婆 3 天前
ShadowSql是面向接口模块化可插拔可扩展的工具


  • ShadowSql不是全家桶
  • 不把所有功能都做一个项目里面就是为了大家不一次引用所有的nuget包
  • 大家可以先判断需要哪些功能,再引用对应的nuget包
  • 当然同时引用这6个nuget包也是可以的
一、相关项目简介

名称项目Nuget包依赖大小主要用途精简版ShadowSql.CoreShadowSql.Core无147K简洁高效拼接sql易用版ShadowSqlShadowSqlShadowSql.Core96K(+147K)泛型表操作、链式拼接sql表达式版ShadowSql.ExpressionsShadowSql.ExpressionsShadowSql.Core75K(+147K)表达式树操作、链式拼接sqlDDLShadow.DDLShadow.DDLShadowSql.Core15K(+147K)拼接CreateTable、表Schema支持DapperDapperDapper无240K执行sql、类型Mapping精简版扩展Dapper.Shadow.CoreShadowSql.Dapper.CoreShadowSql.Core和Dapper17K(+387K)执行ShadowSql.Core拼接的sql易用版扩展Dapper.ShadowShadowSql.DapperShadowSql.Dapper.Core、ShadowSql.Core、ShadowSql和Dapper35K(+500K)执行ShadowSql拼接的sql二、如果选型



  • 主要看个人或团队偏好
1. 偏好Lambda选表达式版



  • 表达式树是Lambda的影子,可以生成委托,但这里只解析表达式树
  • 表达式版提供类EF的查询体验
  • 表达式树会用到反射,性能上会有点损耗,对比带来的便利性完全是可以接受的
  • 如果使用参数查询并缓存sql复用,完全可以忽略这个性能损耗,甚至可以忽略整个拼写sql的性能消耗
  • 表达式版搭配Dapper.Shadow.Core或者直接搭配Dapper甚至ADO.NET使用
1.1 EFCore示例



  • ShadowSql不含EFCore的功能,这个示例是为了和表达式版对比
  1. var query = context.Set<User>("Users")
  2.     .Where(u => u.Status)
  3.     .Take(10)
  4.     .Skip(20)
  5.     .OrderByDescending(u => u.Id)
  6.     .Select(u => new { u.Id, u.Name });
复制代码
1.2 表达式版示例



  • 表达式版可以写出与EFCore类似的代码
  1. var select = db.From("Users")
  2.     .ToSqlQuery<User>()
  3.     .Where(u => u.Status)
  4.     .Take(10)
  5.     .Skip(20)
  6.     .Desc(u => u.Id)
  7.     .ToSelect()
  8.     .Select(u => new { u.Id, u.Name });
复制代码
1.3 表达式版参数化查询示例
  1. var select = db.From("Users")
  2.     .ToSqlQuery<User>()
  3.     .Where<UserParameter>((u, p) => u.Id == p.Id2 && u.Status)
  4.     .Take(10)
  5.     .Skip(20)
  6.     .Desc(u => u.Id)
  7.     .ToSelect()
  8.     .Select(u => new { u.Id, u.Name });
  9. // MsSql生成sql: SELECT [Id],[Name] FROM [Users] WHERE [Id]=@Id2 AND [Status]=1 ORDER BY [Id] DESC OFFSET 20 ROWS FETCH NEXT 10 ROWS ONLY
复制代码
1.4 表达式版更多功能



  • 参看表达式版简介
2. 偏好链式查询选易用版



  • 易用版支持泛型表操作几乎无性能损耗(对比精简版)
  • 每个模型类最好定义数据表影子类(联表定义别名表),以便做到sql编译检测
  • 不定义数据表影子类可以用按字段查询或严格查询
  • ShadowSql搭配Dapper.Shadow或Dapper.Shadow.Core或直接搭配Dapper甚至ADO.NET使用
2.1 易用版示例
  1. var select = new UserTable()
  2.     .ToSqlQuery()
  3.     .Where(table => table.Status.EqualValue(true))
  4.     .Take(10, 20)
  5.     .Asc(table => table.Id)
  6.     .ToSelect()
  7.     .Select(table => [table.Id, table.Name]);
  8. // MsSql生成sql: SELECT [Id],[Name] FROM [Users] WHERE [Id]=@Id2 AND [Status]=1 ORDER BY [Id] DESC OFFSET 20 ROWS FETCH NEXT 10 ROWS ONLY
复制代码
2.2 易用版更多功能



  • 参看易用版版简介
3. 有“洁癖”选精简版



  • 使用精简版也可以定义数据表影子类(联表定义别名表)
  • 查询时使用列或者数据表的列,这样代码可读性高,也可以做到sql编译检测
  • ShadowSql.Core搭配Dapper.Shadow.Core或者直接搭配Dapper甚至ADO.NET使用
3.1 精简版示例
  1. var table = new UserTable();
  2. var query = new TableSqlQuery(table)
  3.     .Where(table.Status.EqualValue(true));
  4. var cursor = new TableCursor(query)
  5.     .Take(10)
  6.     .Skip(20)
  7.     .Asc(table.Id);
  8. var select = new CursorSelect(cursor)
  9.     .Select(table.Id, table.Name);
复制代码
3.2 易用版更多功能



  • 参看易用版简介
4. 需要CreateTable或表Schema的选DDL



  • DDL可以搭配易用版或表达式版
  • 参看DDL简介
4.1 CreateTable
  1.     ColumnSchema id = new("Id", "INTEGER") { ColumnType = ColumnType.Identity | ColumnType.Key };
  2.     ColumnSchema name = new("Name", "TEXT");
  3.     TableSchema table = new("Students", [id, name]);
  4.     CreateTable create = new(table);
  5. // Sqlite生成sql: CREATE TABLE "Students"("Id" INTEGER PRIMARY KEY AUTOINCREMENT,"Name" TEXT)
复制代码
4.2 表Schema查询示例
  1. UserTable table = new("Users", "tenant1");
  2. var query = new TableQuery(table)
  3.     .And(table.Status.EqualValue(true));
  4. var cursor = new TableCursor(query, 10, 20)
  5.     .Desc(table.Id);
  6. var select = new CursorSelect(cursor)
  7.     .Select(table.Id, table.Name);
  8. // MsSql生成sql: SELECT [Id],[Name] FROM [tenant1].[Users] WHERE [Status]=1 ORDER BY [Id] DESC OFFSET 20 ROWS FETCH NEXT 10 ROWS ONLY
复制代码
  1. public class UserTable(string tableName = "Users", string schema = "")
  2.     : TableSchema(tableName, [Defines.Id, Defines.Name, Defines.Status], schema)
  3. {
  4.     #region Columns
  5.     public readonly ColumnSchema Id = Defines.Id;
  6.     new public readonly ColumnSchema Name  = Defines.Name;
  7.     public readonly ColumnSchema Status = Defines.Status;
  8.     #endregion
  10.     class Defines
  11.     {
  12.         public static readonly ColumnSchema Id = new("Id") { ColumnType = ColumnType.Key };
  13.         public static readonly ColumnSchema Name = new("Name");
  14.         public static readonly ColumnSchema Status = new("Status");
  15.     }
  16. }
复制代码
4.3 DDL+表达式版查询示例
  1. var select = new TableSchema("Users", [], "tenant1")
  2.     .ToSqlQuery<User>()
  3.     .Where(u => u.Status)
  4.     .Take(10, 20)
  5.     .Desc(u => u.Id)
  6.     .ToSelect();
  7. // MsSql生成sql: SELECT * FROM [tenant1].[Users] WHERE [Status]=1 ORDER BY [Id] DESC OFFSET 20 ROWS FETCH NEXT 10 ROWS ONLY
复制代码
5. 易用版和表达式版一般不一起使用



  • 易用版和表达式版有同名类和方法,在不同命名空间
  • 同一个类引用命名空间ShadowSql和ShadowSql.Expressions调用某些方法会报不明确引用错误
  • 同一项目一个类用易用版,另一个类用表达式版是可行的
我们可以把ShadowSql当做乐高玩具一样看待,通过自己的组装可以实现意想不到的美妙效果
源码托管地址: https://github.com/donetsoftwork/Shadow ，也欢迎大家直接查看源码。
gitee同步更新:https://gitee.com/donetsoftwork/Shadow
文档地址: https://donetsoftwork.github.io/Shadow/expression/index.html
如果大家喜欢请动动您发财的小手手帮忙点一下Star。

来源：程序园用户自行投稿发布，如果侵权，请联系站长删除
免责声明：如果侵犯了您的权益，请联系站长，我们会及时删除侵权内容，谢谢合作！

使用道具 举报
相关推荐
B Color Image Link Quote Code Smilies
您需要登录后才可以回帖 登录 | 立即注册
发帖
但婆
3 天前

0

粉丝关注

9

主题发布

板块介绍填写区域，请于后台编辑
微信扫一扫