Esternalizzazione degli URL

In AEM, il Esternalizzatore è un servizio OSGI che consente di trasformare programmaticamente un percorso di risorsa (ad es. /path/to/my/page) in un URL esterno e assoluto (ad esempio, https://www.mycompany.com/path/to/my/page) prefissando il percorso con un DNS preconfigurato.

Poiché un’istanza non può conoscere il suo URL visibile esternamente se è in esecuzione dietro un livello web e poiché a volte un collegamento deve essere creato al di fuori dell’ambito della richiesta, questo servizio fornisce una posizione centrale per configurare gli URL esterni e generarli.

Questa pagina spiega come configurare il Esternalizzatore e come usarlo. Per ulteriori informazioni, consulta la Javadocs.

Configurazione del servizio Externalizer

La Esternalizzatore il servizio ti consente di definire centralmente più domini che possono essere utilizzati per prefisso programmaticamente i percorsi delle risorse. Ogni dominio è identificato da un nome univoco utilizzato per fare riferimento programmaticamente al dominio.

Per definire una mappatura del dominio per Esternalizzatore servizio:

  1. Passa alla gestione della configurazione tramite Strumenti, quindi Console web oppure immetti:

    https://<host>:<port>/system/console/configMgr

  2. Fai clic su Day CQ Link Externalizer per aprire la finestra di dialogo di configurazione.

    NOTA

    Il collegamento diretto alla configurazione è https://<host>:<port>/system/console/configMgr/com.day.cq.commons.impl.ExternalizerImpl

    aem-externalizer-01

  3. Definire un Domini mappatura: una mappatura consiste in un nome univoco che può essere utilizzato nel codice per fare riferimento al dominio, a uno spazio e al dominio:

    <unique-name> [scheme://]server[:port][/contextpath]

    Dove:

    • schema di solito è http o https, ma può anche essere ftp, ecc.

      • utilizza https per applicare i collegamenti https, se necessario
      • viene utilizzato se il codice client non sostituisce lo schema quando si richiede l’esternalizzazione di un URL.
    • server è il nome host (può essere un nome di dominio o un indirizzo ip).

    • porta (facoltativo) è il numero di porta.

    • contextpath (facoltativo) è impostato solo se AEM è installato come applicazione web in un percorso contestuale diverso.

    Esempio: production https://my.production.instance

    I seguenti nomi di mappatura sono predefiniti e devono sempre essere impostati in base a AEM:

    • local - l'istanza locale
    • author - DNS del sistema di authoring
    • publish - DNS del sito web pubblico
    NOTA

    Una configurazione personalizzata consente di aggiungere una nuova categoria, ad esempio production, staging o anche sistemi esterni non AEM quali my-internal-webservice. È utile evitare di codificare tali URL in posizioni diverse della codebase di un progetto.

  4. Fai clic su Salva per salvare le modifiche.

NOTA

Utilizzo del servizio Externalizer

Questa sezione mostra alcuni esempi di come Esternalizzatore è possibile utilizzare il servizio:

  1. Per ottenere il servizio Externalizer in un JSP:

    Externalizer externalizer = resourceResolver.adaptTo(Externalizer.class);
    
  2. Per esternalizzare un percorso con il dominio "pubblica":

    String myExternalizedUrl = externalizer.publishLink(resolver, "/my/page") + ".html";
    

    Supponendo la mappatura del dominio:

    • publish https://www.website.com

    myExternalizedUrl termina con il valore:

    • https://www.website.com/contextpath/my/page.html
  3. Per esternalizzare un percorso con il dominio "author":

    String myExternalizedUrl = externalizer.authorLink(resolver, "/my/page") + ".html";
    

    Supponendo la mappatura del dominio:

    • author https://author.website.com

    myExternalizedUrl termina con il valore:

    • https://author.website.com/contextpath/my/page.html
  4. Per esternalizzare un percorso con il dominio "locale":

    String myExternalizedUrl = externalizer.externalLink(resolver, Externalizer.LOCAL, "/my/page") + ".html";
    

    Supponendo la mappatura del dominio:

    • local https://publish-3.internal

    myExternalizedUrl termina con il valore:

    • https://publish-3.internal/contextpath/my/page.html
  5. Puoi trovare ulteriori esempi nella sezione Javadocs.

In questa pagina