路由與導向 (Routing)

路由解析與導向行為所遵循的決策模型。


核心架構

Intor 將路由與導向(Routing)拆分為兩個相互對應的核心構成:


路徑

路徑描述語系在 URL 中的結構表達,並作為 Inbound 與 Outbound 的共同基礎。

其具體表達方式受 localePrefixbasePath 所影響。

關於設定方式,詳見:localePrefix basePath


路徑轉換模型

路徑以轉換模型進行操作,而非直接處理字串。

localizePathname 為此模型的核心實作,並作為對外提供的公開 API。

其轉換流程如下:

Canonicalize → Standardize → Materialize

轉換結果包含以下三種路徑表示:

  • canonicalPathname:移除 basePath 與語系前綴後的純路徑。
  • templatedPathname:以 {locale} 表示語系位置的模板路徑。
  • pathname:套用語系與路由規則後的最終實際路徑。