Annullamento della validità delle pagine in cache da AEM invalidating-cached-pages-from-aem

Quando utilizzi Dispatcher con AEM, l’interazione deve essere configurata per garantire un’efficace gestione della cache. A seconda dell’ambiente, la configurazione può anche migliorare le prestazioni.

Configurazione degli account utente AEM setting-up-aem-user-accounts

L’account utente predefinito admin viene utilizzato per autenticare gli agenti di replica installati per impostazione predefinita. Devi creare un account utente dedicato da utilizzare con gli agenti di replica.

Per ulteriori informazioni, vedi la sezione Configurazione degli utenti di replica e trasporto dell’elenco di controllo della sicurezza di AEM.

Annullamento della validità della cache di Dispatcher dall’ambiente di authoring invalidating-dispatcher-cache-from-the-authoring-environment

Un agente di replica sull’istanza Autore AEM invia una richiesta di annullamento della validità della cache a Dispatcher quando viene pubblicata una pagina. La richiesta induce Dispatcher ad aggiornare il file nella cache quando viene pubblicato nuovo contenuto.

Per configurare un agente di replica nell’istanza Autore AEM per annullare la validità della cache di Dispatcher all’attivazione della pagina, fai quanto segue:

In alternativa, puoi anche accedere e configurare l’agente di Dispatcher Flush dall’interfaccia utente di AEM Touch.

Per ulteriori dettagli su come abilitare l’accesso agli URL personalizzati, vedi Abilitazione dell’accesso agli URL personalizzati.

Questo approccio presenta due potenziali problemi:

Annullamento della validità della cache del Dispatcher da un’istanza Publish invalidating-dispatcher-cache-from-a-publishing-instance

In determinate circostanze è possibile ottenere vantaggi in termini di prestazioni trasferendo la gestione della cache dall’ambiente di authoring a un’istanza Publish. Sarà quindi l’ambiente di pubblicazione (non l’ambiente di authoring AEM) a inviare una richiesta di annullamento della validità della cache a Dispatcher quando viene ricevuta una pagina pubblicata.

Queste circostanze includono:

Il flushing di Dispatcher è controllato da un agente di replica che agisce sull’istanza Publish. Tuttavia, la configurazione viene effettuata nell’ambiente di authoring e quindi trasferita attivando l’agente:

Dopo la configurazione, quando attivi una pagina da Autore a Publish, questo agente avvia una replica standard. Il registro include messaggi che indicano le richieste provenienti dal server di pubblicazione, come nell’esempio seguente:

Annullamento manuale della validità della cache di Dispatcher manually-invalidating-the-dispatcher-cache

Per invalidare (o eseguire il flushing) della cache di Dispatcher senza attivare una pagina, puoi inviare una richiesta HTTP a Dispatcher. Ad esempio, puoi creare un’applicazione AEM che consenta agli amministratori o ad altre applicazioni di eseguire il flushing della cache.

La richiesta HTTP fa in modo che Dispatcher elimini file specifici dalla cache. Facoltativamente, Dispatcher aggiorna la cache con una nuova copia.

Elimina i file memorizzati nella cache delete-cached-files

Invia una richiesta HTTP che induca Dispatcher a eliminare i file dalla cache. Dispatcher memorizza nuovamente in cache i file solo quando riceve dal client una richiesta per la pagina. Questa modalità di eliminazione dei file memorizzati in cache è appropriata per i siti web che hanno poche probabilità di ricevere richieste simultanee per la stessa pagina.

La richiesta HTTP ha il seguente formato:

POST /dispatcher/invalidate.cache HTTP/1.1
CQ-Action: Activate
CQ-Handle: path-pattern
Content-Length: 0

Dispatcher elimina (esegue il flushing) i file e le cartelle memorizzati in cache con nomi che corrispondono al valore dell’intestazione CQ-Handler. Ad esempio, un CQ-Handle con il valore /content/geomtrixx-outdoors/en corrisponde ai seguenti elementi:

Tutti gli altri file nella cache di Dispatcher (o fino a un determinato livello, a seconda dell’impostazione /statfileslevel) vengono invalidati toccando il file .stat. L’ultima data di modifica di questo file viene confrontata con l’ultima data di modifica di un documento memorizzato in cache e il documento viene recuperato, se il file .stat è più recente. Per ulteriori informazioni, vedi Annullamento della validità dei file per livello di cartella.

