Traitement des erreurs dans le service de composition du système de messagerie

Lorsqu'une erreur se produit dans le traitement d'une page JavaServer, le résultat de cette page contient des informations détaillées générées par le module d'exécution. Si vous voulez que les erreurs JavaServer soient traitées autrement, vous avez le choix entre deux méthodes pour rendre le comportement plus prévisible.

La première méthode consiste à spécifier dans votre page JavaServer une page d'erreur qui est exécutée en cas de détection d'erreur imprévue (une exception non interceptée, par exemple). Pour utiliser cette méthode, vous devez inclure la ligne suivante dans votre page principale :

<%@ page errorPage="YourError.jsp" %>

Vous devez également inclure la ligne suivante dans YourError.jsp :

<%@ page isErrorPage="true" %>

Remarque : En cas d'erreur, le résultat de la composition du message est celui de YourError.jsp. Pour plus de détails, reportez-vous à la spécification JSP 1.0.

La seconde méthode consiste à utiliser une page d'erreur JavaServer pour générer une sortie traitée comme une exception, afin d'éviter que le message d'erreur ne soit traité comme un message sortant. Pour ce faire, utilisez le fichier ComposerError.jsp comme base pour le traitement de l'erreur. Procédez ensuite comme indiqué ci-dessus. Le fichier YourError.jsp doit commencer par les deux premières lignes de ComposerError.jsp. Ainsi, la phase d'exécution de la composition pourra détecter qu'une erreur s'est produite et signaler une exception. Le fichier ComposerError.jsp se trouve dans le répertoire suivant :
unité:\Program Files\WebSphere\AppServer\installedApps\WC_Enterprise_App_<nom_instance>.ear\wcstores.war
unité:\WebSphere\AppServer\installedApps\WC_Enterprise_App_<nom_instance>.ear\wcstores.war
/usr/WebSphere/AppServer/installedApps/WC_Enterprise_App_<nom_instance>.ear/wcstores.war
/opt/WebSphere/AppServer/installedApps/WC_Enterprise_App_<nom_instance>.ear/wcstores.war
/QIBM/Userdata/WebASAdv4/<nom_instance_WAS>/installedApps/WC_Enterprise_App_<nom_instance>.ear/wcstores.war

Les deux premières lignes de ComposerError.jsp sont :

ERROR
<%@ page isErrorPage="true" %>


Pour utiliser ce fichier, vous pouvez indiquer qu'il s'agit de la page d'erreurs en définissant errorPage="ComposerError.jsp" dans la page JSP principale. Si vous souhaitez obtenir de plus amples informations, vous pouvez copier ce fichier dans un autre fichier (YourError.jsp par exemple) et placer les informations supplémentaires relatives à l'erreur à la suite de ces deux lignes dans le nouveau fichier. Vous pouvez ensuite définir errorPage="YourError.jsp" dans la page JSP principale. Toute sortie supplémentaire spécifiée à la suite des deux premières lignes fera partie du texte de l'exception renvoyée par le service de composition.

Rubriques connexes

Référence connexe

IBM copyright