Pagina's aanpassen die worden weergegeven door de fouthandler

Laatste update: 2023-05-04
  • Onderwerpen:
  • Developing
    Meer informatie over dit onderwerp
  • Gemaakt voor:
  • Developer
LET OP

AEM 6.4 heeft het einde van de uitgebreide ondersteuning bereikt en deze documentatie wordt niet meer bijgewerkt. Raadpleeg voor meer informatie onze technische ondersteuningsperioden. Ondersteunde versies zoeken hier.

AEM wordt geleverd met een standaardfouthandler voor de afhandeling van HTTP-fouten; bijvoorbeeld door het volgende weer te geven:

chlimage_1-67

Door het systeem verschafte scripts bestaan (onder /libs/sling/servlet/errorhandler) om te reageren op foutcodes, standaard is het volgende beschikbaar bij een standaard CQ-instantie:

  • 403.jsp
  • 404.jsp
OPMERKING

AEM is gebaseerd op Apache Sling, zie https://sling.apache.org/site/errorhandling.html voor meer informatie over foutafhandeling bij verkoop.

OPMERKING

Op een instantie van de auteur CQ WCM-foutopsporingsfilter is standaard ingeschakeld. Dit resulteert altijd in reactiecode 200. De standaardfoutenmanager antwoordt door het volledige stapelspoor aan de reactie te schrijven.

Voor een publicatie-instantie is CQ WCM Debug Filter altijd uitgeschakeld (zelfs als geconfigureerd als ingeschakeld).

Hoe te om Pagina's aan te passen die door de Handler van de Fout worden getoond

U kunt uw eigen scripts ontwikkelen om de pagina's aan te passen die door de fouthandler worden weergegeven wanneer een fout optreedt. Uw aangepaste pagina's worden gemaakt onder /apps en bedekken de standaardpagina's (die onder /libs).

OPMERKING

Zie Bedekkingen gebruiken voor meer informatie .

  1. Kopieer het standaardscript of de standaardscripts in de gegevensopslagruimte:

    • Van /libs/sling/servlet/errorhandler/
    • tot /apps/sling/servlet/errorhandler/

    Aangezien het bestemmingspad niet standaard bestaat, zult u het moeten tot stand brengen wanneer het doen van dit voor het eerst.

  2. Ga naar /apps/sling/servlet/errorhandler. Hier kunt u:

    • bewerk het juiste bestaande script om de vereiste informatie op te geven.
    • Maak en bewerk een nieuw script voor de vereiste code.
  3. Sla de wijzigingen op en test u deze.

LET OP

De handlers 404.jsp en 403.jsp zijn specifiek ontworpen om voor authentificatie CQ5 te behandelen; met name om systeemaanmelding mogelijk te maken in het geval van deze fouten.

Daarom moeten deze twee handlers met grote zorg worden vervangen.

De reactie op HTTP 500-fouten aanpassen

HTTP 500-fouten worden veroorzaakt door uitzonderingen aan de serverzijde.

  • 500 Interne serverfout
    De server heeft een onverwachte voorwaarde aangetroffen waardoor deze de aanvraag niet kan uitvoeren.

Wanneer de verzoekverwerking in een uitzondering resulteert, het kader van Apache Sling (dat AEM wordt voortgebouwd op):

  • meldt de uitzondering

  • retourneert:

    • de HTTP-antwoordcode 500
    • de spoor van de uitzonderingsstapel

    in het lichaam van de reactie.

Door aanpassen van de pagina's die worden weergegeven door de fouthandler a 500.jsp kan worden gemaakt. Het wordt echter alleen gebruikt als HttpServletResponse.sendError(500) uitdrukkelijk wordt uitgevoerd; d.w.z. van een uitzonderingscatcher.

Anders is de antwoordcode ingesteld op 500, maar wordt de 500.jsp script niet uitgevoerd.

Als u 500 fouten wilt afhandelen, moet de bestandsnaam van het script van de fouthandler gelijk zijn aan de uitzonderingsklasse (of superklasse). Om al dergelijke uitzonderingen te behandelen kunt u een manuscript tot stand brengen /apps/sling/servlet/errorhandler/Throwable.jsp of /apps/sling/servlet/errorhandler/Exception.jsp.

LET OP

Op een instantie van de auteur CQ WCM-foutopsporingsfilter is standaard ingeschakeld. Dit resulteert altijd in reactiecode 200. De standaardfoutenmanager antwoordt door het volledige stapelspoor aan de reactie te schrijven.

Voor een aangepaste fout-handler zijn reacties met code 500 nodig - dus de CQ WCM-foutopsporingsfilter moet worden uitgeschakeld. Dit zorgt ervoor dat reactiecode 500 is teruggekeerd, die beurtelings de correcte fout-manager van het Sling teweegbrengt.

Voor een publicatie-instantie is CQ WCM Debug Filter altijd uitgeschakeld (zelfs als geconfigureerd als ingeschakeld).

Op deze pagina