Dokumentation AEM Användarhandbok om Dispatcher

Använda Dispatcher med flera domäner

28 februari 2025

Ämnen:
Dispatcher

Skapat för:

Administratör

NOTE

Dispatcher-versionerna är oberoende av AEM. Du kan ha omdirigerats till den här sidan om du har följt en länk till Dispatcher-dokumentationen som är inbäddad i AEM- eller CQ-dokumentationen.

Använd Dispatcher för att bearbeta sidförfrågningar i flera webbdomäner samtidigt som följande villkor stöds:

Webbinnehåll för båda domänerna lagras i en enda AEM-databas.
Filerna i Dispatcher-cachen kan göras ogiltiga separat för varje domän.

Ett företag publicerar till exempel webbplatser för två av sina varumärken: Varumärke A och Varumärke B. Innehållet för webbplatssidorna skapas i AEM och lagras på samma databasarbetsyta:

/
| - content
   | - sitea
       | - content nodes
   | - siteb
       | - content nodes

Sidor för BrandA.com lagras under /content/sitea. Klientförfrågningar för URL:en https://BrandA.com/en.html returneras till den återgivna sidan för noden /content/sitea/en. På samma sätt lagras sidor för BrandB.com under /content/siteb.

När du använder Dispatcher för att cachelagra innehåll skapar du associationer mellan sidans URL i klientens HTTP-begäran, sökvägen till motsvarande cachelagrade fil och sökvägen till motsvarande fil i databasen.

Klientförfrågningar

När klienterna skickar HTTP-begäranden till webbservern måste URL:en för den begärda sidan matchas mot innehållet i Dispatcher-cachen och slutligen mot innehållet i databasen.

Domännamnssystemet upptäcker IP-adressen till webbservern som är registrerad för domännamnet i HTTP-begäran.
HTTP-begäran skickas till webbservern.
HTTP-begäran skickas till Dispatcher.
Dispatcher avgör om de cachelagrade filerna är giltiga. Om det är giltigt skickas de cachelagrade filerna till klienten.
Om cachelagrade filer inte är giltiga begär Dispatcher nyligen återgivna sidor från AEM publiceringsinstans.

Cacheinvalidering

När replikeringsagenter för Dispatcher Flush begär att Dispatcher ogiltigförklarar cachelagrade filer, måste sökvägen till innehållet i databasen matchas mot innehållet i cachen.

a - En sida aktiveras på AEM författarinstans och innehållet replikeras till publiceringsinstansen.
b - Dispatcher Flush Agent anropar Dispatcher för att ogiltigförklara cachen för det replikerade innehållet.
c - Dispatcher vidrör en eller flera .stat-filer för att göra de cachelagrade filerna ogiltiga.

Om du vill använda Dispatcher med flera domäner måste du konfigurera AEM, Dispatcher och webbservern. Lösningarna som beskrivs på den här sidan är allmänna och gäller de flesta miljöer. På grund av komplexiteten i vissa AEM-topologier kan din lösning kräva ytterligare anpassade konfigurationer för att lösa vissa problem. Du måste antagligen anpassa exemplen för att uppfylla din befintliga IT-infrastruktur och hanteringspolicy.

URL-mappning

Om du vill att domän-URL:er och innehållssökvägar ska kunna matcha till cachelagrade filer, måste en filsökväg eller en sid-URL översättas under processen. Beskrivningar av följande gemensamma strategier tillhandahålls, där översättning av sökväg eller URL sker vid olika tidpunkter i processen:

(Rekommenderas) AEM publiceringsinstans använder Sling-mappning för resursupplösning för att implementera interna regler för URL-omskrivning. Domän-URL:er översätts till sökvägar i innehållsdatabasen. Se Inkommande URL:er skrivs om i AEM.
Webbservern använder interna URL-omskrivningsregler som översätter domän-URL:er till cachelagrade sökvägar. Se Inkommande URL:er skrivs om på webbservern.

Du bör använda korta URL-adresser för webbsidor. Vanligtvis speglar sid-URL:er strukturen för databasmapparna som innehåller webbinnehållet. URL-adresserna visar dock inte de översta databasnoderna, till exempel /content. Klienten är inte nödvändigtvis medveten om strukturen i AEM-databasen.

Allmänna krav

Din miljö måste implementera följande konfigurationer för att stödja Dispatcher som arbetar med flera domäner:

