Routable Apps

在 ChatGPT 中打开

在webforJ中，路由是一个可选工具。开发人员可以选择使用webforJ路由解决方案或使用Frame操作的传统模型，而不进行深层链接。要启用路由，必须在实现App的类级别应用**@Routify**注解。这使得webforJ能够管理浏览器历史、响应导航事件，并根据URL渲染应用的组件。

信息

要了解有关使用框架、内置组件和自定义组件构建用户界面的更多信息，请访问Building UIs。

`@Routify`注解的目的

**@Routify**使框架能够自动注册路由，管理框架的可见性，并定义路由行为，例如调试和框架初始化，从而允许应用中的动态灵活路由。

`@Routify`的使用

**@Routify**注解应用于主应用类的类级别。它指定要扫描的包集合以查找路由，并处理其他与路由相关的设置，例如框架初始化和可见性管理。

以下是一个基本示例：

@Routify(
  packages = {"com.myapp.views"},
  defaultFrameName = "MainFrame",
  initializeFrame = true,
  manageFramesVisibility = false,
  debug = true
)
public class MyApp extends App {

  @Override
  public void run() {
    // 应用逻辑在这里
  }
}

Routify默认配置

**@Routify**注解带有合理的默认配置。它假定当前包中的应用及其所有子包应扫描路由。此外，它假设应用默认仅管理一个框架。如果您的应用遵循此结构，则无需为该注解提供任何自定义配置。

`@Routify`的关键元素

1. `packages`

packages元素定义要扫描以获取路由定义的包。它使得无需手动注册即可自动发现路由，简化了扩展应用路由系统的过程。

@Routify(packages = {"com.myapp.views"})

如果未指定包，则使用应用的默认包。

2. `defaultFrameName`

该元素指定应用初始化的默认框架的名称。框架代表顶层UI容器，此设置控制第一个框架的命名和管理方式。

@Routify(defaultFrameName = "MainFrame")

默认情况下，如果未明确提供，值设置为Routify.DEFAULT_FRAME_NAME。

3. `initializeFrame`

initializeFrame标志决定框架在应用启动时是否应自动初始化第一个框架。将此设置为true可以简化初始框架的设置。

@Routify(initializeFrame = true)

4. `manageFramesVisibility`

此元素控制框架在导航期间是否应自动切换可见性。当启用时，匹配的路由会自动显示相应的框架，同时隐藏其他框架，确保UI干净且专注。此设置仅在您的应用管理多个框架时相关。

@Routify(manageFramesVisibility = true)

5. `debug`

debug标志启用或禁用路由调试模式。启用时，路由信息和操作会记录到控制台，以便在开发期间更轻松地进行调试。

@Routify(debug = true)

路由器调试模式和webforJ调试模式

如果将路由器调试模式设置为true但将webforJ调试模式设置为false，则不会在控制台中显示调试信息。

@Routify注解的目的​

@Routify的使用​

@Routify的关键元素​

1. packages​

2. defaultFrameName​

3. initializeFrame​

4. manageFramesVisibility​

5. debug​