身份认证与应用安全 / 系统课时

实现角色数据加载接口

实现角色数据加载接口

角色校验要可靠,不能在控制器里手工判断用户类型,而应让 Sa-Token 通过统一接口取得当前账号的角色集合。本节实现 StpInterface.getRoleList,从用户角色关系表加载角色标识,并用 hasRole 验证结果。

学习目标

  • 理解角色集合与权限集合在 Sa-Token 中的独立职责
  • 根据 loginId 查询并返回有效角色标识
  • 验证 getRoleList、hasRole 使用的是业务库中的真实角色数据

角色校验依赖什么数据

StpInterface 同时提供权限和角色两个加载入口,其中 getRoleList(Object loginId, String loginType) 返回指定账号的角色标识集合。Sa-Token 的 getRoleList、hasRole、checkRole 等 API 会使用这组角色数据完成判断。([Sa-Token][1])

角色标识应是稳定的机器可读值,例如 admin、auditor,不要直接返回“系统管理员”这类展示名称。展示文本可以修改,而授权规则引用的角色码应长期稳定。

角色数据加载到 Sa-Token 并参与角色校验的流程

查询当前用户的角色集合

下面假设 sys_user_role 保存用户与角色关系,sys_role 保存角色信息,字段 role_code 是授权时使用的稳定角色标识。查询只返回启用状态的角色,并使用 DISTINCT 去重。

片段示例:代码依赖 Spring JDBC、已有数据源配置和上述两张业务表;为聚焦角色加载,权限方法暂时返回空集合。

java
import cn.dev33.satoken.stp.StpInterface;
import org.springframework.jdbc.core.JdbcTemplate;
import org.springframework.stereotype.Component;

import java.util.Collections;
import java.util.List;

@Component
public class StpInterfaceImpl implements StpInterface {

    private final JdbcTemplate jdbcTemplate;

    public StpInterfaceImpl(JdbcTemplate jdbcTemplate) {
        this.jdbcTemplate = jdbcTemplate;
    }

    @Override
    public List<String> getPermissionList(Object loginId, String loginType) {
        return Collections.emptyList();
    }

    @Override
    public List<String> getRoleList(Object loginId, String loginType) {
        long userId = Long.parseLong(loginId.toString());

        String sql =
                "SELECT DISTINCT r.role_code " +
                "FROM sys_user_role ur " +
                "JOIN sys_role r ON r.id = ur.role_id " +
                "WHERE ur.user_id = ? AND r.enabled = 1 " +
                "ORDER BY r.role_code";

        return jdbcTemplate.queryForList(sql, String.class, userId);
    }
}

如果项目已经在同一个 StpInterfaceImpl 中实现了权限加载,不要再创建第二个同类型 Bean;应把这里的 getRoleList 合并进现有实现类。这样权限和角色都由同一个授权数据入口提供,避免 Spring 容器中出现多个实现带来的歧义。

验证角色加载是否生效

准备测试数据:用户 1001 关联 admin 与 auditor 两个启用角色。该用户建立登录态后,在同一请求上下文中检查角色列表与目标角色。

片段示例:依赖当前请求已经通过 StpUtil.login(1001L) 登录。

java
System.out.println(StpUtil.getRoleList());
System.out.println(StpUtil.hasRole("admin"));

预期输出

text
[admin, auditor]
true

若 getRoleList() 返回空集合,先直接执行对应 SQL 检查关系数据,再确认 loginId 是否能转换为业务用户主键。若角色列表正确但 hasRole("admin") 为 false,通常是角色码大小写、前后空格或业务校验使用了展示名称而不是 role_code。

角色与权限不要混成一套标识

角色回答“这个人是什么身份”,权限回答“这个人能做什么”。例如 admin 是角色,而 user:delete 是权限。两者可以通过数据库关系关联,但在 Sa-Token 中仍应分别由 getRoleList 与 getPermissionList 返回。([Sa-Token][1])

这样做的好处是路由级身份限制可以使用角色校验,细粒度业务动作继续使用权限校验;角色调整时,权限集合也能通过业务关系自然变化,而不需要把身份判断散落到控制器和服务代码中。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

实现角色数据加载接口

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通