Les membres de l’API des exceptions ESB
L’ESB. L’assembly ExceptionHandling expose des méthodes publiques pour créer des messages d’erreur et les gérer et les récupérer pour traitement, comme décrit dans le tableau suivant.
Membre et cas d’usage | Description |
---|---|
CreateFaultMessage [étendue du gestionnaire d’exceptions] | public static XLANGMessage CreateFaultMessage() Ne prend aucun paramètre. Retourne une instance du message d’erreur ESB sous la forme d’un instance XLANGMessage rempli avec le nom d’orchestration actuel, l’ID de instance d’orchestration (GUID), l’instance System.Exception et d’autres propriétés ambiantes. Note: Cette INTERFACE de programmation d’application (API) doit être appelée uniquement à partir d’un bloc d’exception dans le XLANG. |
AddMessage [étendue du gestionnaire d’exceptions] | public static void AddMessage(faultMessage, existingMessage) Prend comme paramètres deux instances XLANGMessage ; le premier est un message d’erreur ESB nouvellement créé, et le second est n’importe quel message existant instance dans l’orchestration. La méthode conserve le message existant instance et ses propriétés de contexte de message dans le message d’erreur et le rend disponible pour la récupération à l’aide de la méthode GetMessage. Pas de valeur de retour. |
SetException [étendue du gestionnaire d’exceptions] | public static void SetException(faultMessage, exception) Prend comme paramètres un message d’erreur ESB en tant que instance XLANGMessage et exception en tant que instance d’objet. La méthode conserve l’exception dans le message d’erreur existant et la rend disponible pour la récupération à l’aide de la méthode GetException . Pas de valeur de retour. |
GetMessage [Abonné/processeur] | public static XLANGMessage GetMessage(faultMessage, messageName) Prend comme paramètres un message d’erreur ESB reçu d’un abonnement en tant que instance XLANGMessage et le nom (String) du message précédemment ajouté au message d’erreur (dans le gestionnaire d’exceptions de la forme d’orchestration d’origine). Renvoie une instance XLANGMessage qui correspond au nom du message et qui contient toutes les propriétés de contexte d’origine, y compris toutes les propriétés promues personnalisées. |
GetMessages [Abonné/processeur] | public static MessageCollection GetMessages(faultMessage) Prend comme paramètre unique un message d’erreur ESB reçu d’un abonnement en tant que instance XLANGMessage. Retourne un MessageCollection instance rempli avec toutes les instances XLANGMessage précédemment ajoutées au message d’erreur (dans le gestionnaire d’exceptions de la forme d’orchestration d’origine). Chaque instance XLANGMessage contient toutes les propriétés de contexte d’origine, y compris toutes les propriétés promues personnalisées. |
GetException [Abonné/processeur] | public static System.Exception GetException(faultMessage) Prend comme paramètre unique un message d’erreur reçu d’un abonnement en tant que instance XLANGMessage. Retourne l’objet System.Exception précédemment ajouté au message d’erreur (dans le gestionnaire d’exceptions de la forme d’orchestration d’origine). |
FaultSeverity [étendue du gestionnaire d’exceptions et abonné/processeur] | Propriété publique en lecture/écriture de la classe XLANGMessage du message d’erreur ESB qui expose la gravité d’un message d’erreur. Valeur de l’énumération FaultCodes : Information (0), Avertissement (1), Erreur (2), Grave (3) ou Critique (4). |
MessageCollection [Abonné/processeur] | Collection des messages retournés par la méthode GetMessages . Cette classe dérive de ArrayList et implémente un énumérateur pour autoriser l’itération à l’aide de la méthode MoveNext . |