Diferencias en las versiones de SAAJ

La interfaz SAAJ (SOAP with Attachments API for Java™) Versión 1.3 amplía el soporte de los mensajes SOAP 1.2 en un entorno de servicios web. Existen varias diferencias entre SAAJ 1.2 y SAAJ 1.3 que se describen en este tema.

En un entorno de servicios web típico, se utiliza el código subyacente que se basa en estándares Java para convertir un conjunto de objetos Java. La interfaz SAAJ proporciona API para leer, escribir, enviar y recibir mensajes SOAP, y protege el contenido binario enviado como documento adjunto en un mensaje SOAP.

SAAJ 1.3 se alinea con los mensajes SOAP 1.1 y SOAP 1.2, y está soportado por el modelo de programación JAX-WS (Java API for XML Web Services) y el modelo de programación JAX-RPC (Java API for XML-Based RPC). SAAJ 1.2 sólo funciona con los mensajes SOAP 1.1.

Si migra el código de SOAP 1.1 a SOAP 1.2, puede continuar utilizando el código SOAP 1.1 existente, si el mensaje es un mensaje SOAP 1.2. Si actualiza el código base para utilizar SAAJ 1.3, puede continuar utilizando el código existente que opera en un mensaje SOAP 1.1. Un ejemplo de estas diferencias se encuentra en SOAP 1.1, donde el texto legible de una anomalía se almacena en el elemento faultString. En SOAP 1.2, el texto legible se almacena en el elemento Reason. El código puede ser parecido al siguiente ejemplo:
String text = soapFault.getFaultString();
getFaultString () devuelve el valor faultString si el mensaje está basado en SOAP 1.1. Si utiliza SOAP 1.2, getFaultString () devuelve el valor Reason. Asimismo, la interfaz SAAJ 1.3 proporciona un nuevo método, getReasonText (Locale), que obtiene un valor Reason específico. El método getReasonText (Locale) devuelve una excepción documentada si el mensaje se basa en SOAP 1.1. La interfaz SAAJ 1.3 da soporte al código existente para procesar mensajes SOAP 1.1 y SOAP 1.2.

Existen otras diferencias entre SAAJ 1.2 y SAAJ 1.3 que se describen en la siguiente lista:

Para obtener una lista completa de los estándares y las especificaciones a los que se da soporte, consulte las especificaciones y la documentación de la API de los servicios Web.


Icon that indicates the type of topic Concept topic



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