- 后端：更新 README

- 后端：重构部分代码

user/user-sdk/src/main/java/cn/iocoder/mall/user/sdk/annotation/PermitAll.java

@@ -1,14 +0,0 @@
-package cn.iocoder.mall.user.sdk.annotation;
-
-import java.lang.annotation.*;
-
-/**
- * URL 是否允许所有都可访问。即用户不登陆，就可以访问指定 URL 。
- *
- * 例如说，注册接口，用户是不需要登陆，就可以访问的。
- */
-@Documented
-@Target({ElementType.METHOD}) // ElementType.TYPE 暂时不支持类级别。为了减少判断，略微提升性能。
-@Retention(RetentionPolicy.RUNTIME)
-public @interface PermitAll {
-}

user/user-sdk/src/main/java/cn/iocoder/mall/user/sdk/annotation/RequiresLogin.java

@@ -0,0 +1,16 @@
+package cn.iocoder.mall.user.sdk.annotation;
+
+import java.lang.annotation.*;
+
+/**
+ * 要求用户登录注解。通过将该注解添加到 Controller 上，会自动校验用户是否登陆。
+ *
+ * 默认请求下，用户访问的 API 接口，无需登陆。主要的考虑是，
+ * 1. 需要用户登陆的接口，本身会获取在线用户的编号。如果不添加 @RequiresLogin 注解就会报错。
+ * 2. 大多数情况下，用户的 API 接口无需登陆。
+ */
+@Documented
+@Target({ElementType.METHOD}) // 暂时不支持 ElementType.TYPE ，因为没有场景
+@Retention(RetentionPolicy.RUNTIME)
+public @interface RequiresLogin {
+}

user/user-sdk/src/main/java/cn/iocoder/mall/user/sdk/interceptor/UserSecurityInterceptor.java

@@ -9,7 +9,7 @@ import cn.iocoder.mall.admin.api.OAuth2Service;
 import cn.iocoder.mall.admin.api.bo.oauth2.OAuth2AuthenticationBO;
 import cn.iocoder.mall.admin.api.constant.AdminErrorCodeEnum;
 import cn.iocoder.mall.admin.api.dto.oauth2.OAuth2GetTokenDTO;
-import cn.iocoder.mall.user.sdk.annotation.PermitAll;
+import cn.iocoder.mall.user.sdk.annotation.RequiresLogin;
 import cn.iocoder.mall.user.sdk.context.UserSecurityContext;
 import cn.iocoder.mall.user.sdk.context.UserSecurityContextHolder;
 import org.apache.dubbo.config.annotation.Reference;
@@ -49,8 +49,8 @@ public class UserSecurityInterceptor extends HandlerInterceptorAdapter {
 
         // 进行鉴权
         HandlerMethod method = (HandlerMethod) handler;
-        boolean isPermitAll = method.hasMethodAnnotation(PermitAll.class);
-        if (!isPermitAll) { // 如果需要鉴权
+        boolean requiresLogin = method.hasMethodAnnotation(RequiresLogin.class);
+        if (requiresLogin) { // 如果需要鉴权
             if (serviceException != null) { // 认证失败，抛出上面认证失败的 ServiceException 异常
                 throw serviceException;
             }