Duurzame verbeteringen sustainable-upgrades
Customization Framework customization-framework
Architectuur (functioneel / infrastructuur / inhoud / toepassing) architecture-functional-infrastructure-content-application
De functie van het Kader van de Aanpassing wordt ontworpen om de schendingen in niet verlengbare gebieden van de code (zoals APIS) of inhoud (zoals overlays) te helpen verminderen die niet verbeteringsvriendelijk zijn.
Er zijn twee componenten van het aanpassingskader: de API-oppervlak en de Inhoudsclassificatie.
API-oppervlak api-surface
In eerdere versies van AEM vele API's werden deze via Uber Jar weergegeven. Sommige van deze API's waren niet bedoeld voor gebruik door klanten, maar werden blootgesteld aan ondersteuning voor AEM functionaliteit in verschillende bundels. In de toekomst worden de Java API's gemarkeerd als Public of Private om aan klanten aan te geven welke API's veilig kunnen worden gebruikt in de context van upgrades. Andere bijzonderheden zijn:
-
Java API's gemarkeerd als
Publickan worden gebruikt en van verwijzingen voorzien door de bundels van de douaneimplementatie. -
De openbare API's zijn achterwaarts compatibel met de installatie van een compatibiliteitspakket.
-
Het compatibiliteitspakket bevat een compatibiliteitspakket van Uber JAR om achterwaartse compatibiliteit te garanderen
-
Java API's gemarkeerd als
Privatezijn alleen bedoeld voor gebruik door AEM interne bundels en mogen niet door aangepaste bundels worden gebruikt.
Private en Public in dit verband mag niet worden verward met Java-noties van publieke en private klassen.
Inhoudsclassificaties content-classifications
AEM gebruikt al lang de principal of overlays en Sling Resource Merger om klanten toe te staan AEM functionaliteit uit te breiden en aan te passen. De vooraf bepaalde functionaliteit die de AEM consoles en UI van kracht maakt wordt opgeslagen in /libs. Klanten mogen niets wijzigen /libs maar kan hieronder extra inhoud toevoegen /apps om de in /libs (Zie Ontwikkelen met overlays voor meer informatie.) Dit heeft nog steeds veel problemen veroorzaakt bij het upgraden van AEM als de inhoud in /libs kan veranderen waardoor de overlayfunctie op onverwachte manieren wordt onderbroken. Klanten kunnen ook AEM componenten uitbreiden via overerving via sling:resourceSuperTypeof gewoon verwijzen naar een component in /libs rechtstreeks via sling:resourceType. Vergelijkbare upgradeproblemen kunnen optreden met verwijzing en gebruikstoepassingen negeren.
Om het voor klanten veiliger en gemakkelijker te maken te begrijpen welke gebieden /libs zijn veilig te gebruiken en de inhoud te bedekken in /libs is ingedeeld met de volgende mengsels:
-
Public (granite:PublicArea) - Definieert een knooppunt als 'public', zodat het kan worden bedekt, overgeërfd (
sling:resourceSuperType) of rechtstreeks gebruikt (sling:resourceType). De knopen onder /libs duidelijk als Openbaar zullen veilig zijn om met de toevoeging van een Pakket van de Verenigbaarheid te bevorderen. In het algemeen moeten klanten alleen knooppunten gebruiken die zijn gemarkeerd als Public. -
Abstract (graniet:AbstractArea) - Definieert een knooppunt als abstract. Knooppunten kunnen worden bedekt of overgeërfd (
sling:resourceSupertype) maar mag niet rechtstreeks worden gebruikt (sling:resourceType). -
Final (graniet:FinalArea) - Definieert een knooppunt als definitief. Als definitief geclassificeerde knooppunten kunnen niet worden bedekt of overgeërfd. Uiteindelijke knooppunten kunnen rechtstreeks via
sling:resourceType. Subknooppunten onder eindknooppunt worden standaard als intern beschouwd -
Internal (granite:InternalArea) - Definieert een knooppunt als internal. Als internal geclassificeerde knooppunten kunnen niet worden bedekt, overgeërfd of rechtstreeks worden gebruikt. Deze knooppunten zijn alleen bedoeld voor de interne functionaliteit van AEM
-
Geen aantekening - Knooppunten nemen een classificatie over op basis van de boomhiërarchie. De /-hoofdmap is standaard Openbaar. Knooppunten met een als intern of definitief ingedeelde ouder moeten ook als intern worden behandeld.
Internal, maar kan nog steeds worden gebruikt met standaard clientlib inclusie. Het is belangrijk dat een klant in deze gevallen de interne classificatie blijft respecteren.Type-indicatoren voor CRXDE Lite-inhoud crxde-lite-content-type-indicators
De in CRXDE Lite toegepaste mengsels zullen inhoudsknopen en bomen tonen die als worden gemerkt INTERNAL als grijs. Voor FINAL alleen het pictogram wordt grijs weergegeven. De onderliggende knooppunten van deze knooppunten worden ook grijs weergegeven. In beide gevallen is de functie Overlayknooppunt uitgeschakeld.
Openbaar
Definitief
Intern
Controle van inhoudsstatus
AEM 6.4 wordt verzonden met een health check om klanten te waarschuwen als overlay of inhoud waarnaar wordt verwezen wordt gebruikt op een manier die niet in overeenstemming is met de inhoudclassificatie.
De Toegangscontrole voor verkoop/graniet is een nieuwe health check die de repository controleert om te zien of de code van de klant de beveiligde nodes in AEM op onjuiste wijze benadert.
Deze scan /apps en duurt meestal enkele seconden.
Voor toegang tot deze nieuwe health check moet u het volgende doen:
-
Navigeer in het AEM Startscherm naar Gereedschappen > Bewerkingen > Gezondheidsrapporten
-
Klik op de knop Toegangscontrole voor verkoop/graniet zoals hieronder weergegeven:
Nadat het aftasten volledig is, zal een lijst van waarschuwingen aan een eind - gebruiker op de hoogte brengen van de beschermde knoop die verkeerd referenced is:
Na het herstellen van de overtredingen keert het terug naar de groene staat:
De gezondheidscontrole toont informatie die door de achtergronddienst wordt verzameld die asynchroon controleert wanneer een bekleding of middeltype over alle Verschuivende onderzoekspaden wordt gebruikt. Als inhoudmix onjuist wordt gebruikt, wordt een schending gerapporteerd.