完善代码

Author: Yager-42

framework/fit/java/fit-builtin/services/fit-http-classic/definition/src/main/java/modelengine/fit/http/util/i18n/DefualtLocaleResolver.java

@@ -27,7 +27,7 @@ public class DefualtLocaleResolver implements LocaleResolver {
 
     @Override
     public Locale resolveLocale(HttpClassicServerRequest request) {
-        // 先解析 Cookie，如果没有则解析 Accept-Language 头
+        // 先解析 Cookie，如果没有则解析 Accept-Language 头。
         String newLocale = request.cookies().get(this.cookieName).map(Cookie::value).orElse(null);
         if (newLocale != null) {
             return Locale.forLanguageTag(newLocale);
@@ -42,7 +42,7 @@ public Locale resolveLocale(HttpClassicServerRequest request) {
             return Locale.forLanguageTag(acceptLanguage);
         }
 
-        return defaultLocale;
+        return this.defaultLocale;
     }
 
     @Override

framework/fit/java/fit-builtin/services/fit-http-classic/definition/src/main/java/modelengine/fit/http/util/i18n/LocaleResolveFilter.java

@@ -15,7 +15,7 @@
 import java.util.Locale;
 
 /**
- * 简单地区解析过滤器，只使用一种 {@link LocaleResolver} 进行地区解析，多插件同时配置 {@link LocaleResolveFilter} 可能会引发不可预知的行为。
+ * 地区解析过滤器，使用 {@link LocaleResolver} 进行地区解析。
  *
  * @author 阮睿
  * @since 2025-08-01
@@ -27,7 +27,7 @@ public class LocaleResolveFilter implements HttpServerFilter {
 
     private List<String> mismatchPatterns = List.of();
 
-    private Scope scope = Scope.GLOBAL;
+    private Scope scope = Scope.PLUGIN;
 
     /**
      * 构造函数。

framework/fit/java/fit-builtin/services/fit-http-classic/definition/src/main/java/modelengine/fit/http/util/i18n/LocaleResolver.java

@@ -18,9 +18,21 @@
  * @since 2025-08-01
  */
 public interface LocaleResolver {
+    /**
+     * 表示要设置 cookie 的名称。
+     */
     public static final String DEFAULT_COOKIE_NAME = "locale";
+    /**
+     * 表示要设置 cookie 的自动过期时间。
+     */
     public static final int DEFAULT_COOKIE_MAX_AGE = 60 * 60 * 24 * 365;
+    /**
+     * 表示要设置 Cookie 的可见域。
+     */
     public static final String DEFAULT_COOKIE_DOMAIN = "/";
+    /**
+     * 表示要设置 Cookie 的可见 URL 路径。
+     */
     public static final String DEFAULT_COOKIE_PATH = "/";
 
     /**

framework/fit/java/fit-util/src/main/java/modelengine/fitframework/util/i18n/LocaleContextHolder.java

@@ -23,7 +23,9 @@ public class LocaleContextHolder {
      * @param localeContext 表示将要存储在当前线程地区上下文的 {@link LocaleContext}。
      */
     public static void setLocaleContext(LocaleContext localeContext) {
-        LOCALE_CONTEXT_HOLDER.set(localeContext);
+        if (localeContext != null) {
+            LOCALE_CONTEXT_HOLDER.set(localeContext);
+        }
     }
 
     /**