Diferenças nas Versões de SAAJ

A interface SOAP with Attachments API for Java™ (SAAJ) Versão 1.3 expande o suporte das mensagens SOAP 1.2 em um ambiente de serviços da Web. Há várias diferenças entre o SAAJ 1.2 e o SAAJ 1.3 que são apresentadas neste tópico.

Em um ambiente típico de serviços da Web, você depende do código subjacente que tem como base as normas Java para converter um conjunto de objetos Java. A interface SAAJ fornece as APIs para ler, gravar, enviar e receber mensagens SOAP e defende o conteúdo binário enviado como um anexo a uma mensagem SOAP.

O SAAJ 1.3 alinha-se com as mensagens SOAP 1.1 e SOAP 1.2 e é suportado pelo modelo de programação JAX-WS (Java API for XML Web Services) e o modelo de programação JAX-RPC (Java API for XML-Based RPC). O SAAJ 1.2 trabalha apenas com mensagens SOAP 1.1.

Se você migrar seu código de SOAP 1.1 para SOAP 1.2, poderá continuar a usar o código existente de SOAP 1.1, se a mensagem for de SOAP 1.2. Se você fizer o upgrade do código base para usar o SAAJ 1.3, poderá continuar a usar o código existente que opera em uma mensagem de SOAP 1.1. Um exemplo dessas diferenças está no SOAP 1.1, onde o texto de uma falha legível por pessoas é armazenado no elemento faultString. No SOAP 1.2, o texto legível por pessoas é armazenado no elemento Reason. O código pode ser semelhante ao seguinte exemplo:
String text = soapFault.getFaultString();
O getFaultString () retornará o valor de faultString, se a mensagem for baseada no SOAP 1.1. Se você estiver usando o SOAP 1.2, o getFaultString () retornará o valor Reason. Além disso, a interface SAAJ 1.3 fornece um novo método, getReasonText (Código do Idioma), que obtém um valor Reason específico. O método getReasonText (Código do Idioma) retornará uma exceção documentada, se a mensagem for baseada no SOAP 1.1. A interface SAAJ 1.3 suporta o código existente para processar as mensagens de SOAP 1.1 e SOAP 1.2.

Outras diferenças entre o SAAJ 1.2 e o SAAJ 1.3 estão na lista a seguir:

Para obter uma lista completa de padrões e especificações suportados, consulte as especificações de serviços da Web e a documentação da API.


Ícone que indica o tipo de tópico Tópico de Conceito



Ícone de registro de data e hora Última atualização: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=cwbs_saajverdiffs
Nome do arquivo: cwbs_saajverdiffs.html