DokumentationAEM 6.4Användarhandbok om distribution

Resursmappning resource-mapping

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

Skapat för:

  • Developer
CAUTION
AEM 6.4 har nått slutet på den utökade supporten och denna dokumentation är inte längre uppdaterad. Mer information finns i teknisk supportperiod. Hitta de versioner som stöds här.

Resursmappning används för att definiera omdirigeringar, tillfälliga URL:er och virtuella värdar för AEM.

Du kan till exempel använda dessa mappningar för:

  • Prefix för alla begäranden med /content så att den interna strukturen döljs för besökarna på webbplatsen.
  • Definiera en omdirigering så att alla förfrågningar till /content/en/gateway webbplatsen omdirigeras till https://gbiv.com/.

En möjlig HTTP-mappning prefix all requests to localhost:4503 with /content. En sådan här mappning kan användas för att dölja den interna strukturen för besökarna på webbplatsen så som den tillåter:

localhost:4503/content/geometrixx/en/products.html

ska nås med:

localhost:4503/geometrixx/en/products.html

eftersom mappningen automatiskt lägger till prefixet /content till /geometrixx/en/products.html.

CAUTION
Vanity-URL:er stöder inte regex-mönster.
NOTE
Läs Sling-dokumentationen och Mappningar för resursupplösning och Resurser för ytterligare information.

Visa mappningsdefinitioner viewing-mapping-definitions

Mappningarna består av två listor som JCR-resurslösaren utvärderar (högst upp) för att hitta en matchning.

De här listorna kan visas (tillsammans med konfigurationsinformation) under JCR ResourceResolver Valet av Felix-konsolen. till exempel https://<host>:<port>/system/console/jcrresolver:

  • Konfiguration

    Visar den aktuella konfigurationen (enligt definition för Resurslösare för Apache Sling.

  • Konfigurationstest

    På så sätt kan du ange en URL eller resurssökväg. Klicka Lös eller Karta för att bekräfta hur systemet ska omforma posten.

  • Matcha mappningsposter
    Listan över poster som används av metoderna ResourceResolver.resolve för att mappa URL:er till Resources.

  • Mappa mappningsposter
    Listan över poster som används av metoderna ResourceResolver.map för att mappa resurssökvägar till URL:er.

De två listorna visar olika poster, inklusive de som definieras som standardvärden av programmen. Dessa syftar ofta till att förenkla URL:er för användaren.

Listparet a Mönster, ett reguljärt uttryck som matchar begäran, med Ersättning som definierar den omdirigering som ska skjutas in.

Till exempel:

Mönster ^[^/]+/[^/]+/welcome$

kommer att aktivera:

Ersättning /libs/cq/core/content/welcome.html.

omdirigera en begäran:

http://localhost:4503/welcome

till:

http://localhost:4503/libs/cq/core/content/welcome.html

Nya mappningsdefinitioner skapas i databasen.

NOTE
Det finns många resurser som kan förklara hur du definierar reguljära uttryck. till exempel https://www.regular-expressions.info/.

Skapar mappningsdefinitioner i AEM creating-mapping-definitions-in-aem

I en standardinstallation av AEM finns mappen:

/etc/map/http

Detta är den struktur som används för att definiera mappningar för HTTP-protokollet. Andra mappar ( sling:Folder) kan skapas under /etc/map för andra protokoll som du vill mappa.

Konfigurera en intern omdirigering till /content configuring-an-internal-redirect-to-content

Så här skapar du en mappning som prefixar en begäran till http://localhost:4503/ med /content:

  1. Använda CRXDE navigera till /etc/map/http.

  2. Skapa en ny nod:

    • Typ sling:Mapping

      Den här nodtypen är avsedd för sådana mappningar, men det är inte obligatoriskt att använda den.

    • Namn localhost_any

  3. Klicka Spara alla.

  4. Lägg till följande egenskaper för den här noden:

    • Namn sling:match

      • Typ String
      • Värde localhost.4503/

    • Namn sling:internalRedirect

      • Typ String
      • Värde /content/

  5. Klicka Spara alla.

Detta kommer att hantera en begäran som:
localhost:4503/geometrixx/en/products.html
som if:
localhost:4503/content/geometrixx/en/products.html
hade blivit ombedd.

NOTE
Se Resurser I Sling Documentation finns mer information om vilka snedsättningsegenskaper som finns och hur de kan konfigureras.
NOTE
Du kan använda /etc/map.publish för att lagra konfigurationerna för publiceringsmiljön. Dessa måste sedan replikeras och den nya platsen ( /etc/map.publish) konfigurerad för Mappningsplats i Resurslösare för Apache Sling av publiceringsmiljön.
recommendation-more-help
6a71a83d-c2e0-4ce7-a6aa-899aa3885b56