AEM (en daarvoor, CQ) heeft het beginsel van bekledingen lang gebruikt om u toe te staan om consoles en andere functionaliteit (bijvoorbeeld, page authoring) uit te breiden en aan te passen.
Bedekking is een term die in veel contexten kan worden gebruikt. In deze context (het uitbreiden van AEM) betekent een overlay het nemen van de vooraf bepaalde functionaliteit en het opleggen van uw eigen definities over dat (om de standaardfunctionaliteit aan te passen).
In een standaardinstantie wordt de vooraf gedefinieerde functionaliteit gehouden onder /libs
en het wordt aanbevolen de overlay (aanpassingen) te definiëren onder de /apps
-vertakking. AEM gebruikt een onderzoekspad om een middel te vinden, eerst zoekend /apps
tak en toen /libs
tak (de onderzoekspad kan worden gevormd). Dit mechanisme betekent dat uw bedekking (en de aanpassingen die daar worden bepaald) prioriteit zal hebben.
Sinds AEM 6.0 zijn wijzigingen aangebracht in de manier waarop overlays worden geïmplementeerd en gebruikt:
AEM 6.0 en hoger - voor granietgerelateerde overlays (d.w.z. de interface met aanraakbediening)
Methode
Reconstrueer de aangewezen /libs
structuur onder /apps
.
Dit vereist geen 1:1 exemplaar, Sling het Samenvoegen van het Middel wordt gebruikt om de originele definities te verwijzen die worden vereist. De het Verdelen Fusie van het Middel verleent de diensten om tot middelen toegang te hebben en samen te voegen door (het differentiëren) mechanismen af te schilderen.
Breng eventuele wijzigingen aan onder /apps
.
Voordelen
/libs
.Niet-graniet-overlays en -overlays vóór AEM 6.0
Methode
Kopieer de inhoud van /libs
naar /apps
U moet de gehele subvertakking kopiëren, inclusief de eigenschappen.
Breng eventuele wijzigingen aan onder /apps
.
Nadelen
/libs
, moet u mogelijk bepaalde wijzigingen opnieuw maken die voorkomen in de overlay onder /apps
.De Sling Resource Merger en de verwante methoden kunnen alleen worden gebruikt met Granite. Dit betekent dat het maken van een bedekking met een skeletstructuur alleen geschikt is voor de standaardinterface met aanraakbediening.
Bij overlays voor andere gebieden (waaronder de klassieke UI) worden het juiste knooppunt en de volledige substructuur gekopieerd en worden vervolgens de vereiste wijzigingen aangebracht.
Bedekkingen zijn de aanbevolen methode voor vele wijzigingen, zoals het configureren van de consoles🔗 of het maken van uw selectiecategorie in de middelenbrowser in het zijpaneel (wordt gebruikt bij het ontwerpen van pagina's). Zij zijn vereist als:
U mag niet wijzigingen aanbrengen in de /libs
-vertakking Alle wijzigingen die u aanbrengt, kunnen verloren gaan, omdat deze vertakking mogelijk wordt gewijzigd wanneer u:
Ze concentreren uw wijzigingen op één locatie. het voor u gemakkelijker maken om uw wijzigingen te volgen, te migreren, er een back-up van te maken en/of er fouten in op te sporen.
Voor bedekkingen is de geleverde bron een aggregaat van de opgehaalde bronnen en eigenschappen, afhankelijk van zoekpaden die kunnen worden gedefinieerd:
De bron Zoekpad voor oplosmiddel zoals gedefinieerd in de OSGi-configuratie voor de Apache Sling Resource Resolver Factory.
/apps
, /libs
- dus heeft de inhoud van /apps
een hogere prioriteit dan die van /libs
(d.w.z. het overlays het).Twee servicegebruikers hebben JCR nodig:ReAD toegang tot de locatie waar de scripts zijn opgeslagen. Deze gebruikers zijn: components-search-service (gebruikt door de componenten com.day.cq.wcm.coreto access/cache) en sling-scripting (gebruikt door org.apache.sling.servlets.resolver om servlets te zoeken).
De volgende configuratie moet ook worden gevormd volgens waar u uw manuscripten (in dit voorbeeld onder /etc, /libs of /apps) zet.
PID = org.apache.sling.jcr.resource.internal.JcrResourceResolverFactoryImpl
resource.resolver.searchpath=["/etc","/apps","/libs"]
resource.resolver.vanitypath.whitelist=["/etc/","/apps/","/libs/","/content/"]
Tot slot moet de Resolver van Servlet ook worden gevormd (in dit voorbeeld om /etc eveneens toe te voegen)
PID = org.apache.sling.servlets.resolver.SlingServletResolver
servletresolver.paths=["/bin/","/libs/","/apps/","/etc/","/system/","/index.servlet","/login.servlet","/services/"]
Enkele voorbeelden worden behandeld wanneer: