基于RBAC权限模型的权限管理模块实现详解

最新推荐文章于 2025-06-08 21:54:09 发布
原创 最新推荐文章于 2025-06-08 21:54:09 发布 · 1k 阅读 · 19 ·
CC 4.0 BY-SA版权
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
文章标签：

#spring #java #后端

基于RBAC权限模型的权限管理模块实现详解

简介

权限管理是企业级应用中的核心模块之一，它确保系统中的不同用户能够访问和操作与其角色相匹配的资源。通过权限管理，系统可以实现对资源的精细控制，防止未授权访问和操作。本文将详细介绍一个基于Spring Boot的权限管理模块的实现过程，涵盖权限的增删改查、权限分配等功能，并详细介绍每个接口的访问路径、入参、出参以及具体实现。

代码结构

项目的主要代码结构如下：

  • EntitlementController.java: 权限管理的控制器，负责处理HTTP请求。
  • EntitlementService.java: 权限管理的服务接口，定义了权限管理的核心业务逻辑。
  • EntitlementServiceImpl.java: 权限管理服务的具体实现类。
  • SysEntitlement.java: 系统权限实体类，对应数据库中的权限表。
  • SysRoleEntRela.java: 角色与权限的关联表实体类。
  • SysEntitlementMapper.xml: MyBatis的Mapper文件，定义了权限相关的SQL操作。

功能实现解析

1. 权限管理功能

1.1 权限查询

接口路径: /api/entitlement/list

请求方法: GET

入参:

  • entId (可选): 权限ID，用于精确查询。
  • entName (可选): 权限名称，用于模糊查询。
  • stratPage (可选): 起始页，默认为1。
  • limit (可选): 每页条数，默认为10。

出参:

  • current: 当前页码。
  • total: 总条数。
  • records: 权限列表，包含权限ID、权限名称、菜单图标、菜单URI、组件名称等信息。
  • hasNext: 是否还有下一页。

具体实现:

  1. 参数校验：检查分页参数是否为空，如果为空则设置默认值。

    if (ObjectUtil.isEmpty(stratPage)){
    stratPage = 1;
}
if (ObjectUtil.isEmpty(limit)){
    limit = 10;
}

  2. 查询权限列表：调用entitlementMapper.selectEntitlementList方法，根据权限ID或权限名称进行模糊查询，并返回分页结果。

    List<SysEntitlement> records = entitlementMapper.selectEntitlementList(entId, entName, stratPage, limit);

  3. 返回结果：将查询结果封装到EntitlementListDTO对象中返回。

    EntitlementListDTO entitlementListDTO = new EntitlementListDTO();
entitlementListDTO.setCurrent(current);
entitlementListDTO.setTotal(total);
entitlementListDTO.setRecords(records);
entitlementListDTO.setHasNext(hasNext);

return ResSerialization.success(entitlementListDTO);

示例请求:

GET /api/entitlement/list?entName=admin&stratPage=1&limit=10

示例响应:

{
  "current": 1,
  "total": 5,
  "records": [
    {
      "entId": "ENT_12345",
      "entName": "admin",
      "menuIcon": "icon-admin",
      "menuUri": "/admin",
      "componentName": "AdminComponent",
      "createdAt": "2025-01-01 12:00:00",
      "updatedAt": "2025-01-01 12:00:00"
    }
  ],
  "hasNext": false
}

在这里插入图片描述

1.2 权限创建

接口路径: /api/entitlement

请求方法: POST

入参:

  • entName: 权限名称，必填。
  • menuIcon: 菜单图标，必填。
  • menuUri: 菜单URI，必填。
  • componentName: 组件名称，必填。
  • entType: 权限类型，必填。
  • quickJump: 快速开始菜单，必填。
  • state: 状态，必填。
  • pid: 父ID，必填。
  • entSort: 排序字段，必填。

出参:

  • code: 响应码，200表示成功。
  • message: 响应消息。
  • data: 返回的数据，通常为空。

具体实现:

  1. 参数校验：检查权限名称、菜单图标、菜单URI、组件名称等是否为空，如果为空则抛出相应的异常。

    if (ObjectUtil.isEmpty(entitlementCreateVO.getEntName())){
    throw new QLException(ENT_NAME_NOT_NULL);
}
if (ObjectUtil.isEmpty(entitlementCreateVO.getMenuIcon())){
    throw new QLException(MENU_ICON_NOT_NULL);
}
if (ObjectUtil.isEmpty(entitlementCreateVO.getMenuUri())){
    throw new QLException(MENU_URI_NOT_NULL);
}
if (ObjectUtil.isEmpty(entitlementCreateVO.getComponentName())){
    throw new QLException(COMPONENT_NAME_NOT_NULL);
}

  2. 保存权限信息：将EntitlementCreateVO中的属性复制到SysEntitlement对象中，并保存到权限表中。

    SysEntitlement sysEntitlement = BeanUtil.copyProperties(entitlementCreateVO, SysEntitlement.class);
sysEntitlement.setEntId("ENT_" + IdUtil.fastSimpleUUID());
sysEntitlement.setCreatedAt(new Date());
sysEntitlement.setUpdatedAt(new Date());

OperationUtil.executeOperation(() -> this.save(sysEntitlement), ENTITLEMENT_SAVE_ERROR);

  3. 返回结果：返回创建操作的结果。

    return ResSerialization.success();

示例请求:

POST /api/entitlement
Content-Type: application/json

{
  "entName": "admin",
  "menuIcon": "icon-admin",
  "menuUri": "/admin",
  "componentName": "AdminComponent",
  "entType": "PB",
  "quickJump": 1,
  "state": 1,
  "pid": "ENT_0",
  "entSort": 1
}

示例响应:

{
  "code": 200,
  "message": "成功",
  "data": null
}
1.3 权限更新

接口路径: /api/entitlement/{entId}

请求方法: PUT

入参:

  • entId: 权限ID，路径参数。
  • entName: 权限名称，必填。
  • menuIcon: 菜单图标，必填。
  • menuUri: 菜单URI，必填。
  • componentName: 组件名称，必填。
  • entType: 权限类型，必填。
  • quickJump: 快速开始菜单，必填。
  • state: 状态，必填。
  • pid: 父ID，必填。
  • entSort: 排序字段，必填。

出参:

  • code: 响应码，200表示成功。
  • message: 响应消息。
  • data: 返回的数据，通常为空。

具体实现:

  1. 参数校验：检查权限名称、菜单图标、菜单URI、组件名称等是否为空，如果为空则抛出相应的异常。

    if (ObjectUtil.isEmpty(entitlementUpdateVO.getEntName())){
    throw new QLException(ENT_NAME_NOT_NULL);
}
if (ObjectUtil.isEmpty(entitlementUpdateVO.getMenuIcon())){
    throw new QLException(MENU_ICON_NOT_NULL);
}
if (ObjectUtil.isEmpty(entitlementUpdateVO.getMenuUri())){
    throw new QLException(MENU_URI_NOT_NULL);
}
if (ObjectUtil.isEmpty(entitlementUpdateVO.getComponentName())){
    throw new QLException(COMPONENT_NAME_NOT_NULL);
}

  2. 更新权限信息：将EntitlementUpdateVO中的属性复制到SysEntitlement对象中，并更新权限表。

    SysEntitlement sysEntitlement = BeanUtil.copyProperties(entitlementUpdateVO, SysEntitlement.class);
sysEntitlement.setUpdatedAt(new Date());

OperationUtil.executeOperation(() -> this.updateById(sysEntitlement), ENTITLEMENT_UPDATE_ERROR);

  3. 返回结果：返回更新操作的结果。

    return ResSerialization.success();

示例请求:

PUT /api/entitlement/ENT_12345
Content-Type: application/json

{
  "entName": "admin",
  "menuIcon": "icon-admin",
  "menuUri": "/admin",
  "componentName": "AdminComponent",
  "entType": "PB",
  "quickJump": 1,
  "state": 1,
  "pid": "ENT_0",
  "entSort": 1
}

示例响应:

{
  "code": 200,
  "message": "成功",
  "data": null
}
1.4 权限删除

接口路径: /api/entitlement/{entId}

请求方法: DELETE

入参:

  • entId: 权限ID，路径参数。

出参:

  • code: 响应码，200表示成功。
  • message: 响应消息。
  • data: 返回的数据，通常为空。

具体实现:

  1. 删除权限信息：根据权限ID删除权限表中的记录。

    boolean isDelete = this.removeById(entId);
if (!isDelete){
    throw new QLException(ENTITLEMENT_REMOVE_ERROR);
}

  2. 删除角色与权限的关联信息：删除角色与权限的关联表中的记录。

    LambdaQueryWrapper<SysRoleEntRela> wrapper = new LambdaQueryWrapper<>();
wrapper.eq(SysRoleEntRela::getEntId, entId);
sysRoleEntRelaMapper.delete(wrapper);

  3. 返回结果：返回删除操作的结果。

    return ResSerialization.success();

示例请求:

DELETE /api/entitlement/ENT_12345

示例响应:

{
  "code": 200,
  "message": "成功",
  "data": null
}

2. 权限控制

在EntitlementController中，使用了SaCheckRole注解进行权限控制。例如，创建权限和更新权限的操作需要特定的角色权限才能执行。通过StpUtil.getLoginIdAsLong()方法获取当前登录用户的ID，并进行权限校验。

@SaCheckRole(value = {"admin", "super_admin"}, mode = SaMode.OR)
@PostMapping()
ResSerialization<String> createEntitlement(@RequestBody EntitlementCreateVO entitlementCreateVO){
    // 创建权限逻辑
}

@SaCheckRole(value = {"admin", "super_admin"}, mode = SaMode.OR)
@PutMapping("/{entId}")
ResSerialization<String> updateEntitlement(@PathVariable String entId, @RequestBody EntitlementUpdateVO entitlementUpdateVO){
    // 更新权限逻辑
}

总结

通过本文的详细解析，我们深入探讨了一个基于Spring Boot的权限管理模块的实现过程。该模块涵盖了权限的增删改查、权限分配等功能，并通过Sa-Token实现了权限控制。通过合理的代码结构和清晰的业务逻辑，确保了系统的高效性和可维护性。

希望本文的解析能够为开发者提供有价值的参考，帮助大家在实际项目中更好地设计和实现权限管理模块。如果你正在构建一个类似的系统，不妨借鉴本文的思路和代码实现，相信它会为你的项目带来更多的灵活性和稳定性。

让我们一起在代码的世界里，构建更加安全、高效的系统吧！ 🚀

基于RBAC的通用权限管理系统的详细分析与实现（理念篇——权限对象、权限项、功能权限、数据权限、权限组、权限设计）
晓风残月淡的博客
10-02 6698
在与人沟通的过程中，我们很多次提到了权限，但是权限具体的含义每个人理解的含义都不明确，这样很容易造成双方信息不对称，有的人就只是把权限理解成某个页面的是否可访问，但是有的人却理解成其他的东西。 所以我们要彻底的定义一下权限是什么？ “权限”这个词语，我们谈论时到底是名词属性还是动词属性？这对于权限的含义很重要。 如果是名词属性的话，那么它应该是有具体的指代物；如果是动词，则应该具有行为表示。 - 权限的名词属性：api接口、页面、业务功能等。 - 权限的动词属性：可访问、新增、编辑、可操作、不可操作等
基于RBAC的通用权限管理系统的详细分析与实现（理念篇——用户、组织和用户组）
晓风残月淡的博客
07-19 1928
RBAC模型是将客体的存取访问的权限在可靠的控制下连带角色所需要的操作一起提供给那些角色所代表的用户，通过授权的管理机制，可以授予一个角色多个权限，而一个权限也可以赋予多个角色，同时一个用户可以扮演多个角色，一个角色又可以接纳多个用户。
基于RBAC 的权限实现Demo
01-26
基于角色的权限访问控制（Role-Based Access Control）作为传统访问控制（自主访问，强制访问）的有前景的代替受到广泛的关注。在RBAC中，权限与角色相关联，用户通过成为适当角色的成员而得到这些角色的权限。这就极大地简化了权限的管理。
RBAC权限实现
weixin_39218464的博客
04-05 629
rules //组的权限，1,2(这里由数字和逗号拼接组成,每个id代表一个权限id,即rule_id,即auth_rule这个表的主键)2.auth_group表 (用户组表，一个用户可以属于多个组，一个组可以有多个用户，属于多对多,用户连接组对应的权限)3.auth_group_access表(用户和用户组的对应关系，是用户表和用户组表的一个中间表，启动连接作用)mca //既是菜单的url也是权限的url，用户关联权限表。id //rule_id权限id。group_id //组id。
​RBAC（基于角色的访问控制）权限管理详解
最新发布
asom12的博客
06-08 840
RBAC（基于角色的访问控制）是一种权限管理模型，通过角色作为中间层连接用户和权限。核心是将用户与角色绑定，角色与权限绑定，实现灵活高效的权限控制。RBAC包含基础模型（RBAC0）、角色继承（RBAC1）、约束（RBAC2）和混合模型（RBAC3）。优势包括解耦用户权限、灵活角色分配、支持继承和便于审计。适用于企业管理系统、CMS、云平台等场景。相比ABAC，RBAC更适合角色固定的系统。现代开发框架已广泛支持RBAC实现。
权限管理 数据权限 功能权限 模块权限
王鹤霖的专栏 三人行必有我师
11-06 1445
通用数据权限管理系统设计 https://blog.csdn.net/fly_cloud/article/details/1041807 新一代细粒度权限管理 http://www.blogjava.net/metadmin Ralasafe Cookbook https://www.cnblogs.com/skyme/articles/3208203.html Ralasafe De...
RBAC 权限控制：深入到按钮级别的实现
x15514104477的博客
04-08 1490
本文章详细讲解了，按钮级别的权限控制，详细讲解了前端（vue）和后端（node）的实现思路，保姆级教学
RBAC权限管理概念
zxcvb0825的博客
01-06 1923
基于RBAC模型的权限设计：如何设计系统权限体系？ | 人人都是产品经理
J2EE-RBAC权限管理详解：实现、用户关联与特殊授权
J2EE-RBAC权限管理是一种基于角色的权限管理体系，它在企业级Java应用（J2EE）环境中用于实现细致的权限控制。RBAC（Role-Based Access Control）的核心概念包括用户、角色、资源和权限这四个基本元素。 1. **模型...
Struts_Spring_Hibernate构建RBAC权限管理系统详解
本权限管理系统结合了上述三种技术，构建了一个高效且易于管理的RBAC权限系统。下面将具体介绍实现该系统的相关知识点。 ### Struts框架相关知识点 - **MVC模式：** Struts实现了MVC架构模式，其中Action类作为...
RBAC权限系统
python编程
11-28 1226
通过角色管理权限，而不是通过员工管理权限的系统 先在Django项目中新建一个app专门管理权限 告诉Django项目多了一个app 在新建的app下面新建表 from django.db import models # Create your models here. class Permission(models.Model): title = models.CharFie...
RBAC权限控制代码
11-23
简单的RBAC权限管理，包含了监听器、过滤器和拦截器，带有sql文件。
从0实现RBAC权限模型
hezf_hero的博客
07-06 624
RBAC 基于角色的访问控制（Role-based access control），指的是通过用户的角色（Role）授权其相关权限，这实现了更灵活的访问控制，相比直接授予用户权限，要更加简单、高效、可扩展。
基于 RBAC(Role-Based Access Control, 基于角色访问控制) 简单实现动态菜单及权限管理
chu
01-08 900
RBAC
RBAC权限详解
xm1037782843的博客
07-30 9376
RBAC权限详解
后台管理系统----day17
weixin_45228198的博客
04-14 875
用户权限 一个商城，后台维护人员不只一个，还有其他后台人员，如：信息录入员、财务、运营、采购等人员，他们对应的角色不同，所对应的权限也不相同，需要后台管理员来分配权限。 1. RBAC介绍 RBAC概述 在网站中，用户通过URL地址，进入网站的后端逻辑，从而对网站的数据库进行操作管理。可以让拥有权限的用户来完成操作，而没有权限的用户无法操作. RBAC是基于角色的访问控制（Role-Based Access Control ），在RBAC中，权限与角色相关联，用户通过成为适当角色的成员而得到这些角色的权
RBAC权限管理
Java领域
07-06 9815
本博文会着重介绍一下RBAC的相关内容。BAC是Role-Based Access Control的缩写，含义为基于角色的访问控制模型，此模型是20世纪90年代在美国第十五届全国计算机安全大会上提出的，后逐步被业界广泛使用，至2004年形成了ANSI/INCITS标准。时至今日，RBAC访问控制模型已经渗入IT领域的多个方面，有传统技术方面的操作系统、数据库、中间件Web服务器，有新兴技术方面的Kubernetes、Puppet、OpenStack等。
RBAC——基于角色权限的模型
热门推荐
林隐的博客
10-21 7万+
学习RBAC——基于角色权限的模型
RBAC权限管理（详细）
萌萌的博客
08-30 3万+
RABC权限设计思想 为了达成不同账号(员工、总裁)登录系统后看到不同页面，执行不同功能，RABC(Role-Based Access control)权限模型，就是根据角色的权限，分配可视页面。 三个关键点: 用户:使用系统的人 角色：使用系统的人是什么职位(员工、经理、总裁) 权限点：职位可以做的事情(左侧菜单栏中的功能模块——>增删改查) 测试流程： ①在员工管理页新增员工这是三要素中的用户 ②为新增的员工分配角色 ③在公司设置里为角色分配权限 ????系统中的权限不能随意添加，必须是以开发出
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包

打赏作者

攒了一袋星辰

你的鼓励将是我创作的最大动力

¥1 ¥2 ¥4 ¥6 ¥10 ¥20
扫码支付：¥1
获取中
扫码支付

您的余额不足，请更换扫码支付或充值

打赏作者

实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值