FAQ StrutsConsultez toutes les FAQ

Struts permet de gérer les exceptions de manière déclarative. Dans vos classes Action, si une exception est levée, elle sera propagée jusqu'à la superclasse Action, qui ira chercher si une exception est déclarée pour le mapping de ladite Action. Si ce n'est pas le cas, elle ira ensuite chercher si une exception est déclarée en tant qu'exception globale dans le fichier struts-config.xml.

La gestion déclarative des exceptions crée aussi un message de type ActionMessage (ActionError pour les premières versions de Struts) à partir de la clé de ResourceBundle indiquée. Ce message est alors utilisé par la page jsp spécifiée pour l'affichage d'un message d'erreur.

Le plus grand avantage de ce type de déclaration, outre le fait de centraliser les exceptions, est sans doute de permettre de ne pas polluer le code source des classes Action avec des blocs try/catch redondants dans plusieurs classes.

Pour déclarer une exception, il suffit de créer un nœud de type <exception> au fichier struts-config.xml :

1
2
3
4
5
<exception  
        key="error.message.key" 
        path="/page.jsp" 
        scope="request" 
        type="java.handled.exception.type" />

Pour déclarer une exception en tant qu'exception globale dans le fichier struts-config.xml, il faut ajouter un nœud <exception> au nœud <global-exceptions> :

1
2
3
4
5
6
7
<global-exceptions> 
  <exception  
        key="error.database.failure" 
        path="/dbfailure.jsp" 
        scope="request" 
        type="com.developpez.DatabaseException" /> 
</global-exceptions>

Pour déclarer une exception en tant qu'exception spécifique à une action dans le fichier struts-config.xml, il faut ajouter un nœud <exception> au nœud <action> :

1
2
3
4
5
6
7
8
<action> 
  ... 
  <exception  
        key="error.database.failure" 
        path="/myactionerror.jsp" 
        scope="request" 
        type="com.developpez.DatabaseException" /> 
</action>