Personalizar páginas mostradas por el controlador de error

Adobe Experience Manager AEM () viene con un controlador de error estándar para administrar errores HTTP; por ejemplo, mostrando:

Existen secuencias de comandos proporcionadas por el sistema (en /libs/sling/servlet/errorhandler) para responder a los códigos de error, de forma predeterminada están disponibles las siguientes opciones con una instancia de CQ estándar:

• 403.jsp
• 404.jsp

Personalizar páginas mostradas por el controlador de error

Puede desarrollar sus propias secuencias de comandos para personalizar las páginas que muestra el controlador de errores cuando se produce un error. Las páginas personalizadas se crean en /apps y superponer las páginas predeterminadas (que se encuentran en /libs).

1. En el repositorio, copie los scripts predeterminados:

   • de /libs/sling/servlet/errorhandler/
   • hasta /apps/sling/servlet/errorhandler/

   Como la ruta de destino no existe de forma predeterminada, debe crearla al hacerlo por primera vez.

2. Vaya a /apps/sling/servlet/errorhandler y realice una de las acciones siguientes:

   • edite la secuencia de comandos existente adecuada para poder proporcionar la información necesaria.
   • cree y edite un nuevo script para el código requerido.

3. Guarde los cambios y pruebe.

Personalización de la Respuesta a Errores HTTP 500

Los errores de HTTP 500 se deben a excepciones del lado del servidor.

• 500 Error interno del servidor
  El servidor encontró una condición inesperada que le impedía cumplir la solicitud.

AEM Cuando el procesamiento de solicitudes resulta en una excepción, el marco de trabajo de Apache Sling (en el que se basa ese):

• registra la excepción

• devuelve:

  • el código de respuesta HTTP 500
  • el seguimiento de pila de excepciones

  en el cuerpo de la respuesta.

Por personalización de las páginas mostradas por el controlador de error a 500.jsp se puede crear el script. Sin embargo, solo se utiliza si HttpServletResponse.sendError(500) se ejecuta explícitamente; es decir, desde un receptor de excepciones.

De lo contrario, el código de respuesta se establece en 500, pero la variable 500.jsp no se ejecuta el script.

Para controlar 500 errores, el nombre de archivo de la secuencia de comandos del controlador de errores debe ser el mismo que la clase de excepción (o superclase). Para gestionar todas estas excepciones, puede crear un script /apps/sling/servlet/errorhandler/Throwable.jsp o /apps/sling/servlet/errorhandler/Exception.jsp.