This commit is contained in:
click33 2022-12-27 12:40:30 +08:00
commit 81c1ddacde
9 changed files with 238 additions and 243 deletions

View File

@ -10,86 +10,86 @@ import cn.dev33.satoken.exception.SaTokenException;
import cn.dev33.satoken.util.SaFoxUtil;
/**
* Cookie Model
* Cookie Model
* @author kong
*
*/
public class SaCookie {
/**
* 写入响应头时使用的key
* 写入响应头时使用的key
*/
public static final String HEADER_NAME = "Set-Cookie";
/**
* 名称
* 名称
*/
private String name;
/**
*
*
*/
private String value;
/**
* 有效时长 单位-1代表为临时Cookie 浏览器关闭后自动删除
* 有效时长 单位-1代表为临时Cookie 浏览器关闭后自动删除
*/
private int maxAge = -1;
private int maxAge = -1;
/**
*
*/
private String domain;
private String domain;
/**
* 路径
* 路径
*/
private String path;
/**
* 是否只在 https 协议下有效
* 是否只在 https 协议下有效
*/
private Boolean secure = false;
private Boolean secure = false;
/**
* 是否禁止 js 操作 Cookie
* 是否禁止 js 操作 Cookie
*/
private Boolean httpOnly = false;
private Boolean httpOnly = false;
/**
* 第三方限制级别Strict=完全禁止Lax=部分允许None=不限制
*/
private String sameSite;
/**
* 构造一个
* 构造一个
*/
public SaCookie() {
}
/**
* 构造一个
* 构造一个
* @param name 名字
* @param value
* @param value
*/
public SaCookie(String name, String value) {
this.name = name;
this.value = value;
}
/**
* @return 名称
* @return 名称
*/
public String getName() {
return name;
}
/**
* @param name 名称
* @return 对象自身
* @param name 名称
* @return 对象自身
*/
public SaCookie setName(String name) {
this.name = name;
@ -97,15 +97,15 @@ public class SaCookie {
}
/**
* @return
* @return
*/
public String getValue() {
return value;
}
/**
* @param value
* @return 对象自身
* @param value
* @return 对象自身
*/
public SaCookie setValue(String value) {
this.value = value;
@ -113,15 +113,15 @@ public class SaCookie {
}
/**
* @return 有效时长 单位-1代表为临时Cookie 浏览器关闭后自动删除
* @return 有效时长 单位-1代表为临时Cookie 浏览器关闭后自动删除
*/
public int getMaxAge() {
return maxAge;
}
/**
* @param maxAge 有效时长 单位-1代表为临时Cookie 浏览器关闭后自动删除
* @return 对象自身
* @param maxAge 有效时长 单位-1代表为临时Cookie 浏览器关闭后自动删除
* @return 对象自身
*/
public SaCookie setMaxAge(int maxAge) {
this.maxAge = maxAge;
@ -129,15 +129,15 @@ public class SaCookie {
}
/**
* @return
* @return
*/
public String getDomain() {
return domain;
}
/**
* @param domain
* @return 对象自身
* @param domain
* @return 对象自身
*/
public SaCookie setDomain(String domain) {
this.domain = domain;
@ -145,15 +145,15 @@ public class SaCookie {
}
/**
* @return 路径
* @return 路径
*/
public String getPath() {
return path;
}
/**
* @param path 路径
* @return 对象自身
* @param path 路径
* @return 对象自身
*/
public SaCookie setPath(String path) {
this.path = path;
@ -161,15 +161,15 @@ public class SaCookie {
}
/**
* @return 是否只在 https 协议下有效
* @return 是否只在 https 协议下有效
*/
public Boolean getSecure() {
return secure;
}
/**
* @param secure 是否只在 https 协议下有效
* @return 对象自身
* @param secure 是否只在 https 协议下有效
* @return 对象自身
*/
public SaCookie setSecure(Boolean secure) {
this.secure = secure;
@ -177,15 +177,15 @@ public class SaCookie {
}
/**
* @return 是否禁止 js 操作 Cookie
* @return 是否禁止 js 操作 Cookie
*/
public Boolean getHttpOnly() {
return httpOnly;
}
/**
* @param httpOnly 是否禁止 js 操作 Cookie
* @return 对象自身
* @param httpOnly 是否禁止 js 操作 Cookie
* @return 对象自身
*/
public SaCookie setHttpOnly(Boolean httpOnly) {
this.httpOnly = httpOnly;
@ -201,7 +201,7 @@ public class SaCookie {
/**
* @param sameSite 第三方限制级别Strict=完全禁止Lax=部分允许None=不限制
* @return 对象自身
* @return 对象自身
*/
public SaCookie setSameSite(String sameSite) {
this.sameSite = sameSite;
@ -209,57 +209,57 @@ public class SaCookie {
}
// toString
// toString
@Override
public String toString() {
return "SaCookie [name=" + name + ", value=" + value + ", maxAge=" + maxAge + ", domain=" + domain + ", path=" + path
return "SaCookie [name=" + name + ", value=" + value + ", maxAge=" + maxAge + ", domain=" + domain + ", path=" + path
+ ", secure=" + secure + ", httpOnly=" + httpOnly + ", sameSite="
+ sameSite + "]";
}
/**
* 构建一下
* 构建一下
*/
public void builde() {
if(path == null) {
path = "/";
}
}
/**
* 转换为响应头 Set-Cookie 参数需要的值
* @return /
* @return /
*/
public String toHeaderValue() {
this.builde();
if(SaFoxUtil.isEmpty(name)) {
throw new SaTokenException("name不能为空").setCode(SaErrorCode.CODE_12002);
}
if(value != null && value.indexOf(";") > -1) {
if(value != null && value.contains(";")) {
throw new SaTokenException("无效Value" + value).setCode(SaErrorCode.CODE_12003);
}
// Set-Cookie: name=value; Max-Age=100000; Expires=Tue, 05-Oct-2021 20:28:17 GMT; Domain=localhost; Path=/; Secure; HttpOnly; SameSite=Lax
StringBuffer sb = new StringBuffer();
sb.append(name + "=" + value);
// Set-Cookie: name=value; Max-Age=100000; Expires=Tue, 05-Oct-2021 20:28:17 GMT; Domain=localhost; Path=/; Secure; HttpOnly; SameSite=Lax
StringBuilder sb = new StringBuilder();
sb.append(name).append("=").append(value);
if(maxAge >= 0) {
sb.append("; Max-Age=" + maxAge);
sb.append("; Max-Age=").append(maxAge);
String expires;
if(maxAge == 0) {
expires = Instant.EPOCH.atOffset(ZoneOffset.UTC).format(DateTimeFormatter.RFC_1123_DATE_TIME);
} else {
expires = OffsetDateTime.now().plusSeconds(maxAge).format(DateTimeFormatter.RFC_1123_DATE_TIME);
}
sb.append("; Expires=" + expires);
sb.append("; Expires=").append(expires);
}
if(!SaFoxUtil.isEmpty(domain)) {
sb.append("; Domain=" + domain);
sb.append("; Domain=").append(domain);
}
if(!SaFoxUtil.isEmpty(path)) {
sb.append("; Path=" + path);
sb.append("; Path=").append(path);
}
if(secure) {
sb.append("; Secure");
@ -268,10 +268,10 @@ public class SaCookie {
sb.append("; HttpOnly");
}
if(!SaFoxUtil.isEmpty(sameSite)) {
sb.append("; SameSite=" + sameSite);
sb.append("; SameSite=").append(sameSite);
}
return sb.toString();
}
}

View File

@ -1,5 +1,6 @@
package cn.dev33.satoken.secure;
import java.nio.charset.StandardCharsets;
import java.security.KeyFactory;
import java.security.KeyPair;
import java.security.KeyPairGenerator;
@ -27,7 +28,7 @@ import cn.dev33.satoken.exception.SaTokenException;
/**
* Sa-Token 常见加密算法工具类
*
*
* @author kong
*
*/
@ -35,7 +36,7 @@ public class SaSecureUtil {
private SaSecureUtil() {
}
/**
* Base64编码
*/
@ -45,11 +46,11 @@ public class SaSecureUtil {
* Base64解码
*/
private static Base64.Decoder decoder = Base64.getDecoder();
// ----------------------- 摘要加密 -----------------------
/**
* md5加密
* md5加密
* @param str 指定字符串
* @return 加密后的字符串
*/
@ -75,8 +76,8 @@ public class SaSecureUtil {
}
/**
* sha1加密
*
* sha1加密
*
* @param str 指定字符串
* @return 加密后的字符串
*/
@ -103,8 +104,8 @@ public class SaSecureUtil {
}
/**
* sha256加密
*
* sha256加密
*
* @param str 指定字符串
* @return 加密后的字符串
*/
@ -112,8 +113,8 @@ public class SaSecureUtil {
try {
str = (str == null ? "" : str);
MessageDigest messageDigest = MessageDigest.getInstance("SHA-256");
messageDigest.update(str.getBytes("UTF-8"));
messageDigest.update(str.getBytes(StandardCharsets.UTF_8));
byte[] bytes = messageDigest.digest();
StringBuilder builder = new StringBuilder();
String temp;
@ -124,7 +125,7 @@ public class SaSecureUtil {
}
builder.append(temp);
}
return builder.toString();
} catch (Exception e) {
throw new SaTokenException(e).setCode(SaErrorCode.CODE_12113);
@ -132,20 +133,20 @@ public class SaSecureUtil {
}
/**
* md5加盐加密: md5(md5(str) + md5(salt))
* md5加盐加密: md5(md5(str) + md5(salt))
* @param str 字符串
* @param salt
* @param salt
* @return 加密后的字符串
*/
public static String md5BySalt(String str, String salt) {
return md5(md5(str) + md5(salt));
}
// ----------------------- 对称加密 AES -----------------------
/**
* 默认密码算法
* 默认密码算法
*/
private static final String DEFAULT_CIPHER_ALGORITHM = "AES/ECB/PKCS5Padding";
@ -159,7 +160,7 @@ public class SaSecureUtil {
public static String aesEncrypt(String key, String text) {
try {
Cipher cipher = Cipher.getInstance(DEFAULT_CIPHER_ALGORITHM);
byte[] byteContent = text.getBytes("utf-8");
byte[] byteContent = text.getBytes(StandardCharsets.UTF_8);
cipher.init(Cipher.ENCRYPT_MODE, getSecretKey(key));
byte[] result = cipher.doFinal(byteContent);
return encoder.encodeToString(result);
@ -169,7 +170,7 @@ public class SaSecureUtil {
}
/**
* AES解密
* AES解密
* @param key 加密的密钥
* @param text 已加密的密文
* @return 返回解密后的数据
@ -179,16 +180,16 @@ public class SaSecureUtil {
Cipher cipher = Cipher.getInstance(DEFAULT_CIPHER_ALGORITHM);
cipher.init(Cipher.DECRYPT_MODE, getSecretKey(key));
byte[] result = cipher.doFinal(decoder.decode(text));
return new String(result, "utf-8");
return new String(result, StandardCharsets.UTF_8);
} catch (Exception e) {
throw new SaTokenException(e).setCode(SaErrorCode.CODE_12115);
}
}
/**
* 生成加密秘钥
* 生成加密秘钥
* @param password 秘钥
* @return SecretKeySpec
* @return SecretKeySpec
* @throws NoSuchAlgorithmException
*/
private static SecretKeySpec getSecretKey(final String password) throws NoSuchAlgorithmException {
@ -204,14 +205,14 @@ public class SaSecureUtil {
// ----------------------- 非对称加密 RSA -----------------------
private static final String ALGORITHM = "RSA";
private static final int KEY_SIZE = 1024;
// ---------- 5个常用方法
// ---------- 5个常用方法
/**
* 生成密钥对
* 生成密钥对
* @return Map对象 (private=私钥, public=公钥)
* @throws Exception 异常
*/
@ -242,24 +243,24 @@ public class SaSecureUtil {
public static String rsaEncryptByPublic(String publicKeyString, String content) {
try {
// 获得公钥对象
PublicKey publicKey = getPublicKeyFromString(publicKeyString);
PublicKey publicKey = getPublicKeyFromString(publicKeyString);
Cipher cipher = Cipher.getInstance("RSA");
cipher.init(Cipher.ENCRYPT_MODE, publicKey);
// 该密钥能够加密的最大字节长度
int splitLength = ((RSAPublicKey) publicKey).getModulus().bitLength() / 8 - 11;
byte[][] arrays = splitBytes(content.getBytes(), splitLength);
StringBuffer stringBuffer = new StringBuffer();
StringBuilder stringBuilder = new StringBuilder();
for (byte[] array : arrays) {
stringBuffer.append(bytesToHexString(cipher.doFinal(array)));
stringBuilder.append(bytesToHexString(cipher.doFinal(array)));
}
return stringBuffer.toString();
return stringBuilder.toString();
} catch (Exception e) {
throw new SaTokenException(e).setCode(SaErrorCode.CODE_12116);
}
}
/**
/**
* RSA私钥加密
* @param privateKeyString 私钥
* @param content 内容
@ -274,17 +275,17 @@ public class SaSecureUtil {
// 该密钥能够加密的最大字节长度
int splitLength = ((RSAPrivateKey) privateKey).getModulus().bitLength() / 8 - 11;
byte[][] arrays = splitBytes(content.getBytes(), splitLength);
StringBuffer stringBuffer = new StringBuffer();
StringBuilder stringBuilder = new StringBuilder();
for (byte[] array : arrays) {
stringBuffer.append(bytesToHexString(cipher.doFinal(array)));
stringBuilder.append(bytesToHexString(cipher.doFinal(array)));
}
return stringBuffer.toString();
return stringBuilder.toString();
} catch (Exception e) {
throw new SaTokenException(e).setCode(SaErrorCode.CODE_12117);
}
}
/**
/**
* RSA公钥解密
* @param publicKeyString 公钥
* @param content 已加密内容
@ -301,11 +302,11 @@ public class SaSecureUtil {
int splitLength = ((RSAPublicKey) publicKey).getModulus().bitLength() / 8;
byte[] contentBytes = hexStringToBytes(content);
byte[][] arrays = splitBytes(contentBytes, splitLength);
StringBuffer stringBuffer = new StringBuffer();
StringBuilder stringBuilder = new StringBuilder();
for (byte[] array : arrays) {
stringBuffer.append(new String(cipher.doFinal(array)));
stringBuilder.append(new String(cipher.doFinal(array)));
}
return stringBuffer.toString();
return stringBuilder.toString();
} catch (Exception e) {
throw new SaTokenException(e).setCode(SaErrorCode.CODE_12118);
}
@ -327,18 +328,18 @@ public class SaSecureUtil {
int splitLength = ((RSAPrivateKey) privateKey).getModulus().bitLength() / 8;
byte[] contentBytes = hexStringToBytes(content);
byte[][] arrays = splitBytes(contentBytes, splitLength);
StringBuffer stringBuffer = new StringBuffer();
StringBuilder stringBuilder = new StringBuilder();
for (byte[] array : arrays) {
stringBuffer.append(new String(cipher.doFinal(array)));
stringBuilder.append(new String(cipher.doFinal(array)));
}
return stringBuffer.toString();
return stringBuilder.toString();
} catch (Exception e) {
throw new SaTokenException(e).setCode(SaErrorCode.CODE_12119);
}
}
// ---------- 获取*
// ---------- 获取*
/** 根据公钥字符串获取 公钥对象 */
private static PublicKey getPublicKeyFromString(String key)
@ -352,9 +353,7 @@ public class SaSecureUtil {
KeyFactory keyFactory = KeyFactory.getInstance(ALGORITHM);
PublicKey publicKey = keyFactory.generatePublic(x509KeySpec);
return publicKey;
return keyFactory.generatePublic(x509KeySpec);
}
/** 根据私钥字符串获取 私钥对象 */
@ -369,9 +368,7 @@ public class SaSecureUtil {
KeyFactory keyFactory = KeyFactory.getInstance(ALGORITHM);
PrivateKey privateKey = keyFactory.generatePrivate(x509KeySpec);
return privateKey;
return keyFactory.generatePrivate(x509KeySpec);
}
@ -435,5 +432,5 @@ public class SaSecureUtil {
return (byte) "0123456789ABCDEF".indexOf(c);
}
}

View File

@ -22,8 +22,8 @@ import cn.dev33.satoken.error.SaErrorCode;
import cn.dev33.satoken.exception.SaTokenException;
/**
* Sa-Token 内部工具类
*
* Sa-Token 内部工具类
*
* @author kong
*
*/
@ -31,20 +31,20 @@ public class SaFoxUtil {
private SaFoxUtil() {
}
/**
* 打印 Sa-Token 版本字符画
*/
public static void printSaToken() {
String str = ""
+ "____ ____ ___ ____ _ _ ____ _ _ \r\n"
+ "____ ____ ___ ____ _ _ ____ _ _ \r\n"
+ "[__ |__| __ | | | |_/ |___ |\\ | \r\n"
+ "___] | | | |__| | \\_ |___ | \\| "
// + SaTokenConsts.VERSION_NO
// + "sa-token"
+ "___] | | | |__| | \\_ |___ | \\| "
// + SaTokenConsts.VERSION_NO
// + "sa-token"
// + "\r\n" + "DevDoc" + SaTokenConsts.DEV_DOC_URL // + "\r\n";
+ "\r\n" + SaTokenConsts.DEV_DOC_URL // + "\r\n";
+ " (" + SaTokenConsts.VERSION_NO + ")"
+ " (" + SaTokenConsts.VERSION_NO + ")"
// + "\r\n" + "GitHub" + SaTokenConsts.GITHUB_URL // + "\r\n";
;
System.out.println(str);
@ -52,13 +52,13 @@ public class SaFoxUtil {
/**
* 生成指定长度的随机字符串
*
*
* @param length 字符串的长度
* @return 一个随机字符串
*/
public static String getRandomString(int length) {
String str = "abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789";
StringBuffer sb = new StringBuffer();
StringBuilder sb = new StringBuilder();
for (int i = 0; i < length; i++) {
int number = ThreadLocalRandom.current().nextInt(62);
sb.append(str.charAt(number));
@ -68,7 +68,7 @@ public class SaFoxUtil {
/**
* 指定元素是否为null或者空字符串
* @param str 指定元素
* @param str 指定元素
* @return 是否为null或者空字符串
*/
public static boolean isEmpty(Object str) {
@ -77,7 +77,7 @@ public class SaFoxUtil {
/**
* 指定元素是否不为 (null或者空字符串)
* @param str 指定元素
* @param str 指定元素
* @return 是否为null或者空字符串
*/
public static boolean isNotEmpty(Object str) {
@ -95,15 +95,15 @@ public class SaFoxUtil {
}
/**
* 比较两个对象是否相等
* @param a 第一个对象
* @param b 第二个对象
* @return 两个对象是否相等
* 比较两个对象是否相等
* @param a 第一个对象
* @param b 第二个对象
* @return 两个对象是否相等
*/
public static boolean equals(Object a, Object b) {
return (a == b) || (a != null && a.equals(b));
}
/**
* 比较两个对象是否不相等
* @param a 第一个对象
@ -113,10 +113,9 @@ public class SaFoxUtil {
public static boolean notEquals(Object a, Object b) {
return !equals(a, b);
}
/**
/**
* 以当前时间戳和随机int数字拼接一个随机字符串
*
*
* @return 随机字符串
*/
public static String getMarking28() {
@ -126,7 +125,7 @@ public class SaFoxUtil {
/**
* 将日期格式化 yyyy-MM-dd HH:mm:ss
* @param date 日期
* @return 格式化后的时间
* @return 格式化后的时间
*/
public static String formatDate(Date date){
return new SimpleDateFormat("yyyy-MM-dd HH:mm:ss").format(date);
@ -151,17 +150,17 @@ public class SaFoxUtil {
ZonedDateTime zonedDateTime = ZonedDateTime.ofInstant(instant, ZoneId.systemDefault());
return formatDate(zonedDateTime);
}
/**
* 从集合里查询数据
*
*
* @param dataList 数据集合
* @param prefix 前缀
* @param keyword 关键字
* @param start 起始位置 (-1代表查询所有)
* @param size 获取条数
* @param sortType 排序类型true=正序false=反序
*
*
* @return 符合条件的新数据集合
*/
public static List<String> searchList(Collection<String> dataList, String prefix, String keyword, int start, int size, boolean sortType) {
@ -186,34 +185,34 @@ public class SaFoxUtil {
/**
* 从集合里查询数据
*
*
* @param list 数据集合
* @param start 起始位置
* @param size 获取条数 (-1代表从start处一直取到末尾)
* @param size 获取条数 (-1代表从start处一直取到末尾)
* @param sortType 排序类型true=正序false=反序
*
*
* @return 符合条件的新数据集合
*/
public static List<String> searchList(List<String> list, int start, int size, boolean sortType) {
// 如果是反序的话
// 如果是反序的话
if(sortType == false) {
Collections.reverse(list);
}
// start 至少为0
// start 至少为0
if (start < 0) {
start = 0;
}
// size为-1时代表一直取到末尾否则取到 start + size
// size为-1时代表一直取到末尾否则取到 start + size
int end;
if(size == -1) {
end = list.size();
} else {
end = start + size;
}
// 取出的数据放到新集合中
// 取出的数据放到新集合中
List<String> list2 = new ArrayList<String>();
for (int i = start; i < end; i++) {
// 如果已经取到list的末尾则直接退出
// 如果已经取到list的末尾则直接退出
if (i >= list.size()) {
return list2;
}
@ -221,62 +220,62 @@ public class SaFoxUtil {
}
return list2;
}
/**
* 字符串模糊匹配
* <p>example:
* <p> user* user-add -- true
* <p> user* art-add -- false
* @param patt 表达式
* @param str 待匹配的字符串
* @return 是否可以匹配
* <p> user* user-add -- true
* <p> user* art-add -- false
* @param patt 表达式
* @param str 待匹配的字符串
* @return 是否可以匹配
*/
public static boolean vagueMatch(String patt, String str) {
// 两者均为 null 直接返回 true
// 两者均为 null 直接返回 true
if(patt == null && str == null) {
return true;
}
// 两者其一为 null 直接返回 false
// 两者其一为 null 直接返回 false
if(patt == null || str == null) {
return false;
}
// 如果表达式不带有*则只需简单equals即可 (这样可以使速度提升200倍左右)
// 如果表达式不带有*则只需简单equals即可 (这样可以使速度提升200倍左右)
if(patt.indexOf("*") == -1) {
return patt.equals(str);
}
// 正则匹配
// 正则匹配
return Pattern.matches(patt.replaceAll("\\*", ".*"), str);
}
/**
* 判断类型是否为8大包装类型
* @param cs /
* @return /
* 判断类型是否为8大包装类型
* @param cs /
* @return /
*/
public static boolean isWrapperType(Class<?> cs) {
return cs == Integer.class || cs == Short.class || cs == Long.class || cs == Byte.class
|| cs == Float.class || cs == Double.class || cs == Boolean.class || cs == Character.class;
}
/**
* 判断类型是否为基础类型8大基本数据类型8大包装类String
* @param cs /
* @return /
* 判断类型是否为基础类型8大基本数据类型8大包装类String
* @param cs /
* @return /
*/
public static boolean isBasicType(Class<?> cs) {
return cs.isPrimitive() || isWrapperType(cs) || cs == String.class;
}
/**
* 将指定值转化为指定类型
* @param <T> 泛型
* @param obj
* @param cs 类型
* @return 转换后的值
* @return 转换后的值
*/
@SuppressWarnings("unchecked")
public static <T> T getValueByType(Object obj, Class<T> cs) {
// 如果 obj null 或者本来就是 cs 类型
// 如果 obj null 或者本来就是 cs 类型
if(obj == null || obj.getClass().equals(cs)) {
return (T)obj;
}
@ -306,15 +305,15 @@ public class SaFoxUtil {
}
return (T)obj3;
}
/**
* 在url上拼接上kv参数并返回
* 在url上拼接上kv参数并返回
* @param url url
* @param parameStr 参数, 例如 id=1001
* @return 拼接后的url字符串
* @return 拼接后的url字符串
*/
public static String joinParam(String url, String parameStr) {
// 如果参数为空, 直接返回
// 如果参数为空, 直接返回
if(parameStr == null || parameStr.length() == 0) {
return url;
}
@ -340,19 +339,19 @@ public class SaFoxUtil {
return url + parameStr;
}
}
// 正常情况下, 代码不可能执行到此
// 正常情况下, 代码不可能执行到此
return url;
}
/**
* 在url上拼接上kv参数并返回
* 在url上拼接上kv参数并返回
* @param url url
* @param key 参数名称
* @param value 参数值
* @return 拼接后的url字符串
* @param value 参数值
* @return 拼接后的url字符串
*/
public static String joinParam(String url, String key, Object value) {
// 如果url或者key为空, 直接返回
// 如果url或者key为空, 直接返回
if(isEmpty(url) || isEmpty(key)) {
return url;
}
@ -360,13 +359,13 @@ public class SaFoxUtil {
}
/**
* 在url上拼接锚参数
* 在url上拼接锚参数
* @param url url
* @param parameStr 参数, 例如 id=1001
* @return 拼接后的url字符串
* @return 拼接后的url字符串
*/
public static String joinSharpParam(String url, String parameStr) {
// 如果参数为空, 直接返回
// 如果参数为空, 直接返回
if(parameStr == null || parameStr.length() == 0) {
return url;
}
@ -392,19 +391,19 @@ public class SaFoxUtil {
return url + parameStr;
}
}
// 正常情况下, 代码不可能执行到此
// 正常情况下, 代码不可能执行到此
return url;
}
/**
* 在url上拼接锚参数
* 在url上拼接锚参数
* @param url url
* @param key 参数名称
* @param value 参数值
* @return 拼接后的url字符串
* @param value 参数值
* @return 拼接后的url字符串
*/
public static String joinSharpParam(String url, String key, Object value) {
// 如果url或者key为空, 直接返回
// 如果url或者key为空, 直接返回
if(isEmpty(url) || isEmpty(key)) {
return url;
}
@ -412,31 +411,31 @@ public class SaFoxUtil {
}
/**
* 拼接两个url
* 拼接两个url
* <p> 例如url1=http://domain.cnurl2=/sso/auth则返回http://domain.cn/sso/auth </p>
*
* @param url1 第一个url
* @param url2 第二个url
* @return 拼接完成的url
*
* @param url1 第一个url
* @param url2 第二个url
* @return 拼接完成的url
*/
public static String spliceTwoUrl(String url1, String url2) {
// q1任意一个为空则直接返回另一个
// q1任意一个为空则直接返回另一个
if(url1 == null) {
return url2;
}
if(url2 == null) {
return url1;
}
// q2如果 url2 http 开头将其视为一个完整地址
// q2如果 url2 http 开头将其视为一个完整地址
if(url2.startsWith("http")) {
return url2;
}
// q3将两个地址拼接在一起
// q3将两个地址拼接在一起
return url1 + url2;
}
/**
* 将数组的所有元素使用逗号拼接在一起
* @param arr 数组
@ -455,16 +454,16 @@ public class SaFoxUtil {
}
return str;
}
/**
* 验证URL的正则表达式
* 验证URL的正则表达式
*/
public static final String URL_REGEX = "(https?|ftp|file)://[-A-Za-z0-9+&@#/%?=~_|!:,.;]+[-A-Za-z0-9+&@#/%=~_|]";
public static final String URL_REGEX = "(https?|ftp|file)://[-A-Za-z0-9+&@#/%?=~_|!:,.;]+[-A-Za-z0-9+&@#/%=~_|]";
/**
* 使用正则表达式判断一个字符串是否为URL
* @param str 字符串
* @return 拼接后的url字符串
* @param str 字符串
* @return 拼接后的url字符串
*/
public static boolean isUrl(String str) {
if(isEmpty(str)) {
@ -472,11 +471,11 @@ public class SaFoxUtil {
}
return str.toLowerCase().matches(URL_REGEX);
}
/**
* URL编码
* @param url see note
* @return see note
* URL编码
* @param url see note
* @return see note
*/
public static String encodeUrl(String url) {
try {
@ -487,9 +486,9 @@ public class SaFoxUtil {
}
/**
* URL解码
* @param url see note
* @return see note
* URL解码
* @param url see note
* @return see note
*/
public static String decoderUrl(String url) {
try {
@ -498,11 +497,11 @@ public class SaFoxUtil {
throw new SaTokenException(e).setCode(SaErrorCode.CODE_12104);
}
}
/**
* 将指定字符串按照逗号分隔符转化为字符串集合
* 将指定字符串按照逗号分隔符转化为字符串集合
* @param str 字符串
* @return 分割后的字符串集合
* @return 分割后的字符串集合
*/
public static List<String> convertStringToList(String str) {
List<String> list = new ArrayList<String>();
@ -520,9 +519,9 @@ public class SaFoxUtil {
}
/**
* 将指定集合按照逗号连接成一个字符串
* @param list 集合
* @return 字符串
* 将指定集合按照逗号连接成一个字符串
* @param list 集合
* @return 字符串
*/
public static String convertListToString(List<?> list) {
if(list == null || list.size() == 0) {
@ -537,11 +536,11 @@ public class SaFoxUtil {
}
return str;
}
/**
* String Array按照逗号切割
* @param str 字符串
* @return 数组
* String Array按照逗号切割
* @param str 字符串
* @return 数组
*/
public static String[] convertStringToArray(String str) {
List<String> list = convertStringToList(str);
@ -549,9 +548,9 @@ public class SaFoxUtil {
}
/**
* Array String按照逗号连接
* @param arr 数组
* @return 字符串
* Array String按照逗号连接
* @param arr 数组
* @return 字符串
*/
public static String convertArrayToString(String[] arr) {
if(arr == null || arr.length == 0) {
@ -559,20 +558,20 @@ public class SaFoxUtil {
}
return String.join(",", arr);
}
/**
* 返回一个空集合
* @param <T> 集合类型
* @return 空集合
* 返回一个空集合
* @param <T> 集合类型
* @return 空集合
*/
public static <T>List<T> emptyList() {
return new ArrayList<>();
}
/**
* String数组转集合
* @param strs String数组
* @return 集合
* String数组转集合
* @param strs String数组
* @return 集合
*/
public static List<String> toList(String... strs) {
List<String> list = new ArrayList<>();
@ -581,9 +580,9 @@ public class SaFoxUtil {
}
return list;
}
public static List<String> logLevelList = Arrays.asList("", "trace", "debug", "info", "warn", "error", "fatal");
/**
* 将日志等级从 String 格式转化为 int 格式
* @param level /
@ -608,5 +607,5 @@ public class SaFoxUtil {
}
return logLevelList.get(level);
}
}

View File

@ -21,7 +21,7 @@
<jackson-datatype-jsr310.version>2.11.2</jackson-datatype-jsr310.version>
<servlet-api.version>3.1.0</servlet-api.version>
<thymeleaf.version>3.0.9.RELEASE</thymeleaf.version>
<solon.version>1.10.13</solon.version>
<solon.version>1.12.0</solon.version>
<noear-redisx.version>1.4.4</noear-redisx.version>
<jfinal.version>4.9.17</jfinal.version>
<jboot.version>3.14.4</jboot.version>

View File

@ -6,7 +6,7 @@ SaSession-会话对象,专业数据缓存组件。
### 1、常量
``` java
SaSession.ROLE_LIST = "USER"; // 在 Session 上存储用户对象时建议使用的key
SaSession.USER= "USER"; // 在 Session 上存储用户对象时建议使用的key
SaSession.ROLE_LIST = "ROLE_LIST"; // 在 Session 上存储角色时建议使用的key
SaSession.PERMISSION_LIST = "PERMISSION_LIST"; // 在 Session 上存储权限时建议使用的key
```

View File

@ -26,7 +26,7 @@ dao.updateTimeout(key, timeout); // 修改Value的剩余存活时间 (单位:
``` java
dao.getObject(key); // 获取Object如无返空
dao.setObject(key, value, timeout); // 写入Object并设定存活时间 (单位: 秒)
dao.setObject(key, value); // 更新Object (过期时间不变)
dao.updateObject(key, value); // 更新Object (过期时间不变)
dao.deleteObject(key); // 删除Object
dao.getObjectTimeout(key); // 获取Object的剩余存活时间 (单位: 秒)
dao.updateObjectTimeout(key, timeout); // 修改Object的剩余存活时间 (单位: 秒)

View File

@ -13,7 +13,7 @@ Sa-Token 中的基础异常类是 `SaTokenException`,在此基础上,又针
``` java
if(SaFoxUtil.isUrl(url) == false) {
throw new SaSsoException("无效redirect" + url).setCode(SaSsoExceptionCode.CODE_20001);
throw new SaSsoException("无效redirect" + url).setCode(SaSsoErrorCode.CODE_30001);
}
```
@ -28,13 +28,13 @@ public class GlobalExceptionHandler {
public SaResult handlerSaTokenException(SaTokenException e) {
// 根据不同异常细分状态码返回不同的提示
if(e.getCode() == 20001) {
if(e.getCode() == 30001) {
return SaResult.error("redirect 重定向 url 是一个无效地址");
}
if(e.getCode() == 20002) {
if(e.getCode() == 30002) {
return SaResult.error("redirect 重定向 url 不在 allowUrl 允许的范围内");
}
if(e.getCode() == 20004) {
if(e.getCode() == 30004) {
return SaResult.error("提供的 ticket 是无效的");
}
// 更多 code 码判断 ...

View File

@ -90,7 +90,6 @@ public class SaTokenConfigure {
// 此配置会与 application.yml 中的配置合并 (代码配置优先)
@Autowired
public void configSaToken(SaTokenConfig config) {
SaTokenConfig config = new SaTokenConfig();
config.setTokenName("satoken"); // token名称 (同时也是cookie名称)
config.setTimeout(30 * 24 * 60 * 60); // token有效期单位s 默认30天
config.setActivityTimeout(-1); // token临时有效期 (指定时间内无操作就视为token过期) 单位: 秒

View File

@ -69,8 +69,8 @@ public class XPluginImp implements Plugin {
SaManager.setSaTokenSecondContext(bean.create());
});
// 注入侦听器 Bean
context.subBean(SaTokenListener.class, sl -> {
// 注入侦听器 Bean 可以有多个
context.subBeansOfType(SaTokenListener.class, sl -> {
SaTokenEventCenter.registerListener(sl);
});
@ -115,8 +115,8 @@ public class XPluginImp implements Plugin {
SaManager.setSaSignTemplate(bean);
});
// 自定义 StpLogic 对象
context.getBeanAsync(StpLogic.class, bean -> {
// 自定义 StpLogic 对象可以有多个
context.subBeansOfType(StpLogic.class, bean -> {
StpUtil.setStpLogic(bean);
});
}