Ressourcenzuordnung

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:

• Setzen Sie allen Anforderungen das Präfix /content voran, damit die interne Struktur für die Besucher Ihrer Website ausgeblendet wird.
• Definieren Sie eine Umleitung, damit alle Anforderungen an die /content/en/gateway-Seite Ihrer Website an https://gbiv.com/ umgeleitet werden.

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 /content zu /geometrixx/en/products.html hinzugefügt wird.

Anzeigen von Zuordnungsdefinitionen

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 Option JCR ResourceResolver der Felix-Konsole angezeigt werden. Beispiel: https://<host>:<port>/system/console/jcrresolver:

• Konfiguration

  Zeigt die aktuelle Konfiguration (wie für den Apache Sling Resource Resolver🔗 definiert) an.

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

Erstellen von Zuordnungsdefinitionen in AEM

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) können unter /etc/map für alle anderen Protokolle erstellt werden, die Sie zuordnen möchten.

Konfigurieren einer internen Umleitung an „/content“

So erstellen Sie die Zuordnung, die einer Anforderung an http://localhost:4503/ mit /content vorangestellt ist:

1. Navigieren Sie mit CRXDE zu /etc/map/http.

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

3. Klicken Sie auf Alle speichern.

4. Fügen Sie diesem Knoten die folgenden Eigenschaften hinzu:

   • Name sling:match

     • Typ String
     • Wert localhost.4503/

   • Name sling:internalRedirect

     • Typ String
     • Wert /content/

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