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. Crea un account utente dedicato da utilizzare con gli agenti di replica.

Per ulteriori informazioni, vedi la sezione Configurare gli 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. Dispatcher aggiorna il file alla fine nella cache quando viene pubblicato un nuovo contenuto.

Per configurare un agente di replica nell’istanza di authoring di AEM, utilizza la procedura descritta di seguito. La configurazione invalida la cache di Dispatcher all’attivazione della pagina:

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, consulta Abilitazione dell’accesso agli URL personalizzati.

Questo approccio presenta due potenziali problemi:

Annullamento della validità della cache di Dispatcher da un’istanza di pubblicazione 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 di pubblicazione. 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:

Un agente di replica che opera sull’istanza di pubblicazione controlla lo svuotamento del Dispatcher. Tuttavia, la configurazione viene effettuata nell’ambiente di authoring e poi 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 annullare la validità (o eseguire lo svuotamento) della cache del Dispatcher senza attivare una pagina, puoi inviare una richiesta HTTP al Dispatcher. Ad esempio, puoi creare un’applicazione AEM che consente agli amministratori o ad altre applicazioni di eseguire lo svuotamento 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 del 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 toccare i file .stat) può essere impedito inviando un’intestazione CQ-Action-Scope: ResourceOnly aggiuntiva. Questa funzionalità può essere utilizzata per svuotare determinate risorse. Tutto senza invalidare altre parti della cache, come i dati JSON. Tali dati vengono creati in modo dinamico e richiedono uno svuotamento regolare e indipendente della cache. Ad esempio, si possono rappresentare i dati ottenuti da un sistema di terze parti per la visualizzazione di notizie, quotazioni di borsa e così via.

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

Invia una richiesta HTTP che induca Dispatcher a eliminare i file memorizzati nella cache e a recuperarli e rimemorizzarli immediatamente nella cache. 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 la rimemorizzazione nella cache dei file dovrebbero essere eseguite solo nell’istanza di pubblicazione. 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 la rimemorizzazione nella cache immediata 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à al 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 di pubblicazione, il seguente URL induce Dispatcher a eliminare la pagina /content/geometrixx-outdoors/en.html e, quindi, a memorizzare nella cache una nuova copia.

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());
  }
 }
}