【.NET 8 实战--孢子记账--从单体到微服务】--简易权限--角色可访问接口管理

咱们继续来编写孢子记账的简易权限，这篇文章中我们将编写角色可访问接口的管理API，同样我不会把完整的代码全都列出来，只会列出部分代码，其余代码我希望大家能自己手动编写，然后对比项目代码。废话不多说，开讲。

一、需求

角色可访问接口的需求很简单，也就是简单的增删改查。

编号	功能	描述
1	新增	一个角色可绑定多个接口，但一个角色不能绑定同一个接口多次
2	删除	系统角色可访问的URL不可删除
3	修改	一个角色不能绑定同一个接口多次
4	查询	可根据角色名、接口地址进行模糊查询，实现分页功能
5	查询	根据角色可访问接口Id查询单个数据

二、编写代码

2.1 编写数据库映射类并迁移数据库

新增SysRoleUrl类，代码如下：

using SporeAccounting.BaseModels;
using System.ComponentModel.DataAnnotations;
using System.ComponentModel.DataAnnotations.Schema;

namespace SporeAccounting.Models;
/// <summary>
/// 角色可访问的URL
/// </summary>
[Table(name: "SysRoleUrl")]
public class SysRoleUrl : BaseModel
{
    /// <summary>
    /// 角色Id
    /// </summary>
    [Column(TypeName = "nvarchar(36)")]
    [Required]
    [ForeignKey("FK_SysRoleUrl_SysRole")]
    public string RoleId { get; set; }
    /// <summary>
    /// 接口路径
    /// </summary>
    [Column(TypeName = "nvarchar(36)")]
    [Required]
    [ForeignKey("FK_SysRoleUrl_SysUrl")]
    public string UrlId { get; set; }

    /// <summary>
    /// 导航属性
    /// </summary>
    public SysRole Role { get; set; }
    /// <summary>
    /// 导航属性
    /// </summary>
    public SysUrl Url { get; set; }
}

在数据库链接上下文类SporeAccountingDBContext1中增加SysRoleUrl ：

/// <summary>
/// 接口URL表
/// </summary>
public DbSet<SysUrl> SysUrls { get; set; }

在SysRole类中增加SysRoleUrl的导航属性：

/// <summary>
/// SysRoleUrl导航属性
/// </summary>
public ICollection<SysRoleUrl> RoleUrls { get; set; }

迁移数据库，迁移后的数据库如下图

2.2 编写业务逻辑

我们以删除为例，来看一下角色可访问接口如何编写。

新建服务接口ISysRoleUrlServer及其实现类SysRoleUrlImp

在接口及其实现类中增加Delete方法

//ISysRoleUrlServer
/// <summary>
/// 删除角色可访问的URL
/// </summary>
/// <param name="roleId"></param>
/// <param name="urlId"></param>
void Delete(string roleId, string urlId);

//SysRoleUrlImp
/// <summary>
/// 删除角色可访问的URL
/// </summary>
/// <param name="roleId"></param>
/// <param name="urlId"></param>
public void Delete(string roleId, string urlId)
{
    try
    {
        SysRoleUrl roleUrl = _dbContext.SysRoleUrls.
            FirstOrDefault(x => x.RoleId == roleId && x.UrlId == urlId);
        if (roleUrl != null)
        {
            _dbContext.SysRoleUrls.Remove(roleUrl);
            _dbContext.SaveChanges();
        }
    }
    catch (Exception e)
    {
        throw;
    }
}

新建SysRoleUrlController ，并实现Delete方法

using AutoMapper;
using Microsoft.AspNetCore.Mvc;
using SporeAccounting.BaseModels;
using SporeAccounting.BaseModels.ViewModel.Response;
using SporeAccounting.Models;
using SporeAccounting.Models.ViewModels;
using SporeAccounting.Server.Interface;
using System.Net;

namespace SporeAccounting.Controllers
{
    /// <summary>
    /// 角色可访问URL
    /// </summary>
    [Route("api/[controller]")]
    [ApiController]
    public class SysRoleUrlController : ControllerBase
    {
        private readonly ISysRoleUrlServer _sysRoleUrlServer;
        private readonly IMapper _mapper;
        public SysRoleUrlController(ISysRoleUrlServer sysRoleUrlServer,IMapper mapper)
        {
            _sysRoleUrlServer = sysRoleUrlServer;
            _mapper = mapper;
        }
        /// <summary>
        /// 删除角色可访问的URL
        /// </summary>
        /// <param name="roleId"></param>
        /// <param name="urlId"></param>
        /// <returns></returns>
        [HttpDelete]
        [Route("Delete/{roleId}/{urlId}")]
        public ActionResult<ResponseData<bool>> Delete([FromRoute] string roleId, [FromRoute] string urlId)
        {
            try
            {
                bool isExist = _sysRoleUrlServer.IsExist(roleId, urlId);
                if (!isExist)
                {
                    return Ok(new ResponseData<bool>(HttpStatusCode.NotFound, $"角色{roleId}不存在URL{urlId}！", false));
                }
                bool isDelete= _sysRoleUrlServer.IsDelete(roleId, urlId);
                if (!isDelete)
                {
                    return Ok(new ResponseData<bool>(HttpStatusCode.Conflict, $"角色{roleId}不允许删除URL{urlId}！", false));
                }
                _sysRoleUrlServer.Delete(roleId, urlId);
                return Ok(new ResponseData<bool>(HttpStatusCode.OK, data: true));
            }
            catch (Exception e)
            {
                return Ok(new ResponseData<bool>(HttpStatusCode.InternalServerError, "服务器异常", false));
            }
        }
    }
}

在上述代码中我们在执行删除操作时需要判断角色可访问接口是否存在以及角色可访问接口是否可以删除，因此需要在接口及其实现类中增加IsExist和IsDelete方法

//ISysRoleUrlServer
/// <summary>
/// 角色可访问的URL是否存在
/// </summary>
/// <param name="roleId"></param>
/// <param name="urlId"></param>
/// <returns></returns>
bool IsExist(string roleId, string urlId);

/// <summary>
/// 是否可以删除
/// </summary>
/// <param name="roleId"></param>
/// <param name="urlId"></param>
/// <returns></returns>
bool IsDelete(string roleId, string urlId);

//SysRoleUrlImp
/// <summary>
/// 角色可访问的URL是否存在
/// </summary>
/// <param name="roleId"></param>
/// <param name="url"></param>
/// <returns></returns>
public bool IsExist(string roleId, string urlId)
{
    try
    {
        return _dbContext.SysRoleUrls.Any(x => x.RoleId == roleId && x.UrlId == urlId);
    }
    catch (Exception e)
    {
        throw;
    }
}

/// <summary>
/// 是否可以删除
/// </summary>
/// <param name="roleId"></param>
/// <param name="urlId"></param>
/// <returns></returns>
public bool IsDelete(string roleId, string urlId)
{
    try
    {
        return _dbContext.SysRoleUrls
            .Any(x => x.RoleId == roleId && x.UrlId == urlId && x.CanDelete);
    }
    catch (Exception e)
    {
        throw;
    }
}