从零开始Blazor Server(2)--整合数据库

开篇

上一篇文章我们留了个尾巴，没有把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。