L’annullamento della validità (ovvero il tocco dei file .stat) può essere impedito inviando un’intestazione aggiuntiva CQ-Action-Scope: ResourceOnly. Questo metodo può essere utilizzato per eseguire il flushing di determinate risorse senza invalidare altre parti della cache, come nel caso dei dati JSON che vengono creati in modo dinamico e richiedono un flushing regolare indipendente dalla cache (ad esempio, che rappresentano dati provenienti da un sistema di terze parti per la visualizzazione di notizie, ticker di borsa e altro).

Eliminazione e rimemorizzazione in cache dei file delete-and-recache-files

Invia una richiesta HTTP che induca Dispatcher a eliminare i file memorizzati in cache e quindi a recuperare e rimemorizzare in cache immediatamente gli stessi file. Elimina e rimemorizza in cache immediatamente i file quando è probabile che i siti web ricevano dai client richieste simultanee per la stessa pagina. Il re-caching immediato garantisce che Dispatcher recuperi e memorizzi in cache la pagina una sola volta, invece di una volta per ciascuna delle richieste simultanee inviate dai client.

Nota: l’eliminazione e il re-caching dei file devono essere eseguiti solo dall’istanza Publish. Quando viene eseguita dall’istanza Autore, si verificano condizioni di estrema competizione quando i tentativi di recuperare le risorse vengono effettuati prima che le risorse siano pubblicate.

La richiesta HTTP ha il seguente formato:

POST /dispatcher/invalidate.cache HTTP/1.1
CQ-Action: Activate
`Content-Type: text/plain
CQ-Handle: path-pattern
Content-Length: numchars in bodypage_path0

page_path1
...
page_pathn

I percorsi delle pagine per il re-caching immediato sono elencati su righe separate nel corpo del messaggio. Il valore di CQ-Handle è il percorso di una pagina che invalida le pagine da rimemorizzare in cache. (Vedi il parametro /statfileslevel dell’elemento di configurazione Cache). Il seguente messaggio di richiesta HTTP elimina e quindi rimemorizza in cache la /content/geometrixx-outdoors/en.html page:

POST /dispatcher/invalidate.cache HTTP/1.1
CQ-Action: Activate
Content-Type: text/plain
CQ-Handle: /content/geometrixx-outdoors/en/men.html
Content-Length: 36

/content/geometrixx-outdoors/en.html

Esempio di servlet per il flushing example-flush-servlet

Il codice seguente implementa un servlet che invia una richiesta di annullamento della validità a Dispatcher. Il servlet riceve un messaggio di richiesta contenente i parametri handle e page. Questi parametri forniscono rispettivamente il valore dell’intestazione CQ-Handle e il percorso della pagina da rimemorizzare in cache. Il servlet utilizza i valori per creare la richiesta HTTP per Dispatcher.

Quando il servlet viene distribuito all’istanza Publish, il seguente URL induce Dispatcher a eliminare la pagina /content/geometrixx-outdoors/en.html e quindi a rimemorizzare in cache una nuova copia della stessa pagina.

10.36.79.223:4503/bin/flushcache/html?page=/content/geometrixx-outdoors/en.html&handle=/content/geometrixx-outdoors/en/men.html

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.api.SlingHttpServletRequest;
import org.apache.sling.api.SlingHttpServletResponse;
import org.apache.sling.api.servlets.SlingSafeMethodsServlet;

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

import org.apache.commons.httpclient.*;
import org.apache.commons.httpclient.methods.PostMethod;
import org.apache.commons.httpclient.methods.StringRequestEntity;

@Component(metatype=true)
@Service
public class Flushcache extends SlingSafeMethodsServlet {

 @Property(value="/bin/flushcache")
 static final String SERVLET_PATH="sling.servlet.paths";

 private Logger logger = LoggerFactory.getLogger(this.getClass());

 public void doGet(SlingHttpServletRequest request, SlingHttpServletResponse response) {
  try{
      //retrieve the request parameters
      String handle = request.getParameter("handle");
      String page = request.getParameter("page");

      //hard-coding connection properties is a bad practice, but is done here to simplify the example
      String server = "localhost";
      String uri = "/dispatcher/invalidate.cache";

      HttpClient client = new HttpClient();

      PostMethod post = new PostMethod("https://"+host+uri);
      post.setRequestHeader("CQ-Action", "Activate");
      post.setRequestHeader("CQ-Handle",handle);

      StringRequestEntity body = new StringRequestEntity(page,null,null);
      post.setRequestEntity(body);
      post.setRequestHeader("Content-length", String.valueOf(body.getContentLength()));
      client.executeMethod(post);
      post.releaseConnection();
      //log the results
      logger.info("result: " + post.getResponseBodyAsString());
      }
  }catch(Exception e){
      logger.error("Flushcache servlet exception: " + e.getMessage());
  }
 }
}