<!-- Sa-Token 權限認證 -->
<dependency>
    <groupId>cn.dev33</groupId>
    <artifactId>sa-token-spring-boot-starter</artifactId>
    <version>1.34.0</version>
</dependency>

// 封禁指定賬號 
StpUtil.disable(10001, 86400); 

// 先踢下線
StpUtil.kickout(10001); 
// 再封禁賬號
StpUtil.disable(10001, 86400); 

// 校驗指定賬號是否已被封禁，如果被封禁則拋出異常 `DisableServiceException`
StpUtil.checkDisable(10001); 
// 通過校驗后，再進行登錄：
StpUtil.login(10001); 

// 封禁指定賬號 
StpUtil.disable(10001, 86400); 
// 獲取指定賬號是否已被封禁 (true=已被封禁, false=未被封禁) 
StpUtil.isDisable(10001); 
// 校驗指定賬號是否已被封禁，如果被封禁則拋出異常 `DisableServiceException`
StpUtil.checkDisable(10001); 
// 獲取指定賬號剩余封禁時間，單位：秒，如果該賬號未被封禁，則返回-2 
StpUtil.getDisableTime(10001); 
// 解除封禁
StpUtil.untieDisable(10001); 

// 封禁指定用戶評論能力，期限為 1天
StpUtil.disable(10001, "comment", 86400);

/*
 * 以下示例中："comment"=評論服務標識、"place-order"=下單服務標識、"open-shop"=開店服務標識
 */
// 封禁指定用戶評論能力，期限為 1天
StpUtil.disable(10001, "comment", 86400);
// 在評論接口，校驗一下，會拋出異常：`DisableServiceException`，使用 e.getService() 可獲取業(yè)務標識 `comment` 
StpUtil.checkDisable(10001, "comment");
// 在下單時，我們校驗一下 下單能力，并不會拋出異常，因為我們沒有限制其下單功能
StpUtil.checkDisable(10001, "place-order");
// 現(xiàn)在我們再將其下單能力封禁一下，期限為 7天 
StpUtil.disable(10001, "place-order", 86400 * 7);
// 然后在下單接口，我們添加上校驗代碼，此時用戶便會因為下單能力被封禁而無法下單（代碼拋出異常）
StpUtil.checkDisable(10001, "place-order");
// 但是此時，用戶如果調用開店功能的話，還是可以通過，因為我們沒有限制其開店能力 （除非我們再調用了封禁開店的代碼）
StpUtil.checkDisable(10001, "open-shop");

// 封禁：指定賬號的指定服務 
StpUtil.disable(10001, "<業(yè)務標識>", 86400); 
// 判斷：指定賬號的指定服務 是否已被封禁 (true=已被封禁, false=未被封禁) 
StpUtil.isDisable(10001, "<業(yè)務標識>"); 
// 校驗：指定賬號的指定服務 是否已被封禁，如果被封禁則拋出異常 `DisableServiceException`
StpUtil.checkDisable(10001, "<業(yè)務標識>"); 
// 獲?。褐付ㄙ~號的指定服務 剩余封禁時間，單位：秒（-1=永久封禁，-2=未被封禁）
StpUtil.getDisableTime(10001, "<業(yè)務標識>"); 
// 解封：指定賬號的指定服務
StpUtil.untieDisable(10001, "<業(yè)務標識>"); 

// 階梯封禁，參數(shù)：封禁賬號、封禁級別、封禁時間 
StpUtil.disableLevel(10001, 3, 10000);
// 獲?。褐付ㄙ~號封禁的級別 （如果此賬號未被封禁則返回 -2）
StpUtil.getDisableLevel(10001);
// 判斷：指定賬號是否已被封禁到指定級別，返回 true 或 false
StpUtil.isDisableLevel(10001, 3);
// 校驗：指定賬號是否已被封禁到指定級別，如果已達到此級別（例如已被3級封禁，這里校驗是否達到2級），則拋出異常 `DisableServiceException`
StpUtil.checkDisableLevel(10001, 2);

