Die Ressourcenzuordnung wird zur Definition von Umleitungen, Vanity-URLs und virtuellen Hosts für AEM verwendet.
Diese Zuordnungen können Sie beispielsweise folgendermaßen verwenden:
/content
damit die interne Struktur für die Besucher Ihrer Website ausgeblendet wird./content/en/gateway
-Seite Ihrer Website werden zu https://gbiv.com/
.Bei einer möglichen HTTP-Zuordnung wird allen Anforderungen an localhost:4503 das Präfix /content vorangestellt. Eine solche Zuordnung kann zum Ausblenden der internen Struktur für die Besucher der Website verwendet werden, da sie den Zugriff auf:
localhost:4503/content/geometrixx/en/products.html
mithilfe von:
localhost:4503/geometrixx/en/products.html
da durch die Zuordnung automatisch das Präfix hinzugefügt wird /content
nach /geometrixx/en/products.html
.
Vanity-URLs unterstützen keine Regex-Muster.
Weitere Informationen finden Sie in der Sling-Dokumentation sowie unter Zuordnungen für die Ressourcenauflösung und Ressourcen.
Die Zuordnungen bilden zwei Listen, die der JCR-Ressourcen-Resolver auswertet (von oben nach unten), um eine Übereinstimmung zu finden.
Diese Listen können (zusammen mit Konfigurationsinformationen) unter der JCR ResourceResolver Option der Felix-Konsole; Beispiel: https://<host>:<port>/system/console/jcrresolver
:
Konfiguration
Zeigt die aktuelle Konfiguration an (wie für die Variable Apache Sling Resource Resolver.
Konfigurationstest
Hiermit können Sie eine URL oder einen Ressourcenpfad eingeben. Klicken Sie auf Resolve oder Map, um festzulegen, wie das System den Eintrag transformiert.
Resolver Map Entries Die Liste der Einträge, die von den ResourceResolver.resolve-Methoden für die Zuordnung von URLs zu Ressourcen verwendet wird.
Mapping Map Entries Die Liste der Einträge, die von den ResourceResolver.map-Methoden für die Zuordnung von Ressourcenpfaden zu URLs verwendet wird.
Die beiden Listen enthalten verschiedene Einträge, darunter die von der/den Anwendung/en als Standardwerte definierten. Sie dienen häufig dazu, URLs für die Benutzer zu vereinfachen.
Die Listen verbinden ein Muster, d. h. einen auf die Anforderung abgestimmten regulären Ausdruck, mit einer Ersetzung, die die anzuwendende Umleitung definiert.
So löst beispielsweise das
Muster ^[^/]+/[^/]+/welcome$
das
Ersatz /libs/cq/core/content/welcome.html
.
aus, um die Anforderung
http://localhost:4503/welcome
in:
http://localhost:4503/libs/cq/core/content/welcome.html
Neue Zuordnungsdefinitionen werden im Repository erstellt.
Es stehen viele Ressourcen zur Verfügung, mit denen erläutert wird, wie reguläre Ausdrücke definiert werden. Beispiel https://www.regular-expressions.info/.
Eine Standardinstallation von AEM umfasst folgenden Ordner:
/etc/map/http
Dies ist die Struktur, die beim Definieren von Zuordnungen für das HTPP-Protokoll verwendet wird. Andere Ordner ( sling:Folder
) kann unter erstellt werden. /etc/map
für alle anderen Protokolle, die Sie zuordnen möchten.
So erstellen Sie die Zuordnung, die einer Anforderung an http://localhost:4503/ vorangestellt ist mit /content
:
Navigieren Sie mit CRXDE zu /etc/map/http
.
Erstellen Sie einen neuen Knoten:
Typ sling:Mapping
Dieser Knotentyp ist für solche Zuordnungen vorgesehen, seine Verwendung ist jedoch nicht obligatorisch.
Name localhost_any
Klicken Sie auf Alle speichern.
Fügen Sie diesem Knoten die folgenden Eigenschaften hinzu:
Name sling:match
String
localhost.4503/
Name sling:internalRedirect
String
/content/
Klicken Sie auf Alle speichern.
Dadurch wird eine Anfrage verarbeitet, z. B.:
localhost:4503/geometrixx/en/products.html
wie wenn:
localhost:4503/content/geometrixx/en/products.html
wurden beantragt.
Weitere Informationen zu den verfügbaren Sling-Eigenschaften und wie diese konfiguriert werden können, finden Sie in der Sling-Dokumentation unter Ressourcen
Sie können /etc/map.publish
, um die Konfigurationen für die Veröffentlichungsumgebung zu speichern. Diese müssen dann repliziert werden und der neue Speicherort ( /etc/map.publish
) für die Zuordnungsort des Apache Sling Resource Resolver der Veröffentlichungsumgebung.