DocumentaçãoAEM 6.4Guia de implementação

Mapeamento de recursos resource-mapping

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

Criado para:

  • Developer
CAUTION
AEM 6.4 chegou ao fim do suporte estendido e esta documentação não é mais atualizada. Para obter mais detalhes, consulte nossa períodos de assistência técnica. Encontre as versões compatíveis here.

O mapeamento de recursos é usado para definir redirecionamentos, URLs personalizadas e hosts virtuais para AEM.

Por exemplo, você pode usar esses mapeamentos para:

  • Prefixar todas as solicitações com /content para que a estrutura interna fique oculta dos visitantes do seu site.
  • Defina um redirecionamento para que todas as solicitações da variável /content/en/gateway página do seu site são redirecionadas para https://gbiv.com/.

Um mapeamento HTTP possível prefixos todas as solicitações para localhost:4503 com /content. Um mapeamento como esse pode ser usado para ocultar a estrutura interna dos visitantes do site, conforme permite:

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

a ser acessado usando:

localhost:4503/geometrixx/en/products.html

como o mapeamento adicionará automaticamente o prefixo /content para /geometrixx/en/products.html.

CAUTION
URLs personalizadas não suportam padrões regex.
NOTE
Consulte a documentação do Sling e Mapeamentos para Resolução de Recursos e Recursos para obter mais informações.

Exibindo Definições de Mapeamento viewing-mapping-definitions

Os mapeamentos de duas listas que o Resolvedor de Recursos do JCR avalia (de cima para baixo) para encontrar uma correspondência.

Essas listas podem ser visualizadas (junto com informações de configuração) no JCR ResourceResolver opção do console Felix; por exemplo, https://<host>:<port>/system/console/jcrresolver:

  • Configuração

    Mostra a configuração atual (conforme definido para a variável Resolvedor de Recursos do Apache Sling.

  • Teste de configuração

    Isso permite inserir um URL ou caminho de recurso. Clique em Resolver ou Mapa para confirmar como o sistema transformará a entrada.

  • Entradas do Mapa do Resolvedor
    A lista de entradas usadas pelos métodos ResourceResolver.resolve para mapear URLs para Recursos.

  • Mapeamento de entradas do mapa
    A lista de entradas usadas pelos métodos ResourceResolver.map para mapear Caminhos de Recursos para URLs.

As duas listas mostram várias entradas, incluindo as definidas como padrões pelo(s) aplicativo(s). Geralmente, o objetivo é simplificar os URLs para o usuário.

As listas emparelham um Padrão, uma expressão regular correspondente à solicitação, com um Substituição que define o redirecionamento a ser imposto.

Por exemplo, o:

Padrão ^[^/]+/[^/]+/welcome$

acionará o:

Substituição /libs/cq/core/content/welcome.html.

para redirecionar uma solicitação:

http://localhost:4503/welcome

para:

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

Novas definições de mapeamento são criadas no repositório.

NOTE
Há muitos recursos disponíveis que ajudam a explicar como definir expressões regulares; por exemplo https://www.regular-expressions.info/.

Criando definições de mapeamento no AEM creating-mapping-definitions-in-aem

Em uma instalação padrão de AEM, você pode encontrar a pasta:

/etc/map/http

Essa é a estrutura usada ao definir mapeamentos para o protocolo HTTP. Outras pastas ( sling:Folder) pode ser criada em /etc/map para quaisquer outros protocolos que você queira mapear.

Configurar um redirecionamento interno para /content configuring-an-internal-redirect-to-content

Para criar o mapeamento que prefixa qualquer solicitação para http://localhost:4503/ com /content:

  1. Usando o CRXDE, navegue até /etc/map/http.

  2. Crie um novo nó:

    • Tipo sling:Mapping

      Esse tipo de nó é destinado a esses mapeamentos, embora seu uso não seja obrigatório.

    • Nome localhost_any

  3. Clique em Salvar tudo.

  4. Adicionar as seguintes propriedades desse nó:

    • Nome sling:match

      • Tipo String
      • Valor localhost.4503/

    • Nome sling:internalRedirect

      • Tipo String
      • Valor /content/

  5. Clique em Salvar tudo.

Isso lidará com uma solicitação como:
localhost:4503/geometrixx/en/products.html
como se:
localhost:4503/content/geometrixx/en/products.html
tinham sido solicitados.

NOTE
Consulte Recursos na Documentação do Sling para obter mais informações sobre as propriedades do sling disponíveis e como elas podem ser configuradas.
NOTE
Você pode usar /etc/map.publish para manter as configurações do ambiente de publicação. Eles devem então ser replicados e o novo local ( /etc/map.publish) configurado para o Localização do mapeamento do Resolvedor de Recursos do Apache Sling do ambiente de publicação.
recommendation-more-help
6a71a83d-c2e0-4ce7-a6aa-899aa3885b56