Manejo de Errores
Errores
Ocasionalmente algo irá mal en el lado del servidor, tanto si es debido a una implementación errónea del servidor, una mála solicitud del cliente, o quizás sólo dificultades en operaciones normales. La especificación SOAP proporciona la comuniciacón de estos errores a través del elemento SOAP Fault body dentro del SOAP Envelope. El servidor Apache SOAP intentará capturar un estado de error y luego construir un mensaje de fallo SOAP que contiene un conjunto de información base sobre el error ocurrido. Sin embargo, alguna veces es útil aumentar la información de fallos para un servicio particular o para realizar una o más tareas adicionales cuando se alcanza el estado de error. Para permitir este tipo de flexibilidad, el servidor Apache SOAP proporciona un mecanismo de manejo de errores conectable con el que se podrían registrar uno o más oyentes de Fault para procesar los errores. (Este mecanismo de control de errores conectable de Apache SOAP funciona sobre el modelo evento/oyente).
Apache SOAP proporciona dos manejadores de fallos básicos:
- org.apache.soap.server.DOMFaultListener
- org.apache.soap.server.ExceptionFaultListner
Los dos mejoran el mensaje SOAP Fault con información adicional sobre el fallo, el primero añadiendo un elemento DOM que representa la excepción raíz ocurrida, y el segundo envolviendo la excepción raíz en un Parameter. La mayoría de la gente encontrará más útil la primera.
Registrar Manejadores de Fallos
Los manejadores de fallos se registran incluyendo uno más elementos <faultListener> en el descriptor de despliegue de un servicio. Para más información sobre la adición de manejadores de errores en el descriptor de despliegue, mira aquí.
Crear Nuevos Manejadores de Fallos
La creación de un nuevo manejador de fallos es tan simple como crear una clase Java que implemente el interface org.apache.soap.server.SOAPFaultListener. El único método que necesitamos implementar fault, acepta un SOAPFaultEvent. El SOAPFaultEvent envuelve los objetos SOAP Fault y SOAP Exception que fueron creados en el error. Una vez que hemos creado el manejador de error, necesitaremos registrarlo como se indica arriba.
Tutoriales
