Estructura del árbol de lista de excepciones

El árbol de lista de excepciones es una parte del árbol lógico de mensajes en la que el flujo de mensajes graba información sobre las excepciones que se producen cuando se procesa un mensaje.

El elemento raíz del árbol de lista de excepciones se denomina Lista de excepciones, y el árbol consta de un conjunto de cero o más descripciones de excepciones. Si se produce una excepción, el flujo de mensajes rellena el árbol de lista de excepciones. Si no se producen condiciones de excepción durante el proceso del flujo de mensajes, la lista de excepciones asociada a ese mensaje sólo consta de un elemento raíz. Es decir, de hecho, una lista de excepciones vacía.

Al árbol de lista de excepciones pueden acceder otros nodos dentro del flujo de mensajes que reciban el mensaje después de que se produzca la excepción. El contenido del árbol de lista de excepciones sólo se puede modificar en un nodo que proporcione una interfaz para modificar el árbol de mensajes de salida; por ejemplo, el nodo Compute.

Si se produce una condición de excepción, se suspende el proceso del mensaje y se genera una excepción. El control se devuelve a un nivel superior; es decir, a un bloqueo de captación que lo incluye. Se genera una lista de excepciones para describir la condición del error, y el mensaje entero, junto con el árbol de entorno local y la lista de excepciones que se acaba de rellenar, se propagan a través de una ruta de flujo de mensajes de manejo de excepciones.

El hijo de una lista de excepciones siempre es RecoverableException. Normalmente sólo se crea un hijo del elemento raíz, aunque en ciertas circunstancias puede generarse más de uno. El hijo de Lista de excepciones contiene varios hijos, el último de los cuales proporciona información adicional específica del tipo de excepción. La siguiente lista incluye algunos de los tipos de excepción que podrían verse:

La figura siguiente muestra la estructura del árbol de lista de excepciones para una excepción recuperable:

Estructura de un árbol de lista de excepciones para una excepción recuperable

La estructura de la descripción de excepción se puede repetir y anidar para generar un árbol de lista de excepciones. En este árbol:

Los hijos en el árbol toman la forma de varios elementos nombre-valor que proporcionan detalles de la excepción, y cero o más elementos de nombre cuyo nombre es Insert. El número de mensaje NLS (Soporte de idiomas nacionales) identificado en un elemento nombre-valor identifica un mensaje de error de WebSphere Message Broker. Los valores Insert se utilizan para sustituir las variables dentro de este mensaje y proporcionan detalles adicionales sobre la causa de la excepción.

Los elementos nombre-valor dentro de la lista de excepciones que se muestran en la figura anterior se describen en la tabla siguiente.

Nombre Tipo Descripción
File1 Serie Nombre del archivo fuente C++
Line1 Entero Número de línea del archivo fuente C++
Function1 Serie Nombre de la función fuente C++
Type2 Serie Tipo del objeto fuente
Name2 Serie Nombre del objeto fuente
Label2 Serie Etiqueta del objeto fuente
Text1 Serie Texto adicional
Catalog3 Serie Nombre del catálogo de mensajes NLS4
Severity3 Entero

1 = información
2 = aviso
3 = error

Number3 Entero Número del mensaje NLS4
Insert3 Tipo Entero El tipo de datos del valor:

0 = Desconocido
1 = Booleano
2 = Entero
3 = Flotante
4 = Decimal
5 = Carácter
6 = Hora
7 = Hora GMT
8 = Fecha
9 = Fecha y hora
10 = Fecha y hora GMT
11 = Intervalo
12 = BLOB
13 = Matriz de bits
14 = Puntero

Text Serie El valor de los datos
Notas:
  1. No utilice los elementos File, Line, Function y Text para la toma de decisiones en el manejo de excepciones. Estos elementos aseguran que se pueda grabar información en un archivo de anotaciones para que lo utilice el personal de servicio de IBM y están sujetos a cambios en el contenido y el orden.
  2. Los elementos Type, Name y Label definen el objeto (normalmente un nodo de flujo de mensajes) que estaba procesando el mensaje cuando se produjo la condición de excepción.
  3. Los elementos Catalog, Severity y Number definen un mensaje NLS: los elementos Insert que contienen los dos elementos nombre-valor que se muestran definen las inserciones en ese mensaje NLS.
  4. El nombre del catálogo de mensajes NLS y el número de mensaje NLS hacen referencia a un catálogo de mensajes que se pueden traducir y un número de mensaje.

Cuando se ha completado el flujo de mensajes, se descarta el árbol de lista de excepciones.

El siguiente ejemplo utiliza la lista de excepciones del flujo de mensajes de XML_Reservation para pasar información sobre errores al nodo Throw que genera un mensaje de error que incluye la información de la lista de excepciones: Los ejemplos sólo pueden verse cuando se utiliza el centro de información que está integrado en el Kit de herramientas de Message Brokers.
Conceptos relacionados
Visión general de flujos de mensajes
Contenido del árbol de mensaje después de una excepción
Modelado de mensajes
Tareas relacionadas
Acceder al árbol ExceptionList
Desarrollar flujos de mensajes
Manejar errores en flujos de mensajes
Generar una excepción
Escribir ESQL
Escribir Java
Referencia relacionada
Nodos incorporados
Nodo Compute
Avisos | Marcas registradas | Descargas | Biblioteca | Soporte | Su opinión

Copyright IBM Corporation 1999, 2009Copyright IBM Corporation 1999, 2009.
Última actualización : 2009-02-16 13:53:33

ac00540_