Innehåll för varje domän finns i olika grenar av databasen (se exempelmiljön nedan).
Replikeringsagenten Dispatcher Flush är konfigurerad på AEM publiceringsinstans. (Se Invaliderar Dispatcher-cache från en publiceringsinstans.)
Domännamnssystemet tolkar domännamnen med webbserverns IP-adress.
Dispatcher-cachen speglar katalogstrukturen i AEM innehållslager. Filsökvägarna under webbserverns dokumentrot är samma som sökvägarna till filerna i databasen.

Miljö för de angivna exemplen

De exempellösningar som finns gäller för en miljö med följande egenskaper:

Skribenten och publiceringsinstanserna för AEM körs i Linux®-system.
Apache HTTPD är den webbserver som används i ett Linux®-system.
AEM innehållsdatabas och dokumentroten för webbservern använder följande filstrukturer (dokumentroten för Apache-webbservern är /usr/lib/apache/httpd-2.4.3/htdocs):

Databas

  | - /content
    | - sitea
  |    | - content nodes
    | - siteb
       | - content nodes

Webbserverns dokumentrot

  | - /usr
    | - lib
      | - apache
        | - httpd-2.4.3
          | - htdocs
            | - content
              | - sitea
                 | - content nodes
              | - siteb
                 | - content nodes

Inkommande URL-adresser skrivs om i AEM

Genom att avbilda resursmatchningar kan du koppla inkommande URL:er till AEM innehållssökvägar. Skapa mappningar på AEM publiceringsinstans så att återgivningsbegäranden från Dispatcher kan matchas med rätt innehåll i databasen.

Dispatcher-begäranden om sidåtergivning identifierar sidan med den URL som den skickas från webbservern. När URL:en innehåller ett domännamn tolkas URL:en till innehållet med Sling-mappningar. Följande bild visar en mappning av URL:en branda.com/en.html till noden /content/sitea/en.

Dispatcher-cachen speglar databasens nodstruktur. När sidaktiveringar utförs kräver därför de resulterande förfrågningarna om att den cachelagrade sidan ska bli ogiltig inga URL- eller sökvägsöversättningar.

Definiera virtuella värdar på webbservern

Definiera virtuella värdar på webbservern så att olika dokumentrotvärden kan tilldelas till varje webbdomän:

Webbservern måste definiera en virtuell domän för var och en av dina webbdomäner.
För varje domän konfigurerar du dokumentroten så att den sammanfaller med mappen i databasen som innehåller domänens webbinnehåll.
Varje virtuell domän måste även innehålla Dispatcher-relaterade konfigurationer, enligt beskrivningen på sidan Installera Dispatcher.

I följande exempel httpd.conf konfigureras två virtuella domäner för en Apache-webbserver:

Servernamnen (som sammanfaller med domännamnen) är branda.com (rad 16) och brandb.com (rad 30).
Dokumentroten för varje virtuell domän är den katalog i Dispatcher-cachen som innehåller platsens sidor. (raderna 17 och 31)

Med den här konfigurationen utför webbservern följande åtgärder när den tar emot en begäran om https://branda.com/en/products.html:

Associerar URL:en med det virtuella värdsystemet som har ServerName av branda.com.
Vidarebefordrar URL:en till Dispatcher.

httpd.conf

# load the Dispatcher module
LoadModule dispatcher_module modules/mod_dispatcher.so
# configure the Dispatcher module
<IfModule disp_apache2.c>
 DispatcherConfig conf/dispatcher.any
 DispatcherLog    logs/dispatcher.log
 DispatcherLogLevel 3
 DispatcherNoServerHeader 0
 DispatcherDeclineRoot 0
 DispatcherUseProcessedURL 0
 DispatcherPassError 0
</IfModule>

# Define virtual host for brandA.com
<VirtualHost *:80>
  ServerName branda.com
  DocumentRoot /usr/lib/apache/httpd-2.4.3/htdocs/content/sitea
   <Directory /usr/lib/apache/httpd-2.4.3/htdocs/content/sitea>
     <IfModule disp_apache2.c>
       SetHandler dispatcher-handler
       ModMimeUsePathInfo On
     </IfModule>
     Options FollowSymLinks
     AllowOverride None
   </Directory>
</VirtualHost>

