3.5.13. URL 历史及导航

最低版本7.0

CUBA URL 历史和导航功能可以提供浏览器历史记录和导航功能，这对于很多 web 应用程序来说是最基本的功能。此功能包含以下部分：

  • 历史 – 支持浏览器的 后退(Back) 按钮。但是不支持 前进(Forward) 按钮，因为没法重现打开界面的所有条件。

  • 路由以及导航 – 注册和处理应用程序界面的路由。

  • 路由 API – 一组方法，用来在 URL 中反映界面的当前状态。

fragment 是 URL 里“#”后面的部分，这部分用来做 路由 值。

比如，下面这个 URL：

host:port/app/#main/42/orders/edit?id=17

这个 URL 中，fragment 是 main/42/orders/edit?id=17，由以下部分组成：

  • main – 根界面的路由（主窗口）；

  • 42 – 一个 状态标记(state mark)，导航机制内部使用；

  • orders/edit – 嵌套的界面路由；

  • ?id=17 – 参数部分；

所有打开的界面都会将它们的路由映射到当前的 URL。比如，当用户浏览界面打开并且是当前界面的时候，应用程序的 URL 可能是这样：

  1. http://localhost:8080/app/#main/0/users

如果界面没有已经注册的路由，那么只会在 URL fragment 中添加状态标记。示例：

  1. http://localhost:8080/app/#main/42

对于编辑界面，如果界面有注册的路由，则会在地址后面以参数形式加上被编辑实体的 id。示例：

  1. http://localhost:8080/app/#main/1/users/edit?id=27zy3tj6f47p2e3m4w58vdca9y

UUID 类型的标识符会使用 Base32 Crockford 进行加密，其它类型则不会加密。

当没有用户登录的时候，又出于某些原因需要界面路由，则会使用重定向（redirect）参数。假设在地址栏中输入 app/#main/orders。当应用程序加载并且显示登录界面之后，地址会变成：app/#login?redirectTo=orders。在成功登录之后，才会打开 orders 路由对应的界面。

如果请求的路由不存在，应用程序会显示一个带有”Not Found”标题的空界面。

URL 历史和导航功能默认开启。设置应用程序属性cuba.web.urlHandlingMode为 NONE 可以关闭此功能，或者设置为 BACK_ONLY 回退到处理浏览器返回按钮的旧机制。