lsm/sa-token
1
0
Fork 0
mirror of https://gitee.com/dromara/sa-token.git synced 2026-02-27 16:50:24 +08:00
Code Issues Actions Packages Projects Releases Wiki Activity

增加阶梯封禁功能

Browse Source
This commit is contained in:
click33
2022-09-08 10:16:07 +08:00
parent 4d8e35208d
commit cb31c61efd
17 changed files with 903 additions and 289 deletions
Download Patch File Download Diff File Expand all files Collapse all files
sa-token-core/src/main/java/cn/dev33/satoken/annotation/SaCheckDisable.java
+7
View File
@@ -30,5 +30,12 @@ public @interface SaCheckDisable {
* @return see note
*/
String[] value() default { SaTokenConsts.DEFAULT_DISABLE_SERVICE };
/**
* 封禁等级（只有 封禁等级 ≥ 此值 才会抛出异常）
*
* @return /
*/
int level() default SaTokenConsts.DEFAULT_DISABLE_LEVEL;
}
sa-token-core/src/main/java/cn/dev33/satoken/exception/DisableServiceException.java
+45 -12
View File
@@ -12,7 +12,8 @@ public class DisableServiceException extends SaTokenException {
*/
private static final long serialVersionUID = 6806129545290130143L;
/** 异常标记值 */
/** 异常标记值（已更改为 SaTokenConsts.DEFAULT_DISABLE_LEVEL） */
@Deprecated
public static final String BE_VALUE = "disable";
/** 异常提示语 */
@@ -27,11 +28,6 @@ public class DisableServiceException extends SaTokenException {
* 被封禁的账号id
*/
private Object loginId;
/**
* 封禁剩余时间，单位：秒
*/
private long disableTime;
/**
* 具体被封禁的服务
@@ -39,9 +35,24 @@ public class DisableServiceException extends SaTokenException {
private String service;
/**
* 获取账号类型
* 具体被封禁的等级
*/
private int level;
/**
* 校验时要求低于的等级
*/
private int limitLevel;
/**
* 封禁剩余时间，单位：秒
*/
private long disableTime;
/**
* 获取：账号类型
*
* @return See Note
* @return /
*/
public String getLoginType() {
return loginType;
@@ -50,7 +61,7 @@ public class DisableServiceException extends SaTokenException {
/**
* 获取: 被封禁的账号id
*
* @return See above
* @return /
*/
public Object getLoginId() {
return loginId;
@@ -59,15 +70,33 @@ public class DisableServiceException extends SaTokenException {
/**
* 获取: 被封禁的服务
*
* @return See above
* @return /
*/
public Object getService() {
return service;
}
/**
* 获取: 被封禁的等级
*
* @return /
*/
public int getLevel() {
return level;
}
/**
* 获取: 校验时要求低于的等级
*
* @return /
*/
public int getLimitLevel() {
return limitLevel;
}
/**
* 获取: 封禁剩余时间，单位：秒
* @return See above
* @return /
*/
public long getDisableTime() {
return disableTime;
@@ -79,13 +108,17 @@ public class DisableServiceException extends SaTokenException {
* @param loginType 账号类型
* @param loginId 被封禁的账号id
* @param service 具体封禁的服务
* @param level 被封禁的等级
* @param limitLevel 校验时要求低于的等级
* @param disableTime 封禁剩余时间，单位：秒
*/
public DisableServiceException(String loginType, Object loginId, String service, long disableTime) {
public DisableServiceException(String loginType, Object loginId, String service, int level, int limitLevel, long disableTime) {
super(BE_MESSAGE + service);
this.loginId = loginId;
this.loginType = loginType;
this.service = service;
this.level = level;
this.limitLevel = limitLevel;
this.disableTime = disableTime;
}
sa-token-core/src/main/java/cn/dev33/satoken/listener/SaTokenEventCenter.java
+3 -2
View File
@@ -177,11 +177,12 @@ public class SaTokenEventCenter {
* @param loginType 账号类别
* @param loginId 账号id
* @param service 指定服务
* @param level 封禁等级
* @param disableTime 封禁时长，单位: 秒
*/
public static void doDisable(String loginType, Object loginId, String service, long disableTime) {
public static void doDisable(String loginType, Object loginId, String service, int level, long disableTime) {
for (SaTokenListener listener : listenerList) {
listener.doDisable(loginType, loginId, service, disableTime);
listener.doDisable(loginType, loginId, service, level, disableTime);
}
}
sa-token-core/src/main/java/cn/dev33/satoken/listener/SaTokenListener.java
+2 -1
View File
@@ -48,9 +48,10 @@ public interface SaTokenListener {
* @param loginType 账号类别
* @param loginId 账号id
* @param service 指定服务
* @param level 封禁等级
* @param disableTime 封禁时长，单位: 秒
*/
public void doDisable(String loginType, Object loginId, String service, long disableTime);
public void doDisable(String loginType, Object loginId, String service, int level, long disableTime);
/**
* 每次被解封时触发
sa-token-core/src/main/java/cn/dev33/satoken/listener/SaTokenListenerForConsolePrint.java
+2 -2
View File
@@ -49,9 +49,9 @@ public class SaTokenListenerForConsolePrint implements SaTokenListener {
* 每次被封禁时触发
*/
@Override
public void doDisable(String loginType, Object loginId, String service, long disableTime) {
public void doDisable(String loginType, Object loginId, String service, int level, long disableTime) {
Date date = new Date(System.currentTimeMillis() + disableTime * 1000);
println("账号[" + loginId + "] " + service + " 服务被封禁 (解封时间: " + SaFoxUtil.formatDate(date) + ")");
println("账号[" + loginId + "] " + service + " 服务被封禁，封禁等级=" + level + " (解封时间: " + SaFoxUtil.formatDate(date) + ")");
}
/**
sa-token-core/src/main/java/cn/dev33/satoken/listener/SaTokenListenerForSimple.java
+1 -1
View File
@@ -33,7 +33,7 @@ public class SaTokenListenerForSimple implements SaTokenListener {
}
@Override
public void doDisable(String loginType, Object loginId, String service, long disableTime) {
public void doDisable(String loginType, Object loginId, String service, int level, long disableTime) {
}
sa-token-core/src/main/java/cn/dev33/satoken/stp/StpLogic.java
+191 -71
View File
@@ -1654,102 +1654,105 @@ public class StpLogic {
}
/**
* 根据注解(@SaCheckEnable)鉴权
* 根据注解(@SaCheckDisable)鉴权
*
* @param at 注解对象
*/
public void checkByAnnotation(SaCheckDisable at) {
this.checkDisable(getLoginId(), at.value());
Object loginId = getLoginId();
for (String service : at.value()) {
this.checkDisableLevel(loginId, service, at.level());
}
}
// ------------------- 账号封禁 -------------------
/**
* 封禁指定账号
* 封禁：指定账号
* <p> 此方法不会直接将此账号id踢下线，如需封禁后立即掉线，请追加调用 StpUtil.logout(id)
*
* @param loginId 指定账号id
* @param disableTime 封禁时间, 单位: 秒 （-1=永久封禁）
* @param time 封禁时间, 单位: 秒 （-1=永久封禁）
*/
public void disable(Object loginId, long disableTime) {
disable(loginId, SaTokenConsts.DEFAULT_DISABLE_SERVICE, disableTime);
public void disable(Object loginId, long time) {
disableLevel(loginId, SaTokenConsts.DEFAULT_DISABLE_SERVICE, SaTokenConsts.DEFAULT_DISABLE_LEVEL, time);
}
/**
* 封禁 指定账号 指定服务
* <p> 此方法不会直接将此账号id踢下线，如需封禁后立即掉线，请追加调用 StpUtil.logout(id)
* @param loginId 指定账号id
* @param service 指定服务
* @param disableTime 封禁时间, 单位: 秒 （-1=永久封禁）
*/
public void disable(Object loginId, String service, long disableTime) {
// 空值检查
if(SaFoxUtil.isEmpty(loginId)) {
throw new SaTokenException("请提供要封禁的账号");
}
if(SaFoxUtil.isEmpty(service)) {
throw new SaTokenException("请提供要封禁的服务");
}
// 标注为已被封禁
getSaTokenDao().set(splicingKeyDisable(loginId, service), DisableServiceException.BE_VALUE, disableTime);
// $$ 发布事件
SaTokenEventCenter.doDisable(loginType, loginId, service, disableTime);
}
/**
* 指定账号是否已被封禁 (true=已被封禁, false=未被封禁)
* 判断：指定账号是否已被封禁 (true=已被封禁, false=未被封禁)
*
* @param loginId 账号id
* @return see note
* @return /
*/
public boolean isDisable(Object loginId) {
return isDisable(loginId, SaTokenConsts.DEFAULT_DISABLE_SERVICE);
return isDisableLevel(loginId, SaTokenConsts.DEFAULT_DISABLE_SERVICE, SaTokenConsts.MIN_DISABLE_LEVEL);
}
/**
* 指定账号 指定服务 是否已被封禁 (true=已被封禁, false=未被封禁)
* @param loginId 账号id
* @param service 指定服务
* @return see note
*/
public boolean isDisable(Object loginId, String service) {
return getSaTokenDao().get(splicingKeyDisable(loginId, service)) != null;
}
/**
* 校验指定账号是否已被封禁，如果被封禁则抛出异常
* 校验：指定账号是否已被封禁，如果被封禁则抛出异常
* @param loginId 账号id
*/
public void checkDisable(Object loginId) {
checkDisable(loginId, SaTokenConsts.DEFAULT_DISABLE_SERVICE);
checkDisableLevel(loginId, SaTokenConsts.DEFAULT_DISABLE_SERVICE, SaTokenConsts.MIN_DISABLE_LEVEL);
}
/**
* 校验 指定账号 指定服务 是否已被封禁，如果被封禁则抛出异常
* 获取：指定账号剩余封禁时间，单位：秒（-1=永久封禁，-2=未被封禁）
* @param loginId 账号id
* @param services 指定服务，可以指定多个
*/
public void checkDisable(Object loginId, String... services) {
if(services != null) {
for (String service : services) {
if(isDisable(loginId, service)) {
throw new DisableServiceException(loginType, loginId, service, getDisableTime(loginId, service));
}
}
}
}
/**
* 获取 指定账号 剩余封禁时间，单位：秒（-1=永久封禁，-2=未被封禁）
* @param loginId 账号id
* @return see note
* @return /
*/
public long getDisableTime(Object loginId) {
return getDisableTime(loginId, SaTokenConsts.DEFAULT_DISABLE_SERVICE);
}
/**
* 获取 指定账号 指定服务 剩余封禁时间，单位：秒（-1=永久封禁，-2=未被封禁）
* 解封：指定账号
* @param loginId 账号id
*/
public void untieDisable(Object loginId) {
untieDisable(loginId, SaTokenConsts.DEFAULT_DISABLE_SERVICE);
}
// ------------------- 分类封禁 -------------------
/**
* 封禁：指定账号的指定服务
* <p> 此方法不会直接将此账号id踢下线，如需封禁后立即掉线，请追加调用 StpUtil.logout(id)
* @param loginId 指定账号id
* @param service 指定服务
* @param time 封禁时间, 单位: 秒 （-1=永久封禁）
*/
public void disable(Object loginId, String service, long time) {
disableLevel(loginId, service, SaTokenConsts.DEFAULT_DISABLE_LEVEL, time);
}
/**
* 判断：指定账号的指定服务 是否已被封禁 (true=已被封禁, false=未被封禁)
* @param loginId 账号id
* @param service 指定服务
* @return /
*/
public boolean isDisable(Object loginId, String service) {
return isDisableLevel(loginId, service, SaTokenConsts.MIN_DISABLE_LEVEL);
}
/**
* 校验：指定账号 指定服务 是否已被封禁，如果被封禁则抛出异常
* @param loginId 账号id
* @param services 指定服务，可以指定多个
*/
public void checkDisable(Object loginId, String... services) {
if(services != null) {
for (String service : services) {
checkDisableLevel(loginId, service, SaTokenConsts.MIN_DISABLE_LEVEL);
}
}
}
/**
* 获取：指定账号 指定服务 剩余封禁时间，单位：秒（-1=永久封禁，-2=未被封禁）
* @param loginId 账号id
* @param service 指定服务
* @return see note
@@ -1759,15 +1762,7 @@ public class StpLogic {
}
/**
* 解封指定账号
* @param loginId 账号id
*/
public void untieDisable(Object loginId) {
untieDisable(loginId, SaTokenConsts.DEFAULT_DISABLE_SERVICE);
}
/**
* 解封指定账号、指定服务
* 解封：指定账号、指定服务
* @param loginId 账号id
* @param services 指定服务，可以指定多个
*/
@@ -1788,7 +1783,132 @@ public class StpLogic {
SaTokenEventCenter.doUntieDisable(loginType, loginId, service);
}
}
// ------------------- 阶梯封禁 -------------------
/**
* 封禁：指定账号，并指定封禁等级
* @param loginId 指定账号id
* @param level 指定封禁等级
* @param time 封禁时间, 单位: 秒 （-1=永久封禁）
*/
public void disableLevel(Object loginId, int level, long time) {
disableLevel(loginId, SaTokenConsts.DEFAULT_DISABLE_SERVICE, level, time);
}
/**
* 封禁：指定账号的指定服务，并指定封禁等级
* @param loginId 指定账号id
* @param service 指定封禁服务
* @param level 指定封禁等级
* @param time 封禁时间, 单位: 秒 （-1=永久封禁）
*/
public void disableLevel(Object loginId, String service, int level, long time) {
// 空值检查
if(SaFoxUtil.isEmpty(loginId)) {
throw new SaTokenException("请提供要封禁的账号");
}
if(SaFoxUtil.isEmpty(service)) {
throw new SaTokenException("请提供要封禁的服务");
}
if(level < SaTokenConsts.MIN_DISABLE_LEVEL) {
throw new SaTokenException("封禁等级不可以小于最小值：" + SaTokenConsts.MIN_DISABLE_LEVEL);
}
// 标注为已被封禁
getSaTokenDao().set(splicingKeyDisable(loginId, service), String.valueOf(level), time);
// $$ 发布事件
SaTokenEventCenter.doDisable(loginType, loginId, service, level, time);
}
/**
* 判断：指定账号是否已被封禁到指定等级
*
* @param loginId 指定账号id
* @param level 指定封禁等级
* @return /
*/
public boolean isDisableLevel(Object loginId, int level) {
return isDisableLevel(loginId, SaTokenConsts.DEFAULT_DISABLE_SERVICE, level);
}
/**
* 判断：指定账号的指定服务，是否已被封禁到指定等级
*
* @param loginId 指定账号id
* @param service 指定封禁服务
* @param level 指定封禁等级
* @return /
*/
public boolean isDisableLevel(Object loginId, String service, int level) {
// s1. 检查是否被封禁
int disableLevel = getDisableLevel(loginId, service);
if(disableLevel == SaTokenConsts.NOT_DISABLE_LEVEL) {
return false;
}
// s2. 检测被封禁的等级是否达到指定级别
return disableLevel >= level;
}
/**
* 校验：指定账号是否已被封禁到指定等级（如果已经达到，则抛出异常）
*
* @param loginId 指定账号id
* @param level 封禁等级 （只有 封禁等级 ≥ 此值 才会抛出异常）
*/
public void checkDisableLevel(Object loginId, int level) {
checkDisableLevel(loginId, SaTokenConsts.DEFAULT_DISABLE_SERVICE, level);
}
/**
* 校验：指定账号的指定服务，是否已被封禁到指定等级（如果已经达到，则抛出异常）
*
* @param loginId 指定账号id
* @param service 指定封禁服务
* @param level 封禁等级 （只有 封禁等级 ≥ 此值 才会抛出异常）
*/
public void checkDisableLevel(Object loginId, String service, int level) {
// s1. 检查是否被封禁
String value = getSaTokenDao().get(splicingKeyDisable(loginId, service));
if(SaFoxUtil.isEmpty(value)) {
return;
}
// s2. 检测被封禁的等级是否达到指定级别
Integer disableLevel = SaFoxUtil.getValueByType(value, int.class);
if(disableLevel >= level) {
throw new DisableServiceException(loginType, loginId, service, disableLevel, level, getDisableTime(loginId, service));
}
}
/**
* 获取：指定账号被封禁的等级，如果未被封禁则返回-2
*
* @param loginId 指定账号id
* @return /
*/
public int getDisableLevel(Object loginId) {
return getDisableLevel(loginId, SaTokenConsts.DEFAULT_DISABLE_SERVICE);
}
/**
* 获取：指定账号的 指定服务 被封禁的等级，如果未被封禁则返回-2
*
* @param loginId 指定账号id
* @param service 指定封禁服务
* @return /
*/
public int getDisableLevel(Object loginId, String service) {
// q1. 如果尚未被封禁，则返回-2
String value = getSaTokenDao().get(splicingKeyDisable(loginId, service));
if(SaFoxUtil.isEmpty(value)) {
return SaTokenConsts.NOT_DISABLE_LEVEL;
}
// q2. 转为 int 类型
return SaFoxUtil.getValueByType(value, int.class);
}
// ------------------- 身份切换 -------------------
sa-token-core/src/main/java/cn/dev33/satoken/stp/StpUtil.java
+155 -60
View File
@@ -57,7 +57,7 @@ public class StpUtil {
}
// =================== 获取token 相关 ===================
// ------------------- 获取token 相关 -------------------
/**
* 返回token名称
@@ -109,7 +109,7 @@ public class StpUtil {
}
// =================== 登录相关操作 ===================
// ------------------- 登录相关操作 -------------------
// --- 登录
@@ -354,7 +354,7 @@ public class StpUtil {
}
// =================== User-Session 相关 ===================
// ------------------- User-Session 相关 -------------------
/**
* 获取指定账号id的Session, 如果Session尚未创建，isCreate=是否新建并返回
@@ -402,7 +402,7 @@ public class StpUtil {
}
// =================== Token-Session 相关 ===================
// ------------------- Token-Session 相关 -------------------
/**
* 获取指定Token-Session，如果Session尚未创建，则新建并返回
@@ -430,7 +430,7 @@ public class StpUtil {
}
// =================== [临时有效期] 验证相关 ===================
// ------------------- [临时有效期] 验证相关 -------------------
/**
* 检查当前token 是否已经[临时过期]，如果已经过期则抛出异常
@@ -449,7 +449,7 @@ public class StpUtil {
}
// =================== 过期时间相关 ===================
// ------------------- 过期时间相关 -------------------
/**
* 获取当前登录者的 token 剩余有效时间 (单位: 秒)
@@ -500,7 +500,8 @@ public class StpUtil {
stpLogic.renewTimeout(tokenValue, timeout);
}
// =================== 角色验证操作 ===================
// ------------------- 角色验证操作 -------------------
/**
* 获取：当前账号的角色集合
@@ -581,7 +582,7 @@ public class StpUtil {
}
// =================== 权限验证操作 ===================
// ------------------- 权限验证操作 -------------------
/**
* 获取：当前账号的权限码集合
@@ -662,7 +663,7 @@ public class StpUtil {
}
// =================== id 反查token 相关操作 ===================
// ------------------- id 反查token 相关操作 -------------------
/**
* 获取指定账号id的tokenValue
@@ -715,7 +716,7 @@ public class StpUtil {
}
// =================== 会话管理 ===================
// ------------------- 会话管理 -------------------
/**
* 根据条件查询Token
@@ -760,47 +761,28 @@ public class StpUtil {
// ------------------- 账号封禁 -------------------
/**
* 封禁指定账号
* 封禁：指定账号
* <p> 此方法不会直接将此账号id踢下线，如需封禁后立即掉线，请追加调用 StpUtil.logout(id)
*
* @param loginId 指定账号id
* @param disableTime 封禁时间, 单位: 秒 （-1=永久封禁）
* @param time 封禁时间, 单位: 秒 （-1=永久封禁）
*/
public static void disable(Object loginId, long disableTime) {
stpLogic.disable(loginId, disableTime);
public static void disable(Object loginId, long time) {
stpLogic.disable(loginId, time);
}
/**
* 封禁 指定账号 指定服务
* <p> 此方法不会直接将此账号id踢下线，如需封禁后立即掉线，请追加调用 StpUtil.logout(id)
* @param loginId 指定账号id
* @param service 指定服务
* @param disableTime 封禁时间, 单位: 秒 （-1=永久封禁）
*/
public static void disable(Object loginId, String service, long disableTime) {
stpLogic.disable(loginId, service, disableTime);
}
/**
* 指定账号是否已被封禁 (true=已被封禁, false=未被封禁)
* 判断：指定账号是否已被封禁 (true=已被封禁, false=未被封禁)
*
* @param loginId 账号id
* @return see note
* @return /
*/
public static boolean isDisable(Object loginId) {
return stpLogic.isDisable(loginId);
}
/**
* 指定账号 指定服务 是否已被封禁 (true=已被封禁, false=未被封禁)
* @param loginId 账号id
* @param service 指定服务
* @return see note
*/
public static boolean isDisable(Object loginId, String service) {
return stpLogic.isDisable(loginId, service);
}
/**
* 校验指定账号是否已被封禁，如果被封禁则抛出异常
* 校验：指定账号是否已被封禁，如果被封禁则抛出异常
* @param loginId 账号id
*/
public static void checkDisable(Object loginId) {
@@ -808,25 +790,57 @@ public class StpUtil {
}
/**
* 校验 指定账号 指定服务 是否已被封禁，如果被封禁则抛出异常
* 获取：指定账号剩余封禁时间，单位：秒（-1=永久封禁，-2=未被封禁）
* @param loginId 账号id
* @param services 指定服务，可以指定多个
*/
public static void checkDisable(Object loginId, String... services) {
stpLogic.checkDisable(loginId, services);
}
/**
* 获取指定账号剩余封禁时间，单位：秒（-1=永久封禁，-2=未被封禁）
* @param loginId 账号id
* @return see note
* @return /
*/
public static long getDisableTime(Object loginId) {
return stpLogic.getDisableTime(loginId);
}
/**
* 获取 指定账号 指定服务 剩余封禁时间，单位：秒（-1=永久封禁，-2=未被封禁）
* 解封：指定账号
* @param loginId 账号id
*/
public static void untieDisable(Object loginId) {
stpLogic.untieDisable(loginId);
}
// ------------------- 分类封禁 -------------------
/**
* 封禁：指定账号的指定服务
* <p> 此方法不会直接将此账号id踢下线，如需封禁后立即掉线，请追加调用 StpUtil.logout(id)
* @param loginId 指定账号id
* @param service 指定服务
* @param time 封禁时间, 单位: 秒 （-1=永久封禁）
*/
public static void disable(Object loginId, String service, long time) {
stpLogic.disable(loginId, service, time);
}
/**
* 判断：指定账号的指定服务 是否已被封禁 (true=已被封禁, false=未被封禁)
* @param loginId 账号id
* @param service 指定服务
* @return /
*/
public static boolean isDisable(Object loginId, String service) {
return stpLogic.isDisable(loginId, service);
}
/**
* 校验：指定账号 指定服务 是否已被封禁，如果被封禁则抛出异常
* @param loginId 账号id
* @param services 指定服务，可以指定多个
*/
public static void checkDisable(Object loginId, String... services) {
stpLogic.checkDisable(loginId, services);
}
/**
* 获取：指定账号 指定服务 剩余封禁时间，单位：秒（-1=永久封禁，-2=未被封禁）
* @param loginId 账号id
* @param service 指定服务
* @return see note
@@ -836,24 +850,105 @@ public class StpUtil {
}
/**
* 解封指定账号
* @param loginId 账号id
*/
public static void untieDisable(Object loginId) {
stpLogic.untieDisable(loginId);
}
/**
* 解封指定账号、指定服务
* 解封：指定账号、指定服务
* @param loginId 账号id
* @param services 指定服务，可以指定多个
*/
public static void untieDisable(Object loginId, String... services) {
stpLogic.untieDisable(loginId, services);
}
// ------------------- 阶梯封禁 -------------------
/**
* 封禁：指定账号，并指定封禁等级
* @param loginId 指定账号id
* @param level 指定封禁等级
* @param time 封禁时间, 单位: 秒 （-1=永久封禁）
*/
public static void disableLevel(Object loginId, int level, long time) {
stpLogic.disableLevel(loginId, level, time);
}
/**
* 封禁：指定账号的指定服务，并指定封禁等级
* @param loginId 指定账号id
* @param service 指定封禁服务
* @param level 指定封禁等级
* @param time 封禁时间, 单位: 秒 （-1=永久封禁）
*/
public static void disableLevel(Object loginId, String service, int level, long time) {
stpLogic.disableLevel(loginId, service, level, time);
}
/**
* 判断：指定账号是否已被封禁到指定等级
*
* @param loginId 指定账号id
* @param level 指定封禁等级
* @return /
*/
public static boolean isDisableLevel(Object loginId, int level) {
return stpLogic.isDisableLevel(loginId, level);
}
/**
* 判断：指定账号的指定服务，是否已被封禁到指定等级
*
* @param loginId 指定账号id
* @param service 指定封禁服务
* @param level 指定封禁等级
* @return /
*/
public static boolean isDisableLevel(Object loginId, String service, int level) {
return stpLogic.isDisableLevel(loginId, service, level);
}
/**
* 校验：指定账号是否已被封禁到指定等级（如果已经达到，则抛出异常）
*
* @param loginId 指定账号id
* @param level 封禁等级 （只有 封禁等级 ≥ 此值 才会抛出异常）
*/
public static void checkDisableLevel(Object loginId, int level) {
stpLogic.checkDisableLevel(loginId, level);
}
/**
* 校验：指定账号的指定服务，是否已被封禁到指定等级（如果已经达到，则抛出异常）
*
* @param loginId 指定账号id
* @param service 指定封禁服务
* @param level 封禁等级 （只有 封禁等级 ≥ 此值 才会抛出异常）
*/
public static void checkDisableLevel(Object loginId, String service, int level) {
stpLogic.checkDisableLevel(loginId, service, level);
}
/**
* 获取：指定账号被封禁的等级，如果未被封禁则返回-2
*
* @param loginId 指定账号id
* @return /
*/
public static int getDisableLevel(Object loginId) {
return stpLogic.getDisableLevel(loginId);
}
/**
* 获取：指定账号的 指定服务 被封禁的等级，如果未被封禁则返回-2
*
* @param loginId 指定账号id
* @param service 指定封禁服务
* @return /
*/
public static int getDisableLevel(Object loginId, String service) {
return stpLogic.getDisableLevel(loginId, service);
}
// =================== 身份切换 ===================
// ------------------- 身份切换 -------------------
/**
* 临时切换身份为指定账号id
sa-token-core/src/main/java/cn/dev33/satoken/util/SaTokenConsts.java
+15
View File
@@ -58,6 +58,21 @@ public class SaTokenConsts {
* 常量key标记: 在封禁账号时，默认封禁的服务类型
*/
public static final String DEFAULT_DISABLE_SERVICE = "login";
/**
* 常量key标记: 在封禁账号时，默认封禁的等级
*/
public static final int DEFAULT_DISABLE_LEVEL = 1;
/**
* 常量key标记: 在封禁账号时，可使用的最小封禁级别
*/
public static final int MIN_DISABLE_LEVEL = 1;
/**
* 常量key标记: 账号封禁级别，表示未被封禁
*/
public static final int NOT_DISABLE_LEVEL = -2;
/**
* 常量key标记: 在进行临时身份切换时使用的key