Class UrlRewriter

java.lang.Object
io.leandev.appfuse.docs.UrlRewriter
public class UrlRewriter extends Object

URL 替換工具

用於將 HTML 中的絕對 URL（canonical、og:url 等）進行替換。

使用範例

String html = UrlRewriter.rewriteHtml(
    html,
    "http://localhost:2000",
    "https://your-domain.com/app-docs"
);

String sitemap = UrlRewriter.rewriteSitemap(
    sitemap,
    "http://localhost:2000",
    "https://your-domain.com/app-docs"
);

  • Constructor Details

    • UrlRewriter

      public UrlRewriter()

  • Method Details

    • rewriteHtml

      public static String rewriteHtml(String html, String sourceUrl, String targetUrl)

      替換 HTML 中的絕對 URL

      涵蓋 SEO 與社群分享所需的各種 URL 出現位置：

      • <link rel="canonical">
      • <meta property="og:url">、<meta property="og:image">
      • <meta name="twitter:url">、<meta name="twitter:image">
      • <link rel="alternate">（hreflang 等）
      • <script type="application/ld+json"> 區段內的 URL
      Parameters:
      html - HTML 內容
      sourceUrl - 原始 URL（建置時使用）
      targetUrl - 目標 URL（部署時使用）
      Returns:
      替換後的 HTML

    • rewriteSitemap

      public static String rewriteSitemap(String sitemap, String sourceUrl, String targetUrl)
      替換 sitemap.xml 中的 URL
      Parameters:
      sitemap - sitemap.xml 內容
      sourceUrl - 原始 URL
      targetUrl - 目標 URL
      Returns:
      替換後的 sitemap

    • buildUrl

      public static String buildUrl(String siteUrl, String basename)

      建構完整的目標 URL

      將 siteUrl 與 basename 組合。 範例：

      • https://example.com + /docs → https://example.com/docs
      • https://example.com/cfoh + /docs → https://example.com/cfoh/docs（siteUrl 含可選專案前綴）
      Parameters:
      siteUrl - 站台網域（如 https://example.com），支援含可選專案前綴 path（如 https://example.com/cfoh）
      basename - 模組路徑（如 /docs/）
      Returns:
      完整 URL

    • normalizeUrl

      public static String normalizeUrl(String url)
      正規化 URL，移除結尾的斜線
      Parameters:
      url - 原始 URL
      Returns:
      正規化後的 URL