<!-- Sa-Token 權(quán)限認(rèn)證 -->
<dependency>
    <groupId>cn.dev33</groupId>
    <artifactId>sa-token-spring-boot-starter</artifactId>
    <version>1.34.0</version>
</dependency>

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

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

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

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

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

/*
 * 以下示例中："comment"=評(píng)論服務(wù)標(biāo)識(shí)、"place-order"=下單服務(wù)標(biāo)識(shí)、"open-shop"=開店服務(wù)標(biāo)識(shí)
 */
// 封禁指定用戶評(píng)論能力，期限為 1天
StpUtil.disable(10001, "comment", 86400);
// 在評(píng)論接口，校驗(yàn)一下，會(huì)拋出異常：`DisableServiceException`，使用 e.getService() 可獲取業(yè)務(wù)標(biāo)識(shí) `comment` 
StpUtil.checkDisable(10001, "comment");
// 在下單時(shí)，我們校驗(yàn)一下 下單能力，并不會(huì)拋出異常，因?yàn)槲覀儧]有限制其下單功能
StpUtil.checkDisable(10001, "place-order");
// 現(xiàn)在我們?cè)賹⑵湎聠文芰Ψ饨幌?，期限?7天 
StpUtil.disable(10001, "place-order", 86400 * 7);
// 然后在下單接口，我們添加上校驗(yàn)代碼，此時(shí)用戶便會(huì)因?yàn)橄聠文芰Ρ环饨鵁o法下單（代碼拋出異常）
StpUtil.checkDisable(10001, "place-order");
// 但是此時(shí)，用戶如果調(diào)用開店功能的話，還是可以通過，因?yàn)槲覀儧]有限制其開店能力 （除非我們?cè)僬{(diào)用了封禁開店的代碼）
StpUtil.checkDisable(10001, "open-shop");

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

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

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

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

// 校驗(yàn)當(dāng)前賬號(hào)是否被封禁，如果已被封禁會(huì)拋出異常，無法進(jìn)入方法 
@SaCheckDisable
@PostMapping("send")
public SaResult send() {
	// ... 
	return SaResult.ok(); 
}
// 校驗(yàn)當(dāng)前賬號(hào)是否被封禁 comment 服務(wù)，如果已被封禁會(huì)拋出異常，無法進(jìn)入方法 
@SaCheckDisable("comment")
@PostMapping("send")
public SaResult send() {
	// ... 
	return SaResult.ok(); 
}
// 校驗(yàn)當(dāng)前賬號(hào)是否被封禁 comment、place-order、open-shop 等服務(wù)，指定多個(gè)值，只要有一個(gè)已被封禁，就無法進(jìn)入方法 
@SaCheckDisable({"comment", "place-order", "open-shop"})
@PostMapping("send")
public SaResult send() {
	// ... 
	return SaResult.ok(); 
}
// 階梯封禁，校驗(yàn)當(dāng)前賬號(hào)封禁等級(jí)是否達(dá)到5級(jí)，如果達(dá)到則拋出異常 
@SaCheckDisable(level = 5)
@PostMapping("send")
public SaResult send() {
	// ... 
	return SaResult.ok(); 
}
// 分類封禁 + 階梯封禁 校驗(yàn)：校驗(yàn)當(dāng)前賬號(hào)的 comment 服務(wù)，封禁等級(jí)是否達(dá)到5級(jí)，如果達(dá)到則拋出異常 
@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 賬號(hào)封禁示例 
 * 
 * @author kong
 * @since 2022-10-17 
 */
@RestController
@RequestMapping("/disable/")
public class DisableController {
	// 會(huì)話登錄接口  ---- http://localhost:8081/disable/login?userId=10001
	@RequestMapping("login")
	public SaResult login(long userId) {
		// 1、先檢查此賬號(hào)是否已被封禁 
		StpUtil.checkDisable(userId);
		// 2、檢查通過后，再登錄 
		StpUtil.login(userId);
		return SaResult.ok("賬號(hào)登錄成功");
	}
	// 會(huì)話注銷接口  ---- http://localhost:8081/disable/logout
	@RequestMapping("logout")
	public SaResult logout() {
		StpUtil.logout();
		return SaResult.ok("賬號(hào)退出成功");
	}
	// 封禁指定賬號(hào)  ---- http://localhost:8081/disable/disable?userId=10001
	@RequestMapping("disable")
	public SaResult disable(long userId) {
		/*
		 * 賬號(hào)封禁：
		 * 	參數(shù)1：要封禁的賬號(hào)id
		 * 	參數(shù)2：要封禁的時(shí)間，單位：秒，86400秒=1天
		 */
		StpUtil.disable(userId, 86400);
		return SaResult.ok("賬號(hào) " + userId + " 封禁成功");
	}
	// 解封指定賬號(hào)  ---- http://localhost:8081/disable/untieDisable?userId=10001
	@RequestMapping("untieDisable")
	public SaResult untieDisable(long userId) {
		StpUtil.untieDisable(userId);
		return SaResult.ok("賬號(hào) " + userId + " 解封成功");
	}
}