DocumentatieAEM 6.4Handleiding voor ontwikkeling

Bedekkingen overlays

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

Gemaakt voor:

  • Developer
CAUTION
AEM 6.4 heeft het einde van de uitgebreide ondersteuning bereikt en deze documentatie wordt niet meer bijgewerkt. Raadpleeg voor meer informatie onze technische ondersteuningsperioden. Ondersteunde versies zoeken hier.

AEM (en daarvoor, CQ) heeft het beginsel van overlays al lang gebruikt om u toe te staan de consoles en andere functies (bijvoorbeeld pagina's ontwerpen).

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 onder gehouden /libs en het wordt aanbevolen om uw bedekking (aanpassingen) onder de /apps vertakking. AEM gebruikt een zoekpad om een bron te zoeken, waarbij u eerst de /apps vertakt en vervolgens /libs vertakking zoekpad kan worden geconfigureerd). 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 vanaf - voor Granietgerelateerde overlays (d.w.z. de interface met aanraakbediening)

    • Methode

      • Reconstrueren /libs structuur onder /apps.

        Hiervoor is geen 1:1-kopie nodig, de Samenvoegen van verkoopbronnen wordt gebruikt voor kruisverwijzingen naar de oorspronkelijke definities die vereist zijn. 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

      • Meer robuust voor wijzigingen onder /libs.
      • Alleen opnieuw definiëren wat werkelijk vereist is.

  • Niet-graniet-overlays en -overlays vóór AEM 6.0

    • Methode

      • Inhoud kopiëren uit /libs tot /apps

        U moet de gehele subvertakking kopiëren, inclusief de eigenschappen.

      • Breng eventuele wijzigingen aan onder /apps.

    • Nadelen

      • Hoewel uw wijzigingen niet verloren gaan wanneer er iets verandert onder /libs, kan het zijn dat u bepaalde wijzigingen opnieuw moet aanbrengen die optreden in de bedekking onder /apps.
CAUTION
De Samenvoegen van verkoopbronnen en de bijbehorende methoden mogen alleen worden gebruikt met Graniet. 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 veel wijzigingen, zoals configureren, consoles of selectiecategorie maken voor de middelenbrowser in het zijpaneel (wordt gebruikt bij het ontwerpen van pagina's). Zij zijn vereist als:

  • U mogen wijzigingen aanbrengen in de /libs vertakking ​ Alle wijzigingen die u aanbrengt, kunnen verloren gaan, omdat deze vertakking mogelijk wordt gewijzigd wanneer u:

    • upgrade uitvoeren op uw exemplaar
    • hotfix toepassen
    • een functiepakket installeren

  • 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.

De zoekpaden configureren configuring-the-search-paths

Voor bedekkingen is de geleverde bron een aggregaat van de opgehaalde bronnen en eigenschappen, afhankelijk van zoekpaden die kunnen worden gedefinieerd:

  • De bron Zoekpad omzetten zoals gedefinieerd in het OSGi-configuratie voor de Apache Sling Resource Resolver Factory.

    • De top-down orde van onderzoekspaden wijst op hun respectieve prioriteiten.
    • In een standaardinstallatie zijn de primaire standaardinstellingen /apps, /libs - dus de inhoud van /apps heeft een hogere prioriteit dan die van /libs (d.w.z. bedekkingen 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.

    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/"]

  • Tot slot moet de Resolver van Servlet ook worden gevormd (in dit voorbeeld om /etc eveneens toe te voegen)

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

Voorbeeld van gebruik example-of-usage

Enkele voorbeelden worden behandeld wanneer:

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