开篇
上一篇文章我们留了个尾巴,没有把freesql整合进去,这篇文章我们来整合。
目前的思路呢,是做一个简单的四不像的RABC,也有用户、角色、
权限三部分。
但是其中每个用户只有一个角色,即用户和角色之间是一多关系。每个角色可以有多个权限,即权限跟角色之间是多多关系。
这样主要是想说一下freesql怎么做一多和多多关系。一个正常的RABC用户和角色之间也应该是多多,并且用户可能跟权限也可以有直接的联系。但是这个是一样的,只要权限列表拿到了,后面就随便怎么处理了。
建表
这次我们只建立四个表User
、Role
、Permission
、RolePermisson
。
采用CodeFirst的方式,优先建立Entity,使用Freesql的数据库同步功能生成表结构。
User
表:
[Description("用户信息表")] public class UserEntity : BaseEntity<UserEntity, int> { [Description("用户名")] public string? UserName { get; set; } [Description("密码")] public string? Password { get; set; } [Description("用户姓名")] public string? Name { get; set; } [Description("角色Id")] public int RoleId { get; set; } [Description("角色")] [Navigate(nameof(RoleId))] public RoleEntity? Role { get; set; } }
借着User
表解释一下。
-
继承了
BaseEntity<UserEntity, int>
以后,会添加一个int
类型的Id,这个Id是自增的。同时还会自动生成CreateTime
、UpdateTime
、IsDeleted
、Sort
四个字段,这些都是BaseEntity自带的功能,使用BaseEntity在查询的时候会自动携带IsDeleted
标识,让我们可以轻松软删除。 -
Description
标签在Freesql里可以自动生成注释,由于sqlite不支持注释,所以这里没有用,单纯是作为注释来使用。 -
FreeSql
的一多关系,这里是一的部分,使用起来很简单,有一个RoleId
,然后定义一个RoleEntity
,标签里用Navigate
指定通过RoleId
来查询就行了。
Role
表:
[Description("角色表")] public class RoleEntity : BaseEntity<RoleEntity, int> { [Description("角色名称")] public string? Name { get; set; } [Description("用户")] [Navigate(nameof(UserEntity.RoleId))] public virtual ICollection<UserEntity>? Users { get; set; } [Description("权限")] [Navigate(ManyToMany = typeof(RolePermissionEntity))] public virtual ICollection<PermissionEntity>? Permissions { get; set; } }
-
Users
是用户角色一多关系的多的部分,我们只需要指定成ICollection
,List
也可以。使用Navigate
指定关联的名字为RoleId
就可以了。这里需要注意的是一定是关联RoleId
不是User
表的Id
,关联错了的话这里的关系就乱掉了。 -
Permissions
是角色权限多多关系的处理部分,属性写起来跟一多关系一样,但是Navigate
标签里不再是绑定一个字符串了,而是用ManyToMany
指定一个type
,这个type
是我们多多关系的中间表。这个表我们下面讲。
RolePermission
表
[Description("角色权限多多关系表")] public class RolePermissionEntity : BaseEntity<RolePermissionEntity, Guid> { [Description("角色Id")] public int RoleId { get; set; } [Description("角色")] [Navigate(nameof(RoleId))] public RoleEntity? Role { get; set; } [Description("权限Id")] public int PermissionId { get; set; } [Description("权限")] [Navigate(nameof(PermissionId))] public PermissionEntity? Permission { get; set; } }
-
严格来说,这个表不应该使用
BaseEntity
的模式,因为它应该是一个联合主键,不应该有个自增主键,并且也不需要那些CreateTime
、UpdateTime
、IsDeleted
、Sort
。但是这里为了省事,就直接用了,只是把主键类型改成了Guid
,反正我们也不会使用这玩意来排序查询。也不会影响频繁删除的情况下可能出现的溢出问题。 -
别的没什么好说的,就是两个属性
RoleId
和PermissionId
就i行了,如果用不着它,那Entity
都可以不加。
Permission
表
[Description("权限表")] public class PermissionEntity: BaseEntity<PermissionEntity, int> { [Description("权限名")] public string? Name { get; set; } [Description("对应页面Url")] public string? Url { get; set; } [Description("角色")] [Navigate(ManyToMany = typeof(RolePermissionEntity))] public virtual ICollection<RoleEntity>? Roles { get; set; } }
这个表没什么好说的了,就是一个多多关系,跟Role
的是一样的。
添加FreeSql
之前我们只是添加了FreeSql
的包,没有挂进程序里,现在我们把它弄到程序里去。
首先我们把连接字符串整到配置文件里去,比如我放在
"Db": { "ConnString": "Data Source=|DataDirectory|//document.db; Pooling=true;Min Pool Size=1" },
这样我们就可以在任何位置 用var conn = Furion.App.Configuration["Db:ConnString"];
获取到连接字符串了。
然后我们需要创建一个freesql
的实例
var freeSql = new FreeSqlBuilder() .UseAutoSyncStructure(Furion.App.WebHostEnvironment.IsDevelopment()) .UseConnectionString(DataType.Sqlite, conn) .Build();
这里的UseAutoSyncStructure
是是否开启自动迁移,如果开启了,freesql用的时候发现没有表或者表结构不对,就自动迁移表结构,这个东西生产上不建议用,所以我们就只有在Development的时候使用。
然后我们的Entity
都有Entity
后缀,这个放到数据库里不好看,我们就把它给去掉
freeSql.Aop.ConfigEntity += (s, e) => { e.ModifyResult.Name = e.EntityType.Name.Replace("Entity", ""); };
另外如果你需要加前缀,或者改大小写,改下划线都可以在这里金信处理。
因为我们使用的是BaseEntity
模式,所以这里需要初始化
BaseEntity.Initialization(freeSql, null);
最后我们还需要添加一些默认的用户,角色,权限
if (!UserEntity.Where(x => x.UserName == "Admin").Any()) { UserEntity user = new UserEntity() { UserName = "Admin", Password = MD5Encryption.Encrypt("Admin"), Name = "张三" }; user.Save(); PermissionEntity homePermission = new PermissionEntity() { Name = "首页", Url = "/" }; homePermission.Save(); PermissionEntity userPermission = new PermissionEntity() { Name = "用户管理", Url = "/User" }; userPermission.Save(); RoleEntity role = new RoleEntity() { Name = "管理员", Users = new List<UserEntity>() { user }, Permissions = new List<PermissionEntity>(){homePermission, userPermission} }; role.Save().SaveMany(nameof(RoleEntity.Users)); role.SaveMany(nameof(RoleEntity.Permissions)); }
这里需要注意,如果有多表的部分需要连其他的表一起更新,那就需要主动调用SaveMany
方法,如果不调用,那么不会自动更新。
源码在github:https://github.com/j4587698/BlazorLearn,分支lesson2。