// 分類階梯封禁，參數(shù)：封禁賬號、封禁服務、封禁級別、封禁時間 
StpUtil.disableLevel(10001, "comment", 3, 10000);
// 獲?。褐付ㄙ~號的指定服務 封禁的級別 （如果此賬號未被封禁則返回 -2）
StpUtil.getDisableLevel(10001, "comment");
// 判斷：指定賬號的指定服務 是否已被封禁到指定級別，返回 true 或 false
StpUtil.isDisableLevel(10001, "comment", 3);
// 校驗：指定賬號的指定服務 是否已被封禁到指定級別（例如 comment服務 已被3級封禁，這里校驗是否達到2級），如果已達到此級別，則拋出異常 
StpUtil.checkDisableLevel(10001, "comment", 2);

@Configuration
public class SaTokenConfigure implements WebMvcConfigurer {
	// 注冊 Sa-Token 攔截器，打開注解式鑒權功能 
	@Override
	public void addInterceptors(InterceptorRegistry registry) {
		registry.addInterceptor(new SaInterceptor()).addPathPatterns("/**");	
	}
}

// 校驗當前賬號是否被封禁，如果已被封禁會拋出異常，無法進入方法 
@SaCheckDisable
@PostMapping("send")
public SaResult send() {
	// ... 
	return SaResult.ok(); 
}
// 校驗當前賬號是否被封禁 comment 服務，如果已被封禁會拋出異常，無法進入方法 
@SaCheckDisable("comment")
@PostMapping("send")
public SaResult send() {
	// ... 
	return SaResult.ok(); 
}
// 校驗當前賬號是否被封禁 comment、place-order、open-shop 等服務，指定多個值，只要有一個已被封禁，就無法進入方法 
@SaCheckDisable({"comment", "place-order", "open-shop"})
@PostMapping("send")
public SaResult send() {
	// ... 
	return SaResult.ok(); 
}
// 階梯封禁，校驗當前賬號封禁等級是否達到5級，如果達到則拋出異常 
@SaCheckDisable(level = 5)
@PostMapping("send")
public SaResult send() {
	// ... 
	return SaResult.ok(); 
}
// 分類封禁 + 階梯封禁 校驗：校驗當前賬號的 comment 服務，封禁等級是否達到5級，如果達到則拋出異常 
@SaCheckDisable(value = "comment", level = 5)
@PostMapping("send")
public SaResult send() {
	// ... 
	return SaResult.ok(); 
}

package com.pj.cases.up;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RestController;
import cn.dev33.satoken.stp.StpUtil;
import cn.dev33.satoken.util.SaResult;
/**
 * Sa-Token 賬號封禁示例 
 * 
 * @author kong
 * @since 2022-10-17 
 */
@RestController
@RequestMapping("/disable/")
public class DisableController {
	// 會話登錄接口  ---- http://localhost:8081/disable/login?userId=10001
	@RequestMapping("login")
	public SaResult login(long userId) {
		// 1、先檢查此賬號是否已被封禁 
		StpUtil.checkDisable(userId);
		// 2、檢查通過后，再登錄 
		StpUtil.login(userId);
		return SaResult.ok("賬號登錄成功");
	}
	// 會話注銷接口  ---- http://localhost:8081/disable/logout
	@RequestMapping("logout")
	public SaResult logout() {
		StpUtil.logout();
		return SaResult.ok("賬號退出成功");
	}
	// 封禁指定賬號  ---- http://localhost:8081/disable/disable?userId=10001
	@RequestMapping("disable")
	public SaResult disable(long userId) {
		/*
		 * 賬號封禁：
		 * 	參數(shù)1：要封禁的賬號id
		 * 	參數(shù)2：要封禁的時間，單位：秒，86400秒=1天
		 */
		StpUtil.disable(userId, 86400);
		return SaResult.ok("賬號 " + userId + " 封禁成功");
	}
	// 解封指定賬號  ---- http://localhost:8081/disable/untieDisable?userId=10001
	@RequestMapping("untieDisable")
	public SaResult untieDisable(long userId) {
		StpUtil.untieDisable(userId);
		return SaResult.ok("賬號 " + userId + " 解封成功");
	}
}