# define virtual host for brandB.com
<VirtualHost *:80>
  ServerName brandB.com
  DocumentRoot /usr/lib/apache/httpd-2.4.3/htdocs/content/siteb
   <Directory /usr/lib/apache/httpd-2.4.3/htdocs/content/siteb>
     <IfModule disp_apache2.c>
       SetHandler dispatcher-handler
       ModMimeUsePathInfo On
     </IfModule>
     Options FollowSymLinks
     AllowOverride None
   </Directory>
</VirtualHost>

# document root for web server
DocumentRoot "/usr/lib/apache/httpd-2.4.3/htdocs"

Virtuella värdar ärver egenskapsvärdet DispatcherConfig som har konfigurerats i huvudserveravsnittet. Virtuella värdar kan inkludera sin egen DispatcherConfig-egenskap för att åsidosätta huvudserverkonfigurationen.

NOTE

I AEM as a Cloud Service måste en separat värdkonfiguration användas med en DocumentRoot på en högre nivå än var och en av undersidorna. Detta hanteras som standard i arkivtypen, men när flera DocumentRoots används måste en högre prioritetsvärdkonfiguration användas så att cacheogiltigförklaringen kan hanteras för hela cachen eftersom den inte kan konfigureras separat för varje plats. ServerAlias för den här nya konfigurationen måste acceptera värdhuvudet "localhost".

Konfigurera Dispatcher för hantering av flera domäner

Ange följande Dispatcher-grupper om du vill ha stöd för URL:er som innehåller domännamn och motsvarande virtuella värdar:

Konfigurera en Dispatcher-servergrupp för varje virtuellt värdsystem. Dessa grupper bearbetar begäranden från webbservern för varje domän, söker efter cachelagrade filer och begär sidor från återgivningarna.
Konfigurera en Dispatcher-servergrupp som används för att göra innehåll i cachen ogiltigt, oavsett vilken domän innehållet tillhör. Den här servergruppen hanterar begäranden om filogiltigförklaring från Dispatcher-replikeringsagenter som tömts.

Skapa Dispatcher-servergrupper för virtuella värdar

Servergrupper för virtuella värdar måste ha följande konfigurationer så att URL:erna i klientens HTTP-begäranden tolkas till rätt filer i Dispatcher-cachen:

Egenskapen /virtualhosts är inställd på domännamnet. Med den här egenskapen kan Dispatcher associera servergruppen med domänen.
Egenskapen /filter ger åtkomst till sökvägen till begärande-URL:en som trunkerats efter domännamnsdelen. För URL:en https://branda.com/en.html tolkas sökvägen som /en.html, så filtret måste tillåta åtkomst till den här sökvägen.
Egenskapen /docroot är inställd på sökvägen till rotkatalogen. Det vill säga rotkatalogen för domänens webbplatsinnehåll i Dispatcher-cachen. Den här sökvägen används som prefix för den sammanfogade URL:en från den ursprungliga begäran. Dokumentet för /usr/lib/apache/httpd-2.4.3/htdocs/sitea orsakar till exempel att begäran för https://branda.com/en.html tolkas till filen /usr/lib/apache/httpd-2.4.3/htdocs/sitea/en.html.

Dessutom måste publiceringsinstansen för AEM anges som rendering för det virtuella värdsystemet. Konfigurera andra servergruppsegenskaper efter behov. Följande kod är en förkortad servergruppskonfiguration för domänen branda.com:

/farm_sitea  {
    ...
    /virtualhosts { "branda.com" }
    /renders {
      /rend01  { /hostname "127.0.0.1"  /port "4503" }
    }
    /filter {
      /0001 { /type "deny"  /glob "*" }
      /0023 { /type "allow" /glob "*/en*" }
      ...
     }
    /cache {
      /docroot "/usr/lib/apache/httpd-2.4.3/htdocs/content/sitea"
      ...
   }
   ...
}

Skapa en Dispatcher-servergrupp för cacheogiltigförklaring

En Dispatcher-servergrupp krävs för att hantera begäranden om att göra cachelagrade filer ogiltiga. Den här servergruppen måste kunna komma åt .stat-filer i docroot-katalogerna för varje virtuellt värdsystem.

Följande egenskapskonfigurationer gör att Dispatcher kan matcha filer i AEM innehållsdatabas från filer i cachen:

