作者面向web应用开发13年,在项目实践与学习中去旧换新,吸取优点,从高质量、强规范、快速开发方向累积,形成生成器工具减少项目后端开发难度。
神一般的开发速度,navicat 管理ER图模型一目了然,同步好表结构后,使用本生成器一键同步c#实体,以及各种规范的花式和你想象不到的语法,支持缓存,支持数据库99%类型,挖掘数据库特性,避免过多的重复劳动和不规范、不健壮的代码。
优势:
- 1、根据主键、唯一键、外键(1对1,1对多,多对多)生成功能丰富的数据库 SDK;
- 2、严格把控数据库,避免随意创建表或字段,有标准的ER图数据库规范;
- 3、统一规范数据库操作类与方法(相比EF太随意的用法好管理很多),一条心堆业务;
- 4、优化每一个细节,决不允许低级错误干扰我们的业务逻辑(相比ORM,生成的代码更专注);
使用 navicat 模型工具创建和管理 ER 图,从数据库导入/同步结构到数据库,打心底里好用..
也可以使用 Microsoft SQL Server Management Studio 数据库关系图管理 ER 图..
下载生成器客户端试用,或者安装命令工具 dotnet tool install -g GenMs
共勉,一起学习QQ群:8578575
dotnet new mvc
GenMs 服务器 -U 登陆名 -P 密码 -D 数据库1 -N 命名空间
#GenMs 服务器 -D 数据库1 -N 命名空间
#如不提供 -U 参数,则使用管理员登陆
GenMs 服务器 -U 登陆名 -P 密码 -D 数据库1 -N 命名空间 -R -S -A
dotnetGen 保持相同的开发与使用习惯,现实了面向 mysql、SQLServer、PostgreSQL 三种数据库快速开发,也可混合使用。
功能对比 | dotnetGen_mysql | dotnetGen_sqlserver | dotnetGen_postgresql |
---|---|---|---|
windows | √ | √ | √ |
linux | √ | √ | √ |
连接池 | √ | √ | √ |
事务 | √ | √ | √ |
多数据库 | √ | - | - |
表 | √ | √ | √ |
表关系(1对1) | √ | √ | √ |
表关系(1对多) | √ | √ | √ |
表关系(多对多) | √ | √ | √ |
表主键 | √ | √ | √ |
表唯一键 | √ | √ | √ |
存储过程 | - | √ | - |
视图 | √ | √ | √ |
类型映射 | √ | √ | √ |
枚举 | √ | - | √ |
自定义类型 | - | - | √ |
gis | √ | - | √ |
数组 | - | - | √ |
字典 | - | - | √ |
xml | - | - | - |
json | - | - | √ |
缓存 | √ | √ | √ |
命令行生成 | √ | √ | √ |
RESTful | √ | √ | √ |
后台管理功能 | √ | √ | √ |
所有业务接口约定在 Module 划分开发
Module/Admin
生成的后台管理模块,http://localhost:5001/module/Admin 可访问
Module/Test
生成的测试模块
WebHost 编译的时候,会将 Module/* 所需文件复制到当前目录
WebHost 只当做主引擎运行时按需加载相应的 Module
WebHost 依赖 npm ,请安装 node,并在目录执行 npm install
运行步骤:
1、打开 vs 右击 Module 目录全部编译;
2、cd WebHost && npm install && dotnet build && dotnet run
Module 里面每个子模块的依赖所需
包含一切数据库操作的封装
xx.Model(实体映射 命名:表名Info)
xx.BLL(静态方法封装 命名:表名)
xx.DAL(数据访问 命名:表名)
生成名特征取数据库名首字母大写(如: 表 test 对应 xx.Model.TestInfo、xx.BLL.Test、xx.DAL.Test)
数据库设计命名习惯:所有命名(小写加下划线)、外键字段(对应主表名_主表PK名)
外键不支持组合字段,仅支持主键作为外键(ps: 不支持唯一键作为外键)
修改数据库后,双击“./GenMs只更新db.bat”可快速覆盖,所有类都使用 partial,方便代码扩展亦不会被二次生成覆盖
假设下面的代码都使用了 using xx.BLL; using xx.Model;
// 如有 create_time 字段并且类型为日期,内部会初始化
表名Info newitem1 = 表名.Insert(Title: "添加的标题", Content: "这是一段添加的内容");
表名Info newitem2 = 表名.Insert(new 表名Info { Title = "添加的标题", Content = "这是一段添加的内容" });
List<表名Info> newitems1 = 表名.Insert(new [] {
new 表名Info { Title = "添加的标题1", Content = "这是一段添加的内容1" },
new 表名Info { Title = "添加的标题2", Content = "这是一段添加的内容2" }
});
// 更新 id = 1 所有字段
表名Info newitem1 = 表名.Update(Id: 1, Title: "添加的标题", Content: "这是一段添加的内容", Clicks: 1);
表名Info newitem2 = 表名.Update(new 表名Info { Id: 1, Title = "添加的标题", Content = "这是一段添加的内容", Clicks = 1 });
// 更新 id = 1 指定字段
表名.UpdateDiy(1).SetTitle("修改后的标题").SetContent("修改后的内容").SetClicks(1).ExecuteNonQuery();
// update 表名 set clicks = clicks + 1 where id = 1
表名.UpdateDiy(1).SetClicksIncrement(1).ExecuteNonQuery();
// xx.Model 层也有 UpdateDiy,即 new 表名Info { Id = 1 }.UpdateDiy.SetClicks(1).ExecuteNonQuery();
//先查找 clicks 在 0 - 100 的记录
List<表名Info> newitems1 = 表名.Select.WhereClicksRange(0, 100).ToList();
// update 表名 set clicks = clicks + 1 where id in (newitems1所有id)
newitems1.UpdateDiy().SetClicksIncrement(1).ExecuteNonQuery();
// 删除 id = 1 的记录
表名.Delete(1);
appsettings可配置缓存时间,以上所有增、改、删都会删除缓存保障同步
//按主键获取
UserInfo user1 = BLL.User.GetItem(1);
//按唯一键
UserInfo user2 = BLL.User.GetItemByUsername("[email protected]");
// 返回 null 或 UserInfo
//BLL.表名.Select 是一个链式查询对象,几乎支持所有查询,包括 group by、inner join等等,最终 ToList ToOne Aggregate 执行 sql
List<UserInfo> users1 = BLL.User.Select.WhereUsername("[email protected]").WherePassword("******").WhereStatus(正常).ToList();
//返回 new List<UserInfo>() 或 有元素的 List,永不返回 null
//返回指定列,返回List<元组>
var users2 = BLL.User.Select.WhereStatus(正常).Aggregate<(int id, string title)>("id,title");
//多表查询,只返回 a 表字段
var users3 = BLL.User.Select.From<User_group>("b").Where("a.group_id = b.id").ToList();
//join查询,返回 a, b 表字段 ,将 b 表字段填充至 a表.Obj_user_group 对象,类似 ef.Include
var users4 = BLL.User.Select.InnerJoin<User_group>("b", "a.group_id = b.id").ToList();
//分组查询
var users5 = BLL.User.Select.GroupBy("group_id").Aggregate<(int groupId, int count)>("group_id, count(1)");
//等等...
//错误会回滚,事务内支持所有生成的同步方法(不支持生成对应的Async方法)
SqlHelper.Transaction(() => {
if (this.Balance.UpdateDiy.SetAmountIncrement(-num).ExecuteNonQuery() <= 0) throw new Exception("余额不足");
extdata["amountNew"] = this.Balance.Amount.ToString();
extdata["balanceChangelogId"] = RedisHelper.NewMongodbId();
order = this.AddBet_order(Amount: 1, Count: num, Count_off: num, Extdata: extdata, Status: Et_bet_order_statusENUM.NEW, Type: Et_bet_tradetypeENUM.拆分);
});
1、xxx.BLL GetItem、GetItemBy唯一键,使用了默认缓存策略180秒,用来缓存一条记录,db 层能自动维护缓存同步,例如:
//只有第一次查询了数据库,后面99次读取redis的缓存值
UserInfo u;
for (var a = 0; a < 100; a++)
u = BLL.User.GetItemByUsername("[email protected]");
//执行类似以下的数据变动方法,会删除redis对应的缓存
u.UpdateDiy.SetLogin_time(DateTime.Now).ExecuteNonQuery();
2、BLL.Select.ToList(10, "cache_key"),将查询结果缓存10秒,需要手工删除redis对应的键
- 没有主键,不会生成 增、改、删 方法
- 有自增字段,不会生成 批量 Insert 方法
-
有外键,会生成
new 主键表Info().Addxxx、new 主键表Model().Obj_外键表s
new 外键表Info().Obj_主键表、外键表.DeleteBy外键、外键表.Select.Where外键
-
多对多,会生成
new 表1Info().Flag表2、new 表1Info().UnFlag表2、new 表1Info().Obj_表2s、表1.Select.Where表2
new 表2Info().Flag表1、new 表2Info().UnFlag表1、new 表2Info().Obj_表1s、表2.Select.Where表1
-
字段类型 string相关并且长度 <= 300,会生成
表.Select.Where字段Like
-
95%的数据类型被支持