重构 SaTokenException 类方法 throwBy->notTrue、throwByNull->notEmpty

sa-token-core/src/main/java/cn/dev33/satoken/exception/SaSignException.java

@@ -38,11 +38,40 @@ public class SaSignException extends SaTokenException {
 		super(message);
 	}
 
+	/**
+	 * 断言 flag 不为 true，否则抛出 message 异常
+	 * @param flag 表达式
+	 * @param message 异常信息
+	 */
+	public static void notTrue(boolean flag, String message) {
+		// notTrue
+		if(flag) {
+			throw new SaSignException(message);
+		}
+	}
+
+	/**
+	 * 断言 value 不为空，否则抛出 message 异常
+	 * @param value 值
+	 * @param message 异常信息
+	 */
+	public static void notEmpty(Object value, String message) {
+		if(SaFoxUtil.isEmpty(value)) {
+			throw new SaSignException(message);
+		}
+	}
+
+
+	// ------------------- 已过期 -------------------
+
 	/**
 	 * 如果flag==true，则抛出message异常
+	 * <h2>已过期：请使用 notTrue 代替，用法不变</h2>
+	 *
 	 * @param flag 标记
 	 * @param message 异常信息
 	 */
+	@Deprecated
 	public static void throwBy(boolean flag, String message) {
 		if(flag) {
 			throw new SaSignException(message);
@@ -51,13 +80,17 @@ public class SaSignException extends SaTokenException {
 
 	/**
 	 * 如果 value isEmpty，则抛出 message 异常
+	 * <h2>已过期：请使用 notEmpty 代替，用法不变</h2>
+	 *
 	 * @param value 值
 	 * @param message 异常信息
 	 */
+	@Deprecated
 	public static void throwByNull(Object value, String message) {
 		if(SaFoxUtil.isEmpty(value)) {
 			throw new SaSignException(message);
 		}
 	}
 
+
 }

sa-token-core/src/main/java/cn/dev33/satoken/exception/SaTokenException.java

@@ -107,11 +107,40 @@ public class SaTokenException extends RuntimeException {
 	}
 	
 	/**
-	 * 如果flag==true，则抛出message异常 
+	 * 断言 flag 不为 true，否则抛出 message 异常
 	 * @param flag 标记
 	 * @param message 异常信息 
 	 * @param code 异常细分状态码 
 	 */
+	public static void notTrue(boolean flag, String message, int code) {
+		if(flag) {
+			throw new SaTokenException(message).setCode(code);
+		}
+	}
+
+	/**
+	 * 断言 value 不为空，否则抛出 message 异常
+	 * @param value 值 
+	 * @param message 异常信息 
+	 * @param code 异常细分状态码 
+	 */
+	public static void notEmpty(Object value, String message, int code) {
+		if(SaFoxUtil.isEmpty(value)) {
+			throw new SaTokenException(message).setCode(code);
+		}
+	}
+
+	// ------------------- 已过期 -------------------
+
+	/**
+	 * 如果flag==true，则抛出message异常
+	 * <h2>已过期：请使用 notTrue 代替，用法不变</h2>
+	 *
+	 * @param flag 标记
+	 * @param message 异常信息
+	 * @param code 异常细分状态码
+	 */
+	@Deprecated
 	public static void throwBy(boolean flag, String message, int code) {
 		if(flag) {
 			throw new SaTokenException(message).setCode(code);
@@ -119,15 +148,18 @@ public class SaTokenException extends RuntimeException {
 	}
 
 	/**
-	 * 如果value==null或者isEmpty，则抛出message异常 
+	 * 如果value==null或者isEmpty，则抛出message异常
-	 * @param value 值 
+	 * <h2>已过期：请使用 notEmpty 代替，用法不变</h2>
-	 * @param message 异常信息 
+	 * 
-	 * @param code 异常细分状态码 
+	 * @param value 值
+	 * @param message 异常信息
+	 * @param code 异常细分状态码
 	 */
+	@Deprecated
 	public static void throwByNull(Object value, String message, int code) {
 		if(SaFoxUtil.isEmpty(value)) {
 			throw new SaTokenException(message).setCode(code);
 		}
 	}
-	
+
 }

sa-token-core/src/main/java/cn/dev33/satoken/sign/SaSignTemplate.java

@@ -148,7 +148,7 @@ public class SaSignTemplate {
 	 */
 	public String createSign(Map<String, ?> paramsMap) {
 		String secretKey = getSecretKey();
-		SaSignException.throwByNull(secretKey, "参与参数签名的秘钥不可为空", SaErrorCode.CODE_12201);
+		SaSignException.notEmpty(secretKey, "参与参数签名的秘钥不可为空", SaErrorCode.CODE_12201);
 
 		// 如果调用者不小心传入了 sign 参数，则此处需要将 sign 参数排除在外
 		if(paramsMap.containsKey(sign)) {
@@ -295,9 +295,9 @@ public class SaSignTemplate {
 		String signValue = paramMap.get(sign);
 
 		// 参数非空校验
-		SaSignException.throwByNull(timestampValue, "缺少 timestamp 字段");
+		SaSignException.notEmpty(timestampValue, "缺少 timestamp 字段");
 		// SaSignException.throwByNull(nonceValue, "缺少 nonce 字段"); // 配置isCheckNonce=false时，可以不传 nonce
-		SaSignException.throwByNull(signValue, "缺少 sign 字段");
+		SaSignException.notEmpty(signValue, "缺少 sign 字段");
 
 		// 三个值的校验必须全部通过
 		return isValidTimestamp(Long.parseLong(timestampValue))
@@ -316,9 +316,9 @@ public class SaSignTemplate {
 		String signValue = paramMap.get(sign);
 
 		// 参数非空校验
-		SaSignException.throwByNull(timestampValue, "缺少 timestamp 字段");
+		SaSignException.notEmpty(timestampValue, "缺少 timestamp 字段");
 		// SaSignException.throwByNull(nonceValue, "缺少 nonce 字段"); // 配置isCheckNonce=false时，可以不传 nonce
-		SaSignException.throwByNull(signValue, "缺少 sign 字段");
+		SaSignException.notEmpty(signValue, "缺少 sign 字段");
 
 		// 依次校验三个参数
 		checkTimestamp(Long.parseLong(timestampValue));

sa-token-core/src/main/java/cn/dev33/satoken/stp/StpLogic.java

@@ -1147,7 +1147,7 @@ public class StpLogic {
 	 */
 	public void updateTokenToIdMapping(String tokenValue, Object loginId) {
 		// 先判断一下，是否传入了空值
-		SaTokenException.throwBy(SaFoxUtil.isEmpty(loginId), "loginId 不能为空", SaErrorCode.CODE_11003);
+		SaTokenException.notTrue(SaFoxUtil.isEmpty(loginId), "loginId 不能为空", SaErrorCode.CODE_11003);
 
 		// 更新缓存中的 token 指向
 		getSaTokenDao().update(splicingKeyTokenValue(tokenValue), loginId.toString());

sa-token-plugin/sa-token-sso/src/main/java/cn/dev33/satoken/sso/SaSsoTemplate.java

@@ -524,7 +524,7 @@ public class SaSsoTemplate {
 		String url = path;
 		if( ! url.startsWith("http") ) {
 			String serverUrl = SaSsoManager.getConfig().getServerUrl();
-			SaSsoException.throwByNull(serverUrl, "请先配置 sa-token.sso.server-url 地址", SaSsoErrorCode.CODE_30012);
+			SaSsoException.notEmpty(serverUrl, "请先配置 sa-token.sso.server-url 地址", SaSsoErrorCode.CODE_30012);
 			url = SaFoxUtil.spliceTwoUrl(serverUrl, path);
 		}