Egenskapen /docroot är inställd på webbserverns standardvärde docroot. Vanligtvis är /docroot den katalog där mappen /content skapas. Ett exempelvärde för Apache i Linux® är /usr/lib/apache/httpd-2.4.3/htdocs.
Egenskapen /filter ger åtkomst till filer under katalogen /content.

Egenskapen /statfileslevel måste vara tillräckligt hög för att .stat-filer ska skapas i rotkatalogen för varje virtuellt värdsystem. Den här egenskapen gör att cacheminnet för varje domän kan ogiltigförklaras separat. I exempelkonfigurationen skapar /statfileslevel-värdet 2 .stat-filer i katalogen *docroot*/content/sitea och katalogen *docroot*/content/siteb.

Publiceringsinstansen måste också anges som rendering för det virtuella värdsystemet. Konfigurera andra servergruppsegenskaper efter behov. Följande kod är en förkortad konfiguration för servergruppen som används för att göra cacheminnet ogiltigt:

/farm_flush {
    ...
    /virtualhosts   { "invalidation_only" }
    /renders  {
      /rend01  { /hostname "127.0.0.1" /port "4503" }
    }
    /filter   {
      /0001 { /type "deny"  /glob "*" }
      /0023 { /type "allow" /glob "*/content*" }
      ...
      }
    /cache  {
       /docroot "/usr/lib/apache/httpd-2.4.3/htdocs"
       /statfileslevel "2"
       ...
   }
   ...
}

När du startar webbservern visar Dispatcher-loggen (i felsökningsläge) initieringen av alla servergrupper:

Dispatcher initializing (build 4.1.2)
[Fri Nov 02 16:27:18 2012] [D] [24974(140006182991616)] farms[farm_sitea].cache.docroot = /usr/lib/apache/httpd-2.4.3/htdocs/content/sitea
[Fri Nov 02 16:27:18 2012] [D] [24974(140006182991616)] farms[farm_siteb].cache.docroot = /usr/lib/apache/httpd-2.4.3/htdocs/content/siteb
[Fri Nov 02 16:27:18 2012] [D] [24974(140006182991616)] farms[farm_flush].cache.docroot = /usr/lib/apache/httpd-2.4.3/htdocs
[Fri Nov 02 16:27:18 2012] [I] [24974(140006182991616)] Dispatcher initialized (build 4.1.2)

Konfigurera delningskarta för resursupplösning

Använd Sling-mappning för resursupplösning så att domänbaserade URL:er kan matcha innehåll i AEM publiceringsinstans. Resursmappningen översätter inkommande URL:er från Dispatcher (ursprungligen från klientens HTTP-begäranden) till innehållsnoder.

Mer information om Sling-resursmappning finns i Mappningar för resursupplösning i Sling-dokumentationen.

Mappningar krävs vanligtvis för följande resurser, men andra mappningar kan vara nödvändiga:

Innehållssidans rotnod (under /content)
Den designnod som sidorna använder (under /etc/designs)
Mappen /libs

När du har skapat mappningen för innehållssidan använder du en webbläsare för att öppna en sida på webbservern för att identifiera fler obligatoriska mappningar. Leta reda på meddelanden om resurser som inte hittas i filen error.log för publiceringsinstansen. I följande exempelmeddelande anges att en mappning för /etc/clientlibs krävs:

01.11.2012 15:59:24.601 *INFO* [10.36.34.243 [1351799964599] GET /etc/clientlibs/foundation/jquery.js HTTP/1.1] org.apache.sling.engine.impl.SlingRequestProcessorImpl service: Resource /content/sitea/etc/clientlibs/foundation/jquery.js not found

NOTE

Länkkontrolleraromformaren för standardomskrivaren för Apache Sling ändrar automatiskt hyperlänkar på sidan för att förhindra brutna länkar. Länkskrivningen utförs dock endast när länkmålet är en HTML- eller HTML-fil. Om du vill uppdatera länkar till andra filtyper skapar du en transformerarkomponent och lägger till den i en pipeline för HTML-omskrivare.

Exempel på noder för resursmappning

I följande tabell visas de noder som implementerar resursmappning för domänen branda.com. Liknande noder skapas för domänen brandb.com, till exempel /etc/map/http/brandb.com. I samtliga fall krävs mappningar när referenser på HTML-sidan inte tolkas korrekt i Sling-sammanhanget.

