Routes Registration
除了使用 @Route 注释注册路由之外，还可以根据应用逻辑、用户角色或其他条件在运行时动态注册、更新或删除路由。这种灵活性使你能够更动态地管理导航，而不是在编译时静态定义路由。
动态注册路由
你可以使用 RouteRegistry 类动态注册路由，该类可以通过 Router 访问。这允许你在运行时添加新路由，从而实现灵活导航。
示例：注册动态路由
Router router = Router.getCurrent();
RouteRegistry registry = router.getRegistry();
// 动态注册设置路由
registry.register("/settings", SettingsView.class);
// 导航到设置视图
router.navigate(SettingsView.class);
在此示例中，/settings 路由被动态注册，应用程序导航到新注册的视图。
条件路由注册
通常，路由需要根据特定条件（如用户角色或应用状态）添加或删除。通过动态路由，你可以在运行时有条件地注册 或注销路由。
示例：基于用户角色的条件注册
Router router = Router.getCurrent();
RouteRegistry registry = router.getRegistry();
// 检查用户角色并注册适当的路由
if (user.hasRole("editor")) {
registry.register("/editor/dashboard", EditorDashboardView.class);
} else if (user.hasRole("viewer")) {
registry.register("/viewer/dashboard", ViewerDashboardView.class);
}
// 导航到适当的仪表板
if (user.hasRole("editor")) {
router.navigate(EditorDashboardView.class);
} else if (user.hasRole("viewer")) {
router.navigate(ViewerDashboardView.class);
}
在此示例中：
- 根据用户角色动态注册
/editor/dashboard或/viewer/dashboard路由。 - 应用程序根据用户的访问权限导航到适当的仪表板。
移除路由
正如路由可以动态添加一样，它们也可以在运行时移除，当它们不再需要时，或者当应用程序的上下文发生变化时。
示例：移除已注册的路由
Router router = Router.getCurrent();
RouteRegistry registry = router.getRegistry();
// 移除设置视图的路由
registry.unregister("/settings");
// 可选地，通过组件类移除
registry.unregister(SettingsView.class);
在此示例中，当不再需要时，/settings 路由被动态移除。
应用启动时注册路由
你可以在应用程序初始化期间注册动态路由，使某些视图基于环境或启动时的配置可用。
示例：在应用启动期间注册路由
@Routify
public class Application extends App {
@Override
protected void onWillRun() {
// 仅在开发模式下注册调试视图
if (Environment.getCurrent().isDebug()) {
Router router = Router.getCurrent();
RouteRegistry registry = router.getRegistry();
registry.register("/debug", DebugView.class);
}
}
}
在此示例中：
DebugView在应用启动期间动态注册，但前提是应用在开发模式下运行。
动态注册带 @Route 注释的组件
除了手动定义路由外，还可以动态注册已经用 @Route 注释的组件。当你希望利用预先注释的类但依据应用逻辑动态注册时，这一点非常有用。
示例：注册 @Route 注释的组件
@Route("profile")
public class ProfileView extends Composite<Div> {
// 个人资料视图逻辑
}
Router router = Router.getCurrent();
RouteRegistry registry = router.getRegistry();
// 使用其 @Route 注释动态注册 ProfileView
registry.register(ProfileView.class);
// 导航到 ProfileView
router.navigate(ProfileView.class);
在此示例中：
ProfileView类用@Route("profile")注释。- 使用
registry.register(ProfileView.class)在运行时动态注册路由。
从整个包注册路由
如果你的应用程序有大量的路由并组织在一个包中，你可以动态注册该包中的所有 @Route 注释的组件。
示例：从一个包注册所有路由
Router router = Router.getCurrent();
RouteRegistry registry = router.getRegistry();
// 注册 "com.myapp.admin" 包内的所有路由
RouteRegistry.ofPackage(new String[] { "com.myapp.admin" }, registry);
在此示例中：
ofPackage方法扫描com.myapp.admin包并注册所有用@Route注释的类。- 对于以包组织的大型应用程序，这一点特别有用。
从 25.11 开始，集成框架可以通过 RouteRegistryProvider SPI 提供其自己的路由发现机制。这使得框架特定的功能如动态注册路由的依赖注入成为可能。有关详细信息，请参见路由注册提供者。
检索注册的路由
要检索所有动态注册的路由的列表，可以使用 RouteRegistry 类。当你需要以编程方式管理或显示可用路由时，这一点非常有用。
示例：检索并显示所有注册的路由
Router router = Router.getCurrent();
RouteRegistry registry = router.getRegistry();
List<RouteEntry> routes = registry.getAvailableRouteEntires();
routes.forEach(route -> console().log("Path: " + route.getPath()));
在此示例中，应用程序检索当前所有注册的路由并打印它们的路径。
动态管理路由别名
webforJ 允许你为单个视图注册多个别名。这意味着用户可以使用不同的 URL 路径访问相同的视图。
示例：动态注册路由别名
Router router = Router.getCurrent();
RouteRegistry registry = router.getRegistry();
// 注册主要路由
registry.register("/contact", ContactView.class);
// 为 contact 视图注册别名
registry.register("/support", ContactView.class);
registry.register("/help", ContactView.class);
在此示例中，ContactView 可通过三个不同的路径访问：/contact、/support 和 /help。