文件AEM 6.4Developing 指南

覆蓋 overlays

Last update: Thu May 04 2023 00:00:00 GMT+0000 (Coordinated Universal Time)

建立對象：

  • 開發人員
CAUTION
AEM 6.4已結束延伸支援，本檔案不再更新。 如需詳細資訊，請參閱 技術支援期. 尋找支援的版本 此處.

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

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

在標準例項中，預先定義的功能會保留在 /libs 建議您在 /apps 分支。 AEM使用搜尋路徑來尋找資源，首先搜尋 /apps 分支，然後 /libs 分支( 可配置搜索路徑)。 此機制表示您的覆蓋（以及那裡定義的自訂）將具有優先順序。

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

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

    • 方法

      • 重建適當 /libs 結構 /apps.

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

      • 在 /apps.

    • 優點

      • 更強大，可執行 /libs.
      • 只重新定義實際需要的。

  • AEM 6.0之前的非Granite覆蓋圖和覆蓋圖

    • 方法

      • 複製內容來自 /libs to /apps

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

      • 在 /apps.

    • 缺點

      • 雖然當下的某項變更時，您的變更不會遺失 /libs，您可能必須重新建立下方覆蓋圖中發生的特定變更 /apps.
CAUTION
此 Sling Resource Merger 相關方法只能與 Granite. 這表示以骨架結構建立覆蓋圖僅適用於標準觸控式UI。
其他區域（包括傳統UI）的覆蓋涉及複製適當的節點和整個子結構，然後進行必要的變更。

覆蓋是許多變更的建議方法，例如 設定主控台 或 在側面板中建立您的選取類別至資產瀏覽器 （用於編寫頁面時）。 這些參數為：

  • 您 不能 在 /libs 分支​ ​您所做的任何變更都可能會遺失，因為只要您符合以下條件，此分支就會發生變更：

    • 在您的執行個體上升級
    • 套用hotfix
    • 安裝功能套件

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

設定搜尋路徑 configuring-the-search-paths

對於覆蓋，傳送的資源是所擷取資源和屬性的匯總，視可定義的搜尋路徑而定：

  • 資源 解析器搜尋路徑 定義於 OSGi配置 針對 Apache Sling Resource Resolver Factory.

    • 搜尋路徑的由上而下順序會指出其各自的優先順序。
    • 在標準安裝中，主要預設值為 /apps, /libs — 因此， /apps 比 /libs (即 覆蓋 )。

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

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

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

  • 最後，還必須設定Servlet解析器（在此範例中，也需新增/etc）

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

使用範例 example-of-usage

下列情形會提供一些範例：

recommendation-more-help
2315f3f5-cb4a-4530-9999-30c8319c520e