Nodsökväg

Typ

Egenskap

/etc/map/http/branda.com

sling:Mapping

Name: sling:internalRedirect Type: String Value: /content/sitea

/etc/map/http/branda.com/libs

sling:Mapping

Name: sling:internalRedirect Type: String Value: /libs

/etc/map/http/branda.com/etc

sling:Mapping

/etc/map/http/branda.com/etc/designs

sling:Mapping

Name: sling:internalRedirect VType: String VValue: /etc/designs

/etc/map/http/branda.com/etc/clientlibs

sling:Mapping

Name: sling:internalRedirect VType: String VValue: /etc/clientlibs

Konfigurera Dispatcher Flush-replikeringsagenten

Replikeringsagenten Dispatcher Flush på AEM publiceringsinstans måste skicka ogiltigförklaringsbegäranden till rätt Dispatcher-servergrupp. Om du vill använda en servergrupp som mål använder du egenskapen URI för replikeringsagenten Dispatcher Flush (på fliken Transport). Inkludera värdet för egenskapen /virtualhost för Dispatcher-servergruppen som har konfigurerats för att göra cachen ogiltig:

https://*webserver_name*:*port*/*virtual_host*/dispatcher/invalidate.cache

Om du till exempel vill använda servergruppen farm_flush i föregående exempel är URI:n https://localhost:80/invalidation_only/dispatcher/invalidate.cache.

Inkommande URL:er skrivs om på webbservern

Om du vill översätta domänbaserade URL:er till filsökvägar i Dispatcher-cachen använder du webbserverns interna URL-omskrivningsfunktion. Klientförfrågningar för sidan https://brandA.com/en.html översätts till exempel till filen content/sitea/en.html i webbserverns dokumentrot.

Dispatcher-cachen speglar databasens nodstruktur. När sidaktiveringar utförs kräver därför de resulterande förfrågningarna om att den cachelagrade sidan ska bli ogiltig inga URL- eller sökvägsöversättningar.

Definiera virtuella värdar och skriv om regler på webbservern

Konfigurera följande aspekter på webbservern:

Definiera ett virtuellt värdsystem för varje webbdomän.
För varje domän konfigurerar du dokumentroten så att den sammanfaller med mappen i databasen som innehåller domänens webbinnehåll.
För varje virtuell domän skapar du en regel för URL-namnändring som översätter den inkommande URL:en till sökvägen till den cachelagrade filen.
Varje virtuell domän måste även innehålla Dispatcher-relaterade konfigurationer, enligt beskrivningen på sidan Installera Dispatcher.
Dispatcher-modulen måste vara konfigurerad att använda den URL som webbservern har skrivit om. (Se egenskapen DispatcherUseProcessedURL i Installera Dispatcher.)

I följande exempel konfigureras två virtuella värdar för en Apache-webbserver med filen httpd.conf:

Servernamnen (som sammanfaller med domännamnen) är brandA.com (rad 16) och brandB.com (rad 32).
Dokumentroten för varje virtuell domän är den katalog i Dispatcher-cachen som innehåller platsens sidor. (Raderna 20 och 33)
URL-omskrivningsregeln för varje virtuell domän är ett reguljärt uttryck. Det reguljära uttrycket prefixerar sökvägen till den begärda sidan. Den prefixeras med sökvägen till sidorna i cachen. (Raderna 19 och 35)
Egenskapen DispatcherUseProcessedURL är 1. (Rad 10)

Webbservern utför till exempel följande åtgärder när den tar emot en begäran med URL:en https://brandA.com/en/products.html:

Associerar URL:en med det virtuella värdsystemet som har ServerName av brandA.com.
Skriver om URL:en till /content/sitea/en/products.html.
Vidarebefordrar URL:en till Dispatcher.

httpd.conf

# load the Dispatcher module
LoadModule dispatcher_module modules/mod_dispatcher.so
# configure the Dispatcher module
<IfModule disp_apache2.c>
 DispatcherConfig conf/dispatcher.any
 DispatcherLog    logs/dispatcher.log
 DispatcherLogLevel 3
 DispatcherNoServerHeader 0
 DispatcherDeclineRoot 0
 DispatcherUseProcessedURL 1
 DispatcherPassError 0
</IfModule>

