Mappage de ressource resource-mapping
Le mappage de ressources permet de définir des redirections, des URL de redirection et des hôtes virtuels pour AEM.
Par exemple, vous pouvez utiliser ces mappages pour :
- faire précéder toutes les requêtes de
/contentafin que la structure interne soit masquée pour les visiteurs de votre site web ; - définir une redirection afin que toutes les requêtes en direction de la page
/content/en/gatewayde votre site Web soient redirigées vershttps://gbiv.com/.
Un mappage HTTP possible consiste à préfixer toutes les demandes à localhost:4503 avec le répertoire /content. Un mappage de ce type peut être utilisé pour masquer la structure interne vis-à-vis des visiteurs du site web, car il rend :
localhost:4503/content/we-retail/en/products.html
Être accessible à l’aide de :
localhost:4503/we-retail/en/products.html
En effet, le mappage ajoute automatiquement le préfixe /content à /we-retail/en/products.html.
Affichage des définitions de mappage viewing-mapping-definitions
Les mappages forment deux listes que le résolveur de ressources JCR évalue (de haut en bas) pour trouver une correspondance.
Ces listes peuvent être visualisées (ainsi que des informations de configuration) sous l’option JCR ResourceResolver de la console Felix ; par exemple, https://<*host*>:<*port*>/system/console/jcrresolver :
-
Configuration indique la configuration actuelle (telle que définie pour le résolveur de ressource Apache Sling).
-
Test de configuration
Cela permet de saisir une URL ou un chemin d’accès vers la ressource. Cliquez sur Résoudre ou Mapper pour confirmer la façon dont le système transforme l’entrée. -
Resolver Map Entries (Entrées de mappage du résolveur) La liste des entrées utilisées par les méthodes ResourceResolver.resolve pour mapper les URL aux ressources.
-
Mapping Map Entries (Entrées de mappage) La liste des entrées utilisées par les méthodes ResourceResolver.map pour mapper les chemins d’accès des ressources aux URL.
Les deux listes affichent différentes entrées, y compris celles définies par défaut par les applications. Ces entrées visent souvent à simplifier les URL pour la personne qui les utilise.
Les listes associent un Modèle, une expression régulière associée à la requête, à un Remplacement qui définit la redirection à imposer.
Par exemple, le :
Modèle ^[^/]+/[^/]+/welcome$
Déclenche le :
Remplacement /libs/cq/core/content/welcome.html.
Pour rediriger une requête :
https://localhost:4503/welcome ``
Pour :
https://localhost:4503/libs/cq/core/content/welcome.html
De nouvelles définitions de mappage sont créées dans le référentiel.
Création de définitions de mappage dans AEM creating-mapping-definitions-in-aem
L’installation standard d’AEM contient le dossier suivant :
/etc/map/http
Ce dossier correspond à la structure utilisée lors de la définition des mappages pour le protocole HTTP. D’autres dossiers (sling:Folder) peuvent être créés sous /etc/map pour tout autre protocole que vous souhaitez mapper.
Configuration d’une redirection interne vers /content configuring-an-internal-redirect-to-content
Pour créer le mappage qui préfixe toute demande de https://localhost:4503/ avec /content :
-
À l’aide de CRXDE, accédez à
/etc/map/http. -
Créez un nœud :
-
Type
sling:Mappingce type de nœud est conçu pour de tels mappages, même si son utilisation n’est pas obligatoire. -
Nom
localhost_any
-
-
Cliquez sur Enregistrer tout.
-
Ajoutez les propriétés suivantes à ce nœud :
-
Nom
sling:match-
Type
String -
Valeur
localhost.4503/
-
-
Nom
sling:internalRedirect-
Type
String -
Valeur
/content/
-
-
-
Cliquez sur Enregistrer tout.
Ce mappage gère une requête telle que :localhost:4503/geometrixx/en/products.html
comme si :localhost:4503/content/geometrixx/en/products.html
était demandé.
Par exemple, l’interpolation de chaîne est utile, car elle permet de configurer un mappage qui récupère des valeurs par environnement via les variables d’environnement.
/etc/map.publish pour conserver les configurations dans l’environnement de publication. Elles doivent ensuite être dupliquées, et le nouvel emplacement (/etc/map.publish) doit être configuré pour l’emplacement du mappage du résolveur de ressources Apache Sling de l’environnement de publication.