2.3.1 Le composant Interface Fault
Un incident (fault) est un événement survenant pendant l'exécution d'un échange de messages,
qui bouleverse le flux normal des messages.
Un incident survient typiquement lorsqu'une partie est dans l'impossibilité de communiquer une condition d'erreur dans le
flux de messages normal ou souhaite terminer un échange de messages. Un message d'incident peut être utilisé pour communiquer
une information hors bande telle que la raison de l'erreur, l'origine de la panne, ainsi que d'autres diagnostics informels
tel qu'une trace de pile de programme (program stack trace).
Un composant Interface Fault décrit un incident qui PEUT
se produire au cours de l'invocation d'une opération de l'interface. Le composant
Interface Fault déclare un incident abstrait en le nommant et en indiquant le
contenu du message d'incident. Le composant Interface Operation indique quand et
comment le message d'incident circule.
Le composant Interface Fault fournit un mécanisme clair pour nommer et décrire
l'ensemble des incidents qu'une interface peut générer. Cela permet aux opérations d'identifier aisément par leur nom les incidents
individuels que les interfaces peuvent générer. Ce mécanisme permet d'identifier immédiatement le même incident
survenant à travers plusieurs opérations et référencé dans plusieurs liaisons, et de réduire la multiplication des descriptions
d'un incident individuel.
D'autres incidents que ceux décrits dans le composant Interface peuvent également être
générés à l'exécution (at run-time), c'est-à-dire que les incidents forment un ensemble ouvert.
Le composant Interface décrit les incidents ayant une sémantique au niveau de l'application,
c'est-à-dire que le client ou le services sont censés les prendre en charge et potentiellement récupérer d'eux, dans le
cadre de la logique de traitement de l'application. Par exemple, un composant Interface
qui accepte un numéro de carte de crédit peut décrire les incidents indiquant que le numéro de la carte est invalide,
qu'elle a été signalée volée ou qu'elle est périmée. Le composant Interface ne décrit pas
les incidents de systèmes généraux tels que les pannes de réseau, les conditions de dépassement de mémoire, les conditions
de pénurie d'espace disque, les formats de message invalides, etc., même si ces incidents peuvent survenir dans le cadre
de l'échange de messages. De tels incidents de systèmes généraux peuvent survenir au cours de n'importe quel échange de messages
et les décrire explicitement dans un composant Interface n'est donc pas informatif.
Les propriétés du composant Interface Fault
sont les suivantes :
-
{name}, OBLIGATOIRE.
Un nom qualifié xs:QName ;
-
{message content model},
OBLIGATOIRE. Un type xs:token
ayant l'une des valeurs suivantes : #any, #none, #other ou
#element †.
Une valeur de #any indique que le contenu des incidents est n'importe quel élément seul ; une valeur de #none
indique qu'il n'y aucun contenu d'incident ; une valeur de #other indique que le contenu d'incident est décrit
par une autre propriété d'extension référençant une déclaration dans un système de typage d'extension non-XML ;
une valeur de #element indique que l'incident se compose d'un seul élément décrit par la déclaration d'élément globale
référencée par la propriété {element declaration}. Cette propriété
n'est utilisée que si l'incident est décrit en utilisant un modèle de données fondé sur XML ;
-
{element declaration},
OPTIONNELLE. Une référence à un composant
Element Declaration dans la propriété
{element declarations} du composant
Description. Cet élément représente le contenu, ou « charge utile »
(payload), de l'incident. Lorsque la propriété
{message content model} a la valeur #any ou #none,
la propriété {element declaration} DOIT être
vide † ;
-
{parent},
OBLIGATOIRE. Le composant Interface qui contient ce composant
dans sa propriété {interface faults}.
Pour chaque composant Interface Fault dans la propriété
{interface faults} d'un composant Interface,
la propriété {name} doit être unique. Notez que le schéma XML normatif de
WSDL 2.0 fait valoir cette contrainte.
Les composants Interface Fault sont identifiés de manière unique par le
nom qualifié QName du composant Interface englobant et le nom qualifié du composant
Interface Fault même.
Au cas où deux (ou plus) composants
Interface Fault ont des propriétés {name}
de même valeur, en raison d'une interface qui étend une ou plusieurs autres interfaces, alors les modèles de composant de ces composants
Interface Fault DOIVENT être équivalents (cf. la section
2.15 Équivalence des composants) †. Si les composants
Interface Fault sont équivalents, alors ils sont censés fusionner en un seul composant.
Au sein du même composant Interface, si deux composants
Interface Fault ne sont pas équivalents, alors leurs propriétés
{name} NE DOIVENT PAS être égales.
À cause des règles précédentes, notez que si deux interfaces ont la même valeur de nom d'espace de noms pour leurs propriétés
{name} et ont aussi un ou plusieurs incidents avec la même valeur pour leurs propriétés
{name}, alors ces interfaces ne peuvent pas les deux former une partie de la
chaîne de dérivation d'une interface dérivée, à moins que ces incidents n'en soient qu'un.
Pour la raison précédente, une bonne pratique
DEVRAIT être de s'assurer, le cas échéant, que le nom local de la propriété
{name} des composants Interface Fault
au sein d'un espace de noms soit unique, rendant ainsi possible une telle dérivation sans erreur
accidentelle †.
Si un sytème de typage non fondé sur l'ensemble d'information XML
[XML Information Set] est en vigueur (comme examiné dans la section
3.2 Utitilisation d'autres langages de schéma), alors il faudrait ajouter d'autres
propriétés au composant Interface Fault (en même temps que des attributs d'extension à
sa représentation XML) afin de pouvoir associer ces types de message au message de référence.
2.3.2 Représentation XML du composant Interface Fault
<description>
<interface>
<fault
name="xs:NCName"
element="union de xs:QName, xs:token"? >
<documentation />*
</fault>
</interface>
</description>
La représentation XML d'un composant Interface Fault
est un item d'information d'élément avec les propriétés d'ensemble d'information suivantes :
-
un nom local [local name] de fault ;
-
un nom d'espace de noms [namespace name] de "http://www.w3.org/ns/wsdl" ;
-
un ou plusieurs items d'information d'attribut parmi ses attributs [attributes] comme suit :
-
zéro ou plus items d'information d'élément parmi ses sous-éléments [children], en ordre, comme suit :
-
zéro ou plus items d'information d'élément documentation (cf. la section
5. Documentation) ;
-
zéro ou plus items d'information d'élément, qualifiés dans un espace de noms, dont le nom d'espace de noms [namespace name]
n'est pas "http://www.w3.org/ns/wsdl".
2.3.2.1 Item d'information d'attribut name avec élément possesseur [owner element] fault
L'item d'information d'attribut name identifie un item d'information d'élément fault donné à l'intérieur
d'un item d'information d'élément interface.
L'item d'information d'attribut name a les propriétés d'ensemble d'information suivantes :
Le type de l'item d'information d'attribut name est xs:NCName.
2.3.2.2 Item d'information d'attribut element avec élément possesseur [owner element] fault
L'item d'information d'attribut element se rapporte, par un nom qualifié QName, à un composant
Element Declaration.
L'item d'information d'attribut element a les propriétés d'ensemble d'information suivantes :
Le type de l'item d'information d'attribut element est l'union d'un type xs:QName et d'un type xs:token,
où les valeurs d'atome (token) permises sont #any, #none ou #other.
