Mappatura delle risorse

La mappatura delle risorse viene utilizzata per definire reindirizzamenti, URL personalizzati e host virtuali per l’AEM.

Ad esempio, puoi utilizzare queste mappature per:

  • Aggiungi il prefisso a tutte le richieste /content in modo che la struttura interna sia nascosta ai visitatori del sito web.
  • Definisci un reindirizzamento in modo che tutte le richieste a /content/en/gateway pagina del sito web vengono reindirizzati a https://gbiv.com/.

Un possibile prefisso di mappatura HTTP per tutte le richieste a localhost:4503 con /content. Una mappatura come questa può essere utilizzata per nascondere la struttura interna dai visitatori al sito web in quanto consente:

localhost:4503/content/we-retail/en/products.html

da accedere tramite:

localhost:4503/we-retail/en/products.html

poiché la mappatura aggiungerà automaticamente il prefisso /content a /we-retail/en/products.html.

ATTENZIONE

Gli URL personalizzati non supportano i pattern regex.

NOTA

Consulta la documentazione di Sling e Mappature per la risoluzione delle risorse e Risorse per ulteriori informazioni.

Visualizzazione delle definizioni di mappatura

Le mappature formano due elenchi che JCR Resource Resolver valuta (dall’alto verso il basso) per trovare una corrispondenza.

Questi elenchi possono essere visualizzati (insieme alle informazioni di configurazione) nella sezione ResourceResolver JCR della console Felix; ad esempio, https://<*host*>:<*port*>/system/console/jcrresolver:

  • Configurazione Mostra la configurazione corrente (come definita per Apache Sling Resource Resolver).

  • Test di configurazione Consente di immettere un URL o un percorso di risorsa. Clic Risolvi o Mappa per confermare la modalità di trasformazione della voce.

  • Voci mappa del resolver
    Elenco di voci utilizzate dai metodi ResourceResolver.resolve per mappare gli URL alle risorse.

  • Mappatura delle voci di mappa
    Elenco di voci utilizzate dai metodi ResourceResolver.map per mappare i percorsi delle risorse agli URL.

I due elenchi mostrano varie voci, comprese quelle definite come predefinite dalle applicazioni. Queste servono spesso a semplificare gli URL dell’utente.

La coppia di elenchi a Pattern, un’espressione regolare associata alla richiesta, con un Sostituto che definisce il reindirizzamento da imporre.

Ad esempio:

Pattern ^[^/]+/[^/]+/welcome$

attiverà:

Sostituto /libs/cq/core/content/welcome.html.

per reindirizzare una richiesta:

https://localhost:4503/welcome ``

a:

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

All’interno dell’archivio vengono create nuove definizioni di mappatura.

NOTA

Sono disponibili numerose risorse che spiegano come definire espressioni regolari, ad esempio https://www.regular-expressions.info/.

Creazione di definizioni di mappatura in AEM

In un’installazione standard di AEM puoi trovare la cartella:

/etc/map/http

Struttura utilizzata per definire le mappature per il protocollo HTTP. Altre cartelle ( sling:Folder) può essere creato in /etc/map per qualsiasi altro protocollo che desideri mappare.

Configurazione di un reindirizzamento interno a /content

Per creare il mapping che aggiunge il prefisso a qualsiasi richiesta a https://localhost:4503/ /content:

  1. Utilizzo di CRXDE passa a /etc/map/http.

  2. Crea un nuovo nodo:

    • Tipo sling:Mapping
      Questo tipo di nodo è destinato a tali mappature, anche se il suo utilizzo non è obbligatorio.

    • Nome localhost_any

  3. Clic Salva tutto.

  4. Aggiungi le seguenti proprietà di questo nodo:

    • Nome sling:match

      • Tipo String

      • Valore localhost.4503/

    • Nome sling:internalRedirect

      • Tipo String

      • Valore /content/

  5. Clic Salva tutto.

Questa gestirà una richiesta come:
localhost:4503/geometrixx/en/products.html
come se:
localhost:4503/content/geometrixx/en/products.html
è stato richiesto.

NOTA

Consulta Risorse nella documentazione di Sling per ulteriori informazioni sulle proprietà sling disponibili e su come configurarle.
Ad esempio: Interpolazione stringa è molto utile in quanto consente di configurare una mappatura che ottiene i valori per ambiente tramite le variabili di ambiente.

NOTA

È possibile utilizzare /etc/map.publish per mantenere le configurazioni dell’ambiente di pubblicazione. Questi devono quindi essere replicati e la nuova posizione ( /etc/map.publish) configurato per Posizione mappatura del Apache Sling Resource Resolver dell’ambiente di pubblicazione.

In questa pagina