# Define virtual host for brandA.com
<VirtualHost *:80>
  ServerName branda.com
  DocumentRoot /usr/lib/apache/httpd-2.4.3/htdocs/content/sitea
  RewriteEngine  on
  RewriteRule    ^/(.*)\.html$  /content/sitea/$1.html [PT]
   <Directory /usr/lib/apache/httpd-2.4.3/htdocs/content/sitea>
     <IfModule disp_apache2.c>
       SetHandler dispatcher-handler
       ModMimeUsePathInfo On
     </IfModule>
     Options FollowSymLinks
     AllowOverride None
   </Directory>
</VirtualHost>

# define virtual host for brandB.com
<VirtualHost *:80>
  ServerName brandB.com
  DocumentRoot /usr/lib/apache/httpd-2.4.3/htdocs/content/siteb
  RewriteEngine  on
  RewriteRule    ^/(.*)\.html$  /content/siteb/$1.html [PT]
   <Directory /usr/lib/apache/httpd-2.4.3/htdocs/content/siteb>
     <IfModule disp_apache2.c>
       SetHandler dispatcher-handler
       ModMimeUsePathInfo On
     </IfModule>
     Options FollowSymLinks
     AllowOverride None
   </Directory>
</VirtualHost>

# document root for web server
DocumentRoot "/usr/lib/apache/httpd-2.4.3/htdocs"

Konfigurera en Dispatcher-servergrupp

När webbservern skriver om URL:er kräver Dispatcher en enda servergrupp som definierats enligt Konfigurera Dispatcher. Följande konfigurationer krävs för stöd av virtuella värddatorer på webbservern och regler för namnbyte av URL:

Egenskapen /virtualhosts måste innehålla ServerName-värden för alla VirtualHost-definitioner.
Egenskapen /statfileslevel måste vara tillräckligt hög för att .stat-filer ska kunna skapas i katalogerna som innehåller innehållsfilerna för varje domän.

Följande exempelkonfigurationsfil baseras på exempelfilen dispatcher.any som installeras med Dispatcher. Följande ändringar krävs för att ge stöd åt webbserverkonfigurationerna för den tidigare httpd.conf-filen:

Egenskapen /virtualhosts gör att Dispatcher hanterar begäranden för domänerna brandA.com och brandB.com. (Rad 12)
Egenskapen /statfileslevel är inställd på 2, så att lägesfiler skapas i varje katalog som innehåller domänens webbinnehåll (rad 41): /statfileslevel "2"

Som vanligt är dokumentroten i cachen densamma som dokumentroten på webbservern (rad 40): /usr/lib/apache/httpd-2.4.3/htdocs

`dispatcher.any`

/name "testDispatcher"
/farms
  {
  /dispfarm0
    {
    /clientheaders
      {
      "*"
      }
    /virtualhosts
      {
      "brandA.com" "brandB.com"
      }
    /renders
      {
      /rend01    {  /hostname "127.0.0.1"   /port "4503"  }
      }
    /filter
      {
      /0001 { /type "deny"  /glob "*" }
      /0023 { /type "allow" /glob "*/content*" }  # disable this rule to allow mapped content only
      /0041 { /type "allow" /glob "* *.css *"   }  # enable css
      /0042 { /type "allow" /glob "* *.gif *"   }  # enable gifs
      /0043 { /type "allow" /glob "* *.ico *"   }  # enable icos
      /0044 { /type "allow" /glob "* *.js *"    }  # enable javascript
      /0045 { /type "allow" /glob "* *.png *"   }  # enable png
      /0046 { /type "allow" /glob "* *.swf *"   }  # enable flash
      /0061 { /type "allow" /glob "POST /content/[.]*.form.html" }  # allow POSTs to form selectors under content
      /0062 { /type "allow" /glob "* /libs/cq/personalization/*"  }  # enable personalization
      /0081 { /type "deny"  /glob "GET *.infinity.json*" }
      /0082 { /type "deny"  /glob "GET *.tidy.json*"     }
      /0083 { /type "deny"  /glob "GET *.sysview.xml*"   }
      /0084 { /type "deny"  /glob "GET *.docview.json*"  }
      /0085 { /type "deny"  /glob "GET *.docview.xml*"  }
      /0086 { /type "deny"  /glob "GET *.*[0-9].json*" }
      /0090 { /type "deny"  /glob "* *.query.json*" }
      }
    /cache
      {
      /docroot "/usr/lib/apache/httpd-2.4.3/htdocs"
      /statfileslevel "2"
      /allowAuthorized "0"
      /rules
        {
        /0000  { /glob "*"     /type "allow"  }
        }
      /invalidate
        {
        /0000  {   /glob "*" /type "deny"  }
        /0001 {  /glob "*.html" /type "allow"  }
        }
      /allowedClients
        {
        }
      }
    /statistics
      {
      /categories
        {
        /html  { /glob "*.html" }
        /others  {  /glob "*"  }
        }
      }
    }
  }

NOTE

Eftersom en enda Dispatcher-servergrupp är definierad behöver Dispatcher Flush-replikeringsagenten på AEM publiceringsinstans inga särskilda konfigurationer.

Skriva om länkar till filer som inte är från HTML

Om du vill skriva om referenser till filer som har andra tillägg än .html eller .htm skapar du en Sling-omskrivartransformeringskomponent och lägger till den i standardförskrivningsflödet.

Skriv om referenser när resurssökvägar inte löses korrekt i webbserverkontexten. En omformare krävs till exempel när bildgenererande komponenter skapar länkar som /content/sitea/en/products.navimage.png. Komponenten topnav i Så här skapar du en webbplats med alla funktioner.

Omskrivningsmodulenär en modul som efterbearbetar Sling-utdata. implementeringar av rewriter-pipeline består av en generator, en eller flera transformatorer och en serialiserare:

Generator: Tolkar Sling-utdataströmmen (HTML-dokument) och genererar SAX-händelser när specifika elementtyper påträffas.
Transformator: Lyssnar efter SAX-händelser och ändrar därför händelsemålet (ett HTML-element). En omskrivarpipeline innehåller noll eller flera omformare. Transformers körs i sekvens och skickar SAX-händelserna till nästa transformator i sekvensen.
Serialisering: Serialiserar utdata, inklusive ändringar från varje transformator.

AEM förinställda skrivarpipeline

AEM använder en standardomskrivare för pipeline som bearbetar dokument av typen text/html:

Generatorn tolkar HTML-dokument och genererar SAX-händelser när den stöter på elementen a, img, area, form, base, link, script och body. Generatoralias är htmlparser.
Pipelinen innehåller följande transformatorer: linkchecker, mobile, mobiledebug, contentsync. Transformeraren linkchecker externaliserar sökvägar till refererade HTML- eller HTML-filer för att förhindra brutna länkar.
Serialiseraren skriver HTML-utdata. Serialiaset är htmlwriter.

Noden /libs/cq/config/rewriter/default definierar pipelinen.

Skapa en omformare

Så här skapar du en transformatorkomponent och använder den i en pipeline:

Implementera gränssnittet org.apache.sling.rewriter.TransformerFactory. Den här klassen skapar instanser av klassen Transformer. Ange värden för egenskapen transformer.type (transformatoraliaset) och konfigurera klassen som en OSGi-tjänstkomponent.
Implementera gränssnittet org.apache.sling.rewriter.Transformer. Om du vill minimera arbetet kan du utöka klassen org.apache.cocoon.xml.sax.AbstractSAXPipe. Om du vill anpassa omskrivningsbeteendet åsidosätter du metoden startElement. Den här metoden anropas för varje SAX-händelse som skickas till transformatorn.
Paketera och distribuera klasserna.
Om du vill lägga till transformatorn i pipeline lägger du till en konfigurationsnod i ditt AEM-program.

TIP

Du kan i stället konfigurera TransformerFactory så att transformatorn infogas i alla definierade omskrivare. Därför behöver du inte konfigurera en pipeline:

Ställ in egenskapen pipeline.mode på global.
Ange egenskapen service.ranking som ett positivt heltal.
Ta inte med någon pipeline.type-egenskap.

NOTE

Om du vill skapa ditt Maven-projekt använder du multimodule-arketypen i innehållspaketets plugin-program Maven. Strukturlister skapar och installerar automatiskt ett innehållspaket.

I följande exempel implementeras en transformator som skriver om referenser till bildfiler.

Klassen MyRewriterTransformerFactory instansierar MyRewriterTransformer-objekt. Egenskapen pipeline.type anger transformatoralias till mytransformer. Om du vill ta med aliaset i en pipeline bör pipeline-konfigurationsnoden inkludera aliaset i listan över transformatorer.
Klassen MyRewriterTransformer åsidosätter metoden startElement i klassen AbstractSAXTransformer. Metoden startElement skriver om värdet för src-attribut för img-element.

Exemplen är inte robusta. Använd dem inte i produktionsmiljö.

Exempel på TransformerFactory-implementering

package com.adobe.example;

import org.apache.felix.scr.annotations.Component;
import org.apache.felix.scr.annotations.Service;
import org.apache.felix.scr.annotations.Property;

import org.apache.sling.rewriter.Transformer;
import org.apache.sling.rewriter.TransformerFactory;

@Component
@Service
public class MyRewriterTransformerFactory implements TransformerFactory {
    /* Define the alias */
    @Property(value="mytransformer")
    static final String PIPELINE_TYPE ="pipeline.type";

    public Transformer createTransformer() {

        return new MyRewriterTransformer ();
    }
}

Exempel på transformatorimplementering

package com.adobe.example;

import java.io.IOException;

import org.apache.cocoon.xml.sax.AbstractSAXPipe;

import org.apache.sling.api.SlingHttpServletRequest;
import org.apache.sling.rewriter.ProcessingComponentConfiguration;
import org.apache.sling.rewriter.ProcessingContext;
import org.apache.sling.rewriter.Transformer;

import org.slf4j.Logger;
import org.slf4j.LoggerFactory;

import org.xml.sax.Attributes;
import org.xml.sax.SAXException;
import org.xml.sax.helpers.AttributesImpl;

import javax.servlet.http.HttpServletRequest;

public class MyRewriterTransformer extends AbstractSAXPipe implements Transformer {

 private static final Logger log = LoggerFactory.getLogger(MyRewriterTransformer.class);
 private SlingHttpServletRequest httpRequest;
 /* The element and attribute to act on  */
 private static final String ATT_NAME = new String("src");
 private static final String EL_NAME = new String("img");

 public MyRewriterTransformer () {
 }
 public void dispose() {
 }
 public void init(ProcessingContext context, ProcessingComponentConfiguration config) throws IOException {
  this.httpRequest = context.getRequest();
  log.debug("Transforming request {}.", httpRequest.getRequestURI());
 }
 @Override
 public void startElement (String nsUri, String localname, String qname, Attributes atts) throws SAXException {
  /* copy the element attributes */
  AttributesImpl linkAtts = new AttributesImpl(atts);
  /* Only interested in EL_NAME elements */
  if(EL_NAME.equalsIgnoreCase(localname)){

   /* iterate through the attributes of the element and act only on ATT_NAME attributes */
   for (int i=0; i < linkAtts.getLength(); i++) {
    if (ATT_NAME.equalsIgnoreCase(linkAtts.getLocalName(i))) {
     String path_in_link = linkAtts.getValue(i);

     /* use the resource resolver of the http request to reverse-resolve the path  */
     String mappedPath = httpRequest.getResourceResolver().map(httpRequest, path_in_link);

     log.info("Tranformed {} to {}.", path_in_link,mappedPath);

     /* update the attribute value */
     linkAtts.setValue(i,mappedPath);
    }
   }

  }
        /* return updated attributes to super and continue with the transformer chain */
 super.startElement(nsUri, localname, qname, linkAtts);
 }
}

Lägga till transformatorn i en skrivarpipeline

Skapa en JCR-nod som definierar en pipeline som använder din transformator. Följande noddefinition skapar en pipeline som bearbetar text-/html-filer. AEM standardgenerator och -parser för HTML används.

NOTE

Om du ställer in egenskapen pipeline.mode på global behöver du inte konfigurera en pipeline. I läget global infogas transformatorn i alla rörledningar.

Konfigurationsnod för omskrivare - XML-representation

<?xml version="1.0" encoding="UTF-8"?>
<jcr:root xmlns:jcr="https://www.jcp.org/jcr/1.0" xmlns:nt="https://www.jcp.org/jcr/nt/1.0"
    jcr:primaryType="nt:unstructured"
    contentTypes="[text/html]"
    enabled="{Boolean}true"
    generatorType="htmlparser"
    order="5"
    serializerType="htmlwriter"
    transformerTypes="[mytransformer]">
</jcr:root>

I följande bild visas CRXDE Lite-representationen av noden:

recommendation-more-help