DokumentationAEM 6.4Implementierungshandbuch

Ressourcenzuordnung resource-mapping

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

Erstellt für:

  • Developer
CAUTION
AEM 6.4 hat das Ende der erweiterten Unterstützung erreicht und diese Dokumentation wird nicht mehr aktualisiert. Weitere Informationen finden Sie in unserer technische Unterstützung. Unterstützte Versionen suchen here.

Die Ressourcenzuordnung wird verwendet, um Umleitungen, Vanity-URLs und virtuelle Hosts für AEM zu definieren.

Diese Zuordnungen können Sie beispielsweise verwenden, um:

  • Allen Anfragen das Präfix /content voranzustellen, sodass die interne Struktur für Besucher Ihrer Website ausgeblendet wird.
  • Eine Umleitung zu definieren, sodass alle Anfragen an die Seite /content/en/gateway Ihrer Website zu https://gbiv.com/ umgeleitet werden.

Eine mögliche HTTP-Zuordnung Präfixiert alle Anforderungen an localhost:4503 mit /content. 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 die Zuordnung automatisch das Präfix /content zu /geometrixx/en/products.html hinzufügt.

CAUTION
Vanity-URLs unterstützen keine Regex-Muster.
NOTE
Weitere Informationen finden Sie in der Sling-Dokumentation sowie unter Zuordnungen für die Ressourcenauflösung und Ressourcen.

Anzeigen von Zuordnungsdefinitionen viewing-mapping-definitions

Die Zuordnungen bilden zwei Listen, die der JCR Resource 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 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. Diese zielen häufig darauf ab, URLs für den Benutzer zu vereinfachen.

Das Listen-Paar enthält eine Muster, einen regulären Ausdruck, der mit der Anfrage übereinstimmt, mit einer Ersatz die die Umleitung definiert, die durchgesetzt werden soll.

Beispiel:

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.

NOTE
Es stehen eine Vielzahl von Ressourcen zur Verfügung, die das Definieren regulärer Ausdrücke erläutern, z. B. https://www.regular-expressions.info/.

Erstellen von Zuordnungsdefinitionen in AEM creating-mapping-definitions-in-aem

In einer Standardinstallation von AEM finden Sie den Ordner:

/etc/map/http

Dies ist die Struktur, die beim Definieren von Zuordnungen für das HTTP-Protokoll verwendet wird. Wenn Sie Zuordnungen für weitere Protokolle erstellen möchten, können unter /etc/map weitere Ordner (sling:Folder) erstellt werden.

Konfigurieren einer internen Umleitung an /content configuring-an-internal-redirect-to-content

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

  1. Navigieren Sie mithilfe von 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.

NOTE
Weitere Informationen zu den verfügbaren Sling-Eigenschaften und wie diese konfiguriert werden können, finden Sie in der Sling-Dokumentation unter Ressourcen
NOTE
Die Konfigurationen für die Veröffentlichungsumgebung können unter /etc/map.publish gespeichert werden. Diese müssen dann repliziert und der neue Speicherort (/etc/map.publish) muss für den Zuordnungs-Speicherort des Apache Sling Resource Resolver der Veröffentlichungsumgebung konfiguriert werden.
recommendation-more-help
6a71a83d-c2e0-4ce7-a6aa-899aa3885b56