DocumentatieAEM 6.5Handboek

Pagina's aanpassen die worden weergegeven door de fouthandler customizing-pages-shown-by-the-error-handler

Last update: Sun Jul 14 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Gemaakt voor:

  • Ontwikkelaar

Adobe Experience Manager (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 zijn de volgende scripts beschikbaar met een standaard CQ-instantie:

  • 403.jsp
  • 404.jsp
NOTE
AEM is gebaseerd op Apache Sling. Als dusdanig, zie de Behandeling van de Foutvoor gedetailleerde informatie over het Verdelen van fout behandeling.
NOTE
Op een auteursinstantie, wordt CQ WCM zuivert Filtertoegelaten door gebrek. Dit resulteert altijd in reactiecode 200. De standaardfoutenmanager antwoordt door het volledige stapelspoor aan de reactie te schrijven.
Op publiceer instantie, is CQ WCM zuivert Filter altijd gehandicapt (zelfs als gevormd zoals toegelaten).

Hoe te om Pagina's aan te passen die door de Handler van de Fout worden getoond how-to-customize-pages-shown-by-the-error-handler

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

NOTE
Zie Gebruikend Bedekkingenvoor meer details.

  1. Kopieer de standaardscripts in de opslagplaats:

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

    Aangezien het bestemmingspad niet standaard bestaat, moet u het creëren wanneer het doen dit voor het eerst.

  2. Navigeer naar /apps/sling/servlet/errorhandler en voer een van de volgende handelingen uit:

    • bewerk het juiste bestaande script, zodat u de vereiste informatie kunt opgeven.
    • Maak en bewerk een nieuw script voor de vereiste code.

  3. Sla de wijzigingen op en test u deze.

CAUTION
De handlers 404.jsp en 403.jsp zijn ontworpen om voor authentificatie CQ5 te behandelen; in het bijzonder, om systeemlogin toe te staan als er deze fouten zijn.
Daarom moeten deze twee handlers met grote zorg worden vervangen.

De reactie op HTTP 500-fouten aanpassen customizing-the-response-to-http-errors

HTTP 500 fouten worden veroorzaakt door server-zijuitzonderingen.

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 aan te passen kunnen de pagina's die door de foutenmanagerworden getoond a 500.jsp manuscript worden gecreeerd. Deze wordt echter alleen gebruikt als HttpServletResponse.sendError(500) expliciet wordt uitgevoerd, dat wil zeggen van een uitzonderingscatcher.

Anders is de antwoordcode ingesteld op 500, maar wordt het script 500.jsp 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 /apps/sling/servlet/errorhandler/Throwable.js p of /apps/sling/servlet/errorhandler/Exception.jsp tot stand brengen.

CAUTION
Op een auteursinstantie, wordt CQ WCM zuivert Filtertoegelaten door gebrek. Dit resulteert altijd in reactiecode 200. De standaardfoutenmanager antwoordt door het volledige stapelspoor aan de reactie te schrijven.
Voor een douane fout-manager, zijn de reacties met code 500 nodig - zodat moet de CQ WCM zuivert Filterworden onbruikbaar gemaakt. Dit zorgt ervoor dat reactiecode 500 is teruggekeerd, die beurtelings de correcte fout-manager van het Sling teweegbrengt.
Op publiceer instantie, is CQ WCM zuivert Filter altijd gehandicapt (zelfs als gevormd zoals toegelaten).
recommendation-more-help
19ffd973-7af2-44d0-84b5-d547b0dffee2