叠加 overlays
Adobe Experience Manager (AEM)(以及之前的CQ)一直使用叠加原理来允许您扩展和自定义 控制台 和其他功能(例如, 页面创作)。
“叠加”是在许多上下文中使用的术语。 在此上下文中(扩展AEM),叠加意味着采用预定义功能并将您自己的定义强加于此预定义功能之上(以自定义标准功能)。
在标准实例中,预定义功能保存在 /libs
推荐做法是在下定义您的叠加(自定义) /apps
分支。 AEM使用搜索路径来查找资源,首先搜索 /apps
分支,然后 /libs
分支( 可以配置搜索路径)。 此机制意味着您的叠加(以及其中定义的自定义项)具有优先级。
自AEM 6.0起,对叠加的实施和使用方式进行了更改:
-
AEM 6.0及更高版本 — 用于 Granite — 相关的叠加图(即触屏UI)
-
方法
-
重建适当的
/libs
结构/apps
.这不需要一对一的拷贝, Sling资源合并器 用于交叉引用所需的原始定义。 Sling资源合并器提供访问资源并将其与差异(差异)机制合并的服务。
-
下
/apps
,进行任何更改。
-
-
优点
- 对下的更改更加强健
/libs
. - 仅重新定义所需的内容。
- 对下的更改更加强健
-
-
AEM 6.0之前的非Granite叠加和叠加
-
方法
-
复制内容来源
/libs
到/apps
复制整个子分支,包括资产。
-
下
/apps
,进行任何更改。
-
-
缺点
- 尽管当下面的内容发生更改时,您的更改不会丢失
/libs
,您可能必须重新创建在下叠加中发生的某些更改/apps
.
- 尽管当下面的内容发生更改时,您的更改不会丢失
-
叠加是适用于许多更改的推荐方法,例如 配置控制台 或 在侧面板的资源浏览器中创建选择类别 (在创作页面时使用)。 它们必须是:
-
不要 在中更改
/libs
分支 您所做的任何更改都可能会丢失,因为每当您:- 在实例上升级
- 应用修补程序
- 安装功能包
-
它们将您的更改集中在一个位置;您可以更轻松地跟踪、迁移、备份或调试更改(如有必要)。
配置搜索路径 configuring-the-search-paths
对于叠加图,交付的资源是检索到的资源和属性的汇总,具体取决于可以定义的搜索路径:
-
资源 解析程序搜索路径 如 OSGi配置 对于 Apache Sling Resource Resolver Factory.
- 搜索路径的自上而下顺序指示其各自的优先级。
- 在标准安装中,主要缺省值为
/apps
,/libs
— 因此,此页面的/apps
具有比以下项更高的优先级/libs
(也就是说, 叠加 它)。
-
两个服务用户需要对脚本存储位置具有JCR:READ访问权限。 这些用户是: 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
在以下情况下介绍了一些示例: