Estructura del árbol Lista de excepciones

El árbol 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 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 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 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. Puede modificar su contenido sólo en 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 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 Lista de excepciones siempre es RecoverableException. Normalmente sólo hay un hijo del elemento raíz, aunque bajo ciertas circunstancias pueden 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, que puede ser:

A continuación se muestra la estructura del árbol de lista de excepciones para RecoverableException:



La estructura de la descripción de excepción puede ser repetida y anidad para generar un árbol 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 de caracteres Nombre del archivo fuente C++
Line1 Entero Número de línea del archivo fuente C++
Function1 Serie de caracteres Nombre de la función fuente C++
Type2 Serie de caracteres Tipo del objeto fuente
Name2 Serie de caracteres Nombre del objeto fuente
Label2 Serie de caracteres Etiqueta del objeto fuente
Text1 Serie de caracteres Texto adicional
Catalog3 Serie de caracteres 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 de caracteres 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 escribir información en un archivo de anotaciones, para que lo utilice el personal de servicio de IBM.
  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 finaliza el proceso del flujo de mensajes, se elimina el árbol Lista de excepciones.

El Ejemplo Reserva de vuelos utiliza la lista de excepciones del flujo de mensajes XML_Reservation para pasar información de error al nodo Throw, lo que genera un mensaje de error que incluye la información de la lista de excepciones.

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, 2006 Última actualización: 22/08/2006
ac00540_