From be5ee2fc2ba8e65755827d75ae20766d913a5fb2 Mon Sep 17 00:00:00 2001
From: kfyty725 <kkfyty725@hotmail.com>
Date: Wed, 4 Jun 2025 16:12:23 +0800
Subject: [PATCH] =?UTF-8?q?feat:loveqq-framework=E5=90=AF=E5=8A=A8?=
 =?UTF-8?q?=E5=99=A8?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 .../satoken/loveqq/boot/filter/SaFirewallCheckFilter.java     | 2 +-
 .../cn/dev33/satoken/loveqq/boot/filter/SaRequestFilter.java  | 2 +-
 .../satoken/loveqq/boot/filter/SaTokenContextFilter.java      | 2 +-
 .../dev33/satoken/loveqq/boot/filter/SaTokenCorsFilter.java   | 4 +++-
 .../dev33/satoken/loveqq/boot/utils/SaTokenContextUtil.java   | 2 ++
 5 files changed, 8 insertions(+), 4 deletions(-)

diff --git a/sa-token-starter/sa-token-loveqq-boot-starter/src/main/java/cn/dev33/satoken/loveqq/boot/filter/SaFirewallCheckFilter.java b/sa-token-starter/sa-token-loveqq-boot-starter/src/main/java/cn/dev33/satoken/loveqq/boot/filter/SaFirewallCheckFilter.java
index 2669f03e..304ce3e9 100644
--- a/sa-token-starter/sa-token-loveqq-boot-starter/src/main/java/cn/dev33/satoken/loveqq/boot/filter/SaFirewallCheckFilter.java
+++ b/sa-token-starter/sa-token-loveqq-boot-starter/src/main/java/cn/dev33/satoken/loveqq/boot/filter/SaFirewallCheckFilter.java
@@ -32,7 +32,7 @@ import com.kfyty.loveqq.framework.web.core.http.ServerRequest;
 import com.kfyty.loveqq.framework.web.core.http.ServerResponse;
 
 /**
- * 防火墙校验过滤器
+ * 防火墙校验过滤器 (基于 loveqq-framework 统一 Filter，可以统一 servlet 和 reactor 配置)
  *
  * @author click33
  * @since 1.37.0
diff --git a/sa-token-starter/sa-token-loveqq-boot-starter/src/main/java/cn/dev33/satoken/loveqq/boot/filter/SaRequestFilter.java b/sa-token-starter/sa-token-loveqq-boot-starter/src/main/java/cn/dev33/satoken/loveqq/boot/filter/SaRequestFilter.java
index b0a44904..a05a2268 100644
--- a/sa-token-starter/sa-token-loveqq-boot-starter/src/main/java/cn/dev33/satoken/loveqq/boot/filter/SaRequestFilter.java
+++ b/sa-token-starter/sa-token-loveqq-boot-starter/src/main/java/cn/dev33/satoken/loveqq/boot/filter/SaRequestFilter.java
@@ -36,7 +36,7 @@ import java.util.Arrays;
 import java.util.List;
 
 /**
- * 全局鉴权过滤器
+ * 全局鉴权过滤器 (基于 loveqq-framework 统一 Filter，可以统一 servlet 和 reactor 配置)
  * <p>
  * 默认优先级为 -100，尽量保证在其它过滤器之前执行
  * </p>
diff --git a/sa-token-starter/sa-token-loveqq-boot-starter/src/main/java/cn/dev33/satoken/loveqq/boot/filter/SaTokenContextFilter.java b/sa-token-starter/sa-token-loveqq-boot-starter/src/main/java/cn/dev33/satoken/loveqq/boot/filter/SaTokenContextFilter.java
index fbd2d297..ba38d368 100644
--- a/sa-token-starter/sa-token-loveqq-boot-starter/src/main/java/cn/dev33/satoken/loveqq/boot/filter/SaTokenContextFilter.java
+++ b/sa-token-starter/sa-token-loveqq-boot-starter/src/main/java/cn/dev33/satoken/loveqq/boot/filter/SaTokenContextFilter.java
@@ -25,7 +25,7 @@ import com.kfyty.loveqq.framework.web.core.http.ServerRequest;
 import com.kfyty.loveqq.framework.web.core.http.ServerResponse;
 
 /**
- * SaTokenContext 上下文初始化过滤器 (基于 Servlet)
+ * SaTokenContext 上下文初始化过滤器 (基于 loveqq-framework 统一 Filter，可以统一 servlet 和 reactor 配置)
  *
  * @author click33
  * @since 1.42.0
diff --git a/sa-token-starter/sa-token-loveqq-boot-starter/src/main/java/cn/dev33/satoken/loveqq/boot/filter/SaTokenCorsFilter.java b/sa-token-starter/sa-token-loveqq-boot-starter/src/main/java/cn/dev33/satoken/loveqq/boot/filter/SaTokenCorsFilter.java
index 2fdeecb4..9dac1807 100644
--- a/sa-token-starter/sa-token-loveqq-boot-starter/src/main/java/cn/dev33/satoken/loveqq/boot/filter/SaTokenCorsFilter.java
+++ b/sa-token-starter/sa-token-loveqq-boot-starter/src/main/java/cn/dev33/satoken/loveqq/boot/filter/SaTokenCorsFilter.java
@@ -30,9 +30,11 @@ import com.kfyty.loveqq.framework.web.core.http.ServerRequest;
 import com.kfyty.loveqq.framework.web.core.http.ServerResponse;
 
 /**
- * CORS 跨域策略过滤器
+ * CORS 跨域策略过滤器 (基于 loveqq-framework 统一 Filter，可以统一 servlet 和 reactor 配置)
+ * loveqq-framework 也有跨域过滤器，切勿同时配置
  *
  * @author click33
+ * @see com.kfyty.loveqq.framework.web.core.cors.CorsFilter
  * @since 1.42.0
  */
 @Component
diff --git a/sa-token-starter/sa-token-loveqq-boot-starter/src/main/java/cn/dev33/satoken/loveqq/boot/utils/SaTokenContextUtil.java b/sa-token-starter/sa-token-loveqq-boot-starter/src/main/java/cn/dev33/satoken/loveqq/boot/utils/SaTokenContextUtil.java
index 3d1bea75..911c6e58 100644
--- a/sa-token-starter/sa-token-loveqq-boot-starter/src/main/java/cn/dev33/satoken/loveqq/boot/utils/SaTokenContextUtil.java
+++ b/sa-token-starter/sa-token-loveqq-boot-starter/src/main/java/cn/dev33/satoken/loveqq/boot/utils/SaTokenContextUtil.java
@@ -38,6 +38,7 @@ import com.kfyty.loveqq.framework.web.core.http.ServerResponse;
 public class SaTokenContextUtil {
     /**
      * 写入当前上下文
+     * 并返回当前的上下文，以支持 loveqq-framework 的 servlet/reactor 的统一配置
      *
      * @param request  /
      * @param response /
@@ -87,6 +88,7 @@ public class SaTokenContextUtil {
 
     /**
      * 清除当前上下文
+     * 并恢复之前的上下文，以支持 loveqq-framework 的 servlet/reactor 的统一配置
      */
     public static void clearContext(SaTokenContextModelBox prev) {
         if (prev == null) {