Utilización de un manejador de mensajes

El comportamiento predeterminado de los errores de proceso de tiempo de preparación y tiempo de ejecución y otros mensajes consiste en imprimir los mensajes en System.err y que los errores no recuperables alcancen también XProcessException. Si se produce un error en el tiempo de preparación, el procesador intenta continuar la preparación y marca todos los errores antes de generar XProcessException; pero no se genera ningún ejecutable. En el tiempo de ejecución, se detiene la ejecución en la primera aparición de una situación de error.

Procedimiento

Cambie el manejo de errores registrando una implementación de XMessageHandler en XStaticContext (para errores de tiempo de preparación y otros mensajes) o XDynamicContext (para errores de tiempo de ejecución y otros mensajes).
La interfaz XMessageHandler consta de un método de informe simple que tiene los parámetros siguientes:
level
Uno de los enumeradores siguientes definido en la interfaz XMessageHandler:
INFO
Indica que el error solamente es informativo y no afectará al resultado.

También se utiliza para la instrucción de mensajes XSLT cuando el atributo de terminación se evalúa en "no."

AVISO
Indica un aviso

El procesador se recupera de una situación de aviso, pero es posible que el resultado no sea lo que se esperaba.

ERROR
Indica un error recuperable

El procesador puede recuperarse de este error con el fin de señalar otros errores, pero no se genera ningún resultado.

FATAL_ERROR
Indica un error no recuperable

El procesador no puede recuperarse de este error. También se utilizar para la instrucción de mensajes XSLT cuando el atributo de terminación se evalúa en "yes."

TRACE
Indica que el mensaje se ha generado a partir de una llamada a la función XPath fn:trace
message
Mensaje de error
ubicación
Ubicación de origen como XSourceLocation, si está disponible

En general, la ubicación de origen no está disponible para errores de tiempo de ejecución.

cause
Excepción original que ha causado el error, si está disponible

Si el documento de entrada no es válido, por ejemplo, el analizador XML genera una excepción que pasa al método de informe a través de este parámetro.

errorItems
Elementos que se han especificado para el parámetro error-objeto en la función XPath fn:error

La implementación de XMessageHandler puede presentar los errores y otros mensajes según se desee, como por ejemplo grabar los mensajes en un archivo de registro en lugar de enviarlos a System.err. También puede tener un comportamiento más estricto y detener la compilación o la ejecución después de un error, incluidos los errores recuperables, generando una excepción. Puesto que el método de importación no tiene cláusula throws, la excepción debe estar desactivada. La implementación también puede ignorar los mensajes informativos y de aviso. Es decir, el registro de XMessageHandler permite que la aplicación configure el manejo de mensajes para que se ajuste a sus propósitos.

Observe que en el caso de un error no recuperable, si el manejador de mensajes registrados no genera ninguna excepción, el procesador alcanzará la situación XProcessException.


Icon that indicates the type of topic Task topic



Timestamp icon Last updated: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=txml_error_handler
File name: txml_error_handler.html