覆蓋

AEM（以及在此之前，CQ）長期以來都採用覆蓋原則，讓您擴充和自訂控制台和其他功能（例如，頁面編寫）。

Overlay是可在許多內容中使用的詞語。 在此內容（擴充AEM）中，覆蓋表示您會取用預先定義的功能，並將您自己的定義加入該功能（以自訂標準功能）。

在標準例項中，預先定義的功能保存在/libs下，建議您在/apps分支下定義覆蓋（自訂）。 AEM使用搜尋路徑來尋找資源，先搜尋/apps分支，再搜尋/libs分支（搜尋路徑可設定）。 此機制表示您的覆蓋（及其中定義的自訂）將具有優先順序。

自AEM 6.0起，已變更覆蓋的實作與使用方式：

• AEM 6.0以上版本——適用於Granite相關覆蓋（即觸控式UI）

  • 方法

    • 在/apps下重建適當的/libs結構。

      這不需要1:1復本，Sling Resource Merger會用來交叉參考所需的原始定義。 Sling Resource Merger提供服務，透過差異(differencing)機制存取和合併資源。

    • 在/apps下進行任何更改。

  • 優勢

    • 對/libs下的變更更更穩健。
    • 只重新定義實際需要的內容。

• AEM 6.0之前的非花崗石覆蓋和覆蓋

  • 方法

    • 將內容從/libs複製到/apps

      您需要複製整個子分支，包括屬性。

    • 在/apps下進行任何更改。

  • 缺點

    • 雖然您的變更不會在/libs下方發生變更時遺失，但您可能必須重新建立在/apps下方覆蓋中發生的特定變更。

Overlays是許多變更的建議方法，例如在側面板（用於製作頁面）中，設定控制台 或建立選擇類別至資產瀏覽器。 它們的要求如下：

• 不得​在/libs分支​​中進行變更
  您所做的任何變更都可能會遺失，因為此分支在您執行下列動作時都會面臨變更：

  • 升級至您的實例
  • 套用修補程式
  • 安裝功能套件

• 他們將您的變更集中在一個位置；讓您更輕鬆地追蹤、移轉、備份和／或除錯變更。

配置搜索路徑

對於覆蓋，所傳送的資源是所檢索的資源和屬性的匯總，具體取決於可定義的搜索路徑：

• 資源​解析器搜索路徑，如OSGi configuration中為​Apache Sling資源解析器工廠​定義的。

  • 搜索路徑的自頂向下順序指示其各自的優先順序。
  • 在標準安裝中，主要預設值為/apps、/libs —— 因此/apps的內容具有比/libs高的優先順序（即​覆蓋）。

• 兩個服務用戶需要對指令碼儲存位置的JCR：讀取訪問。 這些使用者包括：components-search-service(由com.day.cq.wcm.coreto存取／快取元件使用)和sling-scripting（由org.apache.sling.servlets.resolver用來尋找servlet）。

• 還必鬚根據指令碼的放置位置配置以下配置（在此示例中，位於/etc、/libs或/apps下）。

  PID = org.apache.sling.jcr.resource.internal.JcrResourceResolverFactoryImpl
  resource.resolver.searchpath=["/etc","/apps","/libs"]
  resource.resolver.vanitypath.whitelist=["/etc/","/apps/","/libs/","/content/"]
  

• 最後，還必須配置Servlet解析程式（在本示例中，還要添加/etc）

  PID = org.apache.sling.servlets.resolver.SlingServletResolver
  servletresolver.paths=["/bin/","/libs/","/apps/","/etc/","/system/","/index.servlet","/login.servlet","/services/"]
  

使用範例

以下是一些範例：

• 自定義控制台
• 自訂頁面編寫