路由注册提供者 25.11

在 ChatGPT 中打开

RouteRegistryProvider 是一个服务提供者接口 (SPI)，允许集成框架提供自定义的路由发现机制。这使得框架能够将其自己的类路径扫描和依赖注入系统与 webforJ 的路由基础设施集成。

概述

webforJ 通过扫描包以寻找 @Route 注解的组件来发现路由。RouteRegistryProvider SPI 允许框架使用自己的发现机制覆盖此默认行为。

在以下情况下使用此 SPI：

与依赖注入框架集成，如 Spring，或上下文和依赖注入 (CDI)
支持专门环境 (OSGi，自定义类加载器，GraalVM)
构建需要管理路由组件生命周期的框架适配器
重用现有的类路径扫描以优化启动时间

工作原理

当调用 RouteRegistry.ofPackage() 时，webforJ 通过 Java 的 ServiceLoader 检查注册的提供者。如果找到提供者，则将路由发现委托给该提供者。否则，使用默认的扫描机制。

构建您的提供者

要创建一个自定义路由发现提供者，实现 SPI 接口并通过 Java 的 ServiceLoader 机制进行注册。

实现 SPI

创建一个实现 RouteRegistryProvider 的类：

public class CustomRouteRegistryProvider implements RouteRegistryProvider {

  @Override
  public void registerRoutes(String[] packages, RouteRegistry registry) {
    // 扫描包并注册 @Route 组件
  }
}

启用发现

将提供者的完整类名添加到 META-INF/services/com.webforj.router.RouteRegistryProvider：

src/main/resources/META-INF/services/com.webforj.router.RouteRegistryProvider
com.example.framework.CustomRouteRegistryProvider

概述​

工作原理​

构建您的提供者​

实现 SPI​

启用发现​

概述

工作原理

构建您的提供者

实现 SPI

启用发现