Personalizzazione delle pagine mostrate dal gestore errori

AEM viene fornito con un gestore di errori standard per la gestione degli errori HTTP; ad esempio, mostrando:

Esistono script forniti dal sistema (in /libs/sling/servlet/errorhandler) per rispondere ai codici di errore, per impostazione predefinita sono disponibili le seguenti opzioni con un'istanza CQ standard:

• 403.jsp
• 404.jsp

Come personalizzare le pagine visualizzate dal gestore errori

È possibile sviluppare script personalizzati per personalizzare le pagine mostrate dal gestore errori quando si verifica un errore. Le pagine personalizzate verranno create in /apps e sovrapporranno le pagine predefinite (che si trovano sotto /libs).

1. Nell'archivio, copiare gli script predefiniti:

   • da /libs/sling/servlet/errorhandler/
   • a /apps/sling/servlet/errorhandler/

   Poiché il percorso di destinazione non esiste per impostazione predefinita, sarà necessario crearlo al primo tentativo.

2. Accedi a /apps/sling/servlet/errorhandler. Potete effettuare le seguenti operazioni:

   • modificare lo script esistente appropriato per fornire le informazioni richieste.
   • creare e modificare un nuovo script per il codice richiesto.

3. Salvate le modifiche e verificate il comportamento.

Personalizzazione della risposta agli errori HTTP 500

Gli errori HTTP 500 sono causati da eccezioni lato server.

• 500 Internal Server
  ErrorIl server ha rilevato una condizione imprevista che non consentiva all'utente di soddisfare la richiesta.

Quando l'elaborazione della richiesta genera un'eccezione, il framework Apache Sling (che AEM è basato su):

• registra l'eccezione

• return:

  • il codice di risposta HTTP 500
  • traccia dello stack di eccezioni

  nel corpo della risposta.

Per personalizzare le pagine visualizzate dal gestore di errori è possibile creare uno script 500.jsp. Tuttavia, viene utilizzato solo se HttpServletResponse.sendError(500) viene eseguito in modo esplicito; ovvero da un rilevatore di eccezioni.

In caso contrario, il codice di risposta è impostato su 500, ma lo script 500.jsp non viene eseguito.

Per gestire 500 errori, il nome file dello script del gestore di errori deve essere uguale alla classe di eccezione (o superclasse). Per gestire tutte queste eccezioni è possibile creare uno script /apps/sling/servlet/errorhandler/Throwable.jsp o /apps/sling/servlet/errorhandler/Exception.jsp.