Routable Apps

在ChatGPT中打开

在webforJ中，路由是一个可选工具。开发者可以选择使用webforJ路由解决方案或一个传统模型，该模型通过Frame操作且不支持深度链接。要启用路由，必须在实现App的类级别应用**@Routify**注解。这赋予了webforJ管理浏览器历史记录、响应导航事件并根据URL渲染应用组件的权利。

信息

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

`@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`

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

@Routify(defaultFrameName = "MainFrame")

默认情况下，如果未显式提供，该值设置为Routify.DEFAULT_FRAME_NAME。

3. `initializeFrame`

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

@Routify(initializeFrame = true)

4. `manageFramesVisibility`

此元素控制框架在导航过程中是否应自动切换框架的可见性。当启用时，匹配的路由会自动显示相应的框架，同时隐藏其他框架，从而确保用户界面的整洁和集中。此设置仅在您的应用管理多个框架时相关。

@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​