你提供的这段代码是 RuoYi 框架中核心的PermitAllUrlProperties配置类，其核心作用是自动扫描项目中所有标注了@Anonymous注解的 Controller 类/方法，提取对应的 URL 路径并统一管理，最终为 Sa-Token 等权限拦截器提供“允许匿名访问”的 URL 列表。
一、代码整体功能总结
这个类实现了InitializingBean和ApplicationContextAware接口，核心逻辑是：
- 在 Spring 容器初始化完成后，扫描所有
@RequestMapping注解的 Controller 方法； - 识别标注了
@Anonymous注解的类/方法，提取其 URL 路径； - 将 URL 中的路径变量（如
{id}）替换为通配符*，最终汇总成一个“匿名访问 URL 列表”； - 对外提供
getUrls()方法，供 Sa-Token 拦截器等组件获取这些免登录的 URL。
二、代码逐模块详细解释
1. 类注解与核心成员
@Configuration// 声明为Spring配置类，纳入容器管理publicclassPermitAllUrlPropertiesimplementsInitializingBean,ApplicationContextAware{// 正则表达式：匹配URL中的路径变量（如 {id}、{userId}）privatestaticfinalPatternPATTERN=Pattern.compile("\\{(.*?)\\}");// Spring应用上下文，用于获取容器中的BeanprivateApplicationContextapplicationContext;// 存储所有允许匿名访问的URL列表privateList<String>urls=newArrayList<>();// 通配符常量，用于替换路径变量publicStringASTERISK="*";}InitializingBean：实现该接口的afterPropertiesSet()方法，会在 Spring 容器初始化完当前 Bean 的属性后执行；ApplicationContextAware：实现该接口的setApplicationContext()方法，可获取 Spring 应用上下文（用于获取RequestMappingHandlerMapping）；PATTERN：正则匹配{xxx}格式的路径变量，比如将/system/user/{id}中的{id}匹配出来。
2. 核心方法：setApplicationContext（获取Spring上下文）
@OverridepublicvoidsetApplicationContext(ApplicationContextcontext)throwsBeansException{this.applicationContext=context;}- 作用：Spring 容器初始化时，自动将应用上下文注入到当前类的
applicationContext成员变量中； - 后续可通过该上下文获取
RequestMappingHandlerMapping（SpringMVC 中管理所有请求映射的核心 Bean）。
3. 核心方法：afterPropertiesSet（扫描并提取匿名URL）
这是整个类的核心逻辑，Spring 容器初始化完成后自动执行：
@OverridepublicvoidafterPropertiesSet(){// 1. 获取SpringMVC中管理所有@RequestMapping映射的核心BeanRequestMappingHandlerMappingmapping=applicationContext.getBean(RequestMappingHandlerMapping.class);// 2. 获取所有请求映射：key=RequestMappingInfo（URL、请求方式等），value=HandlerMethod（对应Controller方法）Map<RequestMappingInfo,HandlerMethod>map=mapping.getHandlerMethods();// 3. 遍历所有请求映射map.keySet().forEach(info->{HandlerMethodhandlerMethod=map.get(info);// 4. 第一步：扫描方法上的@Anonymous注解Anonymousmethod=AnnotationUtils.findAnnotation(handlerMethod.getMethod(),Anonymous.class);// 如果方法上有@Anonymous注解，提取URL并处理Optional.ofNullable(method).ifPresent(anonymous->Objects.requireNonNull(info.getPatternsCondition().getPatterns()).forEach(url->{// 替换URL中的路径变量（如{id}）为*，加入列表urls.add(RegExUtils.replaceAll(url,PATTERN,ASTERISK));}));// 5. 第二步：扫描类上的@Anonymous注解（Controller类）Anonymouscontroller=AnnotationUtils.findAnnotation(handlerMethod.getBeanType(),Anonymous.class);// 如果类上有@Anonymous注解，提取URL并处理Optional.ofNullable(controller).ifPresent(anonymous->Objects.requireNonNull(info.getPatternsCondition().getPatterns()).forEach(url->{urls.add(RegExUtils.replaceAll(url,PATTERN,ASTERISK));}));});}关键逻辑拆解：
- 步骤1-2：获取
RequestMappingHandlerMapping并拿到所有@RequestMapping映射关系，这是 SpringMVC 内部存储所有接口 URL 的核心数据结构； - 步骤4：检查 Controller 方法上是否有
@Anonymous注解：- 比如
@GetMapping("/user/{id}")+@Anonymous的方法，会被识别； info.getPatternsCondition().getPatterns()：获取该方法对应的所有 URL 路径（如[/user/{id}]）；RegExUtils.replaceAll(url, PATTERN, ASTERISK)：将{id}替换为*，最终 URL 变为/user/*；
- 比如
- 步骤5：检查 Controller 类上是否有
@Anonymous注解（优先级低于方法注解）：- 比如
@RestController @Anonymous @RequestMapping("/system/dept")的类，其下所有方法的 URL 都会被加入匿名列表；
- 比如
- Optional.ofNullable(…)：避免空指针，仅当注解存在时才执行后续逻辑。
4. Getter/Setter 方法
publicList<String>getUrls(){returnurls;}publicvoidsetUrls(List<String>urls){this.urls=urls;}- 作用：对外提供获取“匿名URL列表”的入口，你之前的
SaTokenConfig中AllUrlHandler大概率会调用这个getUrls()方法，获取所有允许匿名访问的 URL。
三、使用场景与示例
1. @Anonymous 注解的使用示例
// 示例1：Controller类上标注@Anonymous，该类下所有方法都允许匿名访问@Anonymous@RestController@RequestMapping("/system/login")publicclassLoginController{@PostMapping("/doLogin")publicAjaxResultdoLogin(){/* 登录逻辑 */}}// 示例2：单个方法上标注@Anonymous，仅该方法允许匿名访问@RestController@RequestMapping("/system/user")publicclassUserController{@Anonymous@GetMapping("/{id}")publicAjaxResultgetUserById(@PathVariableLongid){/* 查询用户逻辑 */}}2. URL 处理结果示例
| 原始URL | 处理后URL（加入urls列表） | 说明 |
|---|---|---|
/system/login/doLogin | /system/login/doLogin | 无路径变量，直接保留 |
/system/user/{id} | /system/user/* | 路径变量{id}替换为* |
/order/{orderId}/detail/{itemId} | /order/*/detail/* | 多个路径变量全部替换 |
四、与 SaTokenConfig 的关联
你之前的SaTokenConfig中用到了AllUrlHandler.getUrls()，而AllUrlHandler底层大概率会整合：
PermitAllUrlProperties.getUrls()（@Anonymous注解的URL）；SecurityProperties.getExcludes()（配置文件中手动排除的URL）；
最终为 Sa-Token 拦截器提供完整的“免登录URL列表”，确保这些URL不会被StpUtil.checkLogin()拦截。
五、核心设计亮点
- 自动扫描：无需手动配置匿名URL，只需在类/方法上标注
@Anonymous，自动识别并加入列表； - 路径变量兼容：将
{id}替换为*，避免因路径变量导致的URL匹配失败（如/user/123能匹配/user/*）； - Spring 生命周期整合：利用
InitializingBean和ApplicationContextAware，在容器初始化阶段完成扫描，保证数据提前加载。
总结
PermitAllUrlProperties是 RuoYi 框架中自动收集@Anonymous注解URL的核心配置类，通过扫描 SpringMVC 的请求映射，提取并处理匿名访问的URL；- 核心逻辑是将URL中的路径变量（
{xxx}）替换为通配符*，确保权限拦截器能正确匹配； - 该类的
getUrls()方法为 Sa-Token 拦截器提供“匿名URL列表”，是框架免登录URL管理的关键组件。
