Différences des versions de SAAJ

L'interface SAAJ (SOAP with Attachments API for Java™) version 1.3 développe la prise en charge des messages SOAP 1.2 dans un environnement de services Web. Il existe plusieurs différences entre SAAJ 1.2 et SAAJ 1.3 ; elles sont présentées dans cette rubrique.

Dans un environnement de services Web standard, vous comptez sur le code sous-jacent basé sur des normes Java pour convertir un ensemble d'objets Java. L'interface SAAJ fournit des API qui permettent de lire, d'écrire et d'envoyer et de recevoir des messages SOAP et préconise le contenu binaire envoyé sous forme de pièce jointe à un message SOAP.

L'interface SAAJ 1.3 s'aligne sur les messages SOAP 1.1 et SOAP 1.2 et est prise en charge par le modèle de programmation JAX-WS (Java API for XML Web Services) et le modèle de programmation JAX-RPC (Java API for XML-Based RPC). SAAJ 1.2 ne gère que les messages SOAP 1.1.

Si vous faites migrer votre code de SOAP 1.1 vers SOAP 1.2, vous pouvez continuer d'utiliser votre code SOAP 1.1 existant, si le message est un message SOAP 1.2. Si vous mettez à niveau votre code de base pour utiliser SAAJ 1.3, vous pouvez continuer d'utiliser le code existant qui fonctionne sur un message SOAP 1.1. Un exemple de ces différences se trouve dans SOAP 1.1 où le texte lisible d'une erreur est stocké dans l'élément faultString. Dans SOAP 1.2, le texte lisible est stocké dans l'élément Reason. Votre code peut être similaire à l'exemple suivant :
String text = soapFault.getFaultString();
getFaultString () renvoie la valeur faultString si le message est basé sur SOAP 1.1. Si vous utilisez SOAP 1.2, getFaultString () renvoie la valeur Reason. En outre, l'interface SAAJ 1.3 fournit une nouvelle méthode, getReasonText (Locale), qui extrait une valeur Reason spécifique. La méthode getReasonText (Locale) renvoie une exception documentée si le message est basé sur SOAP 1.1. L'interface SAAJ 1.3 prend en charge le code existant pour traiter les messages SOAP 1.1 et SOAP 1.2.

Les autres différences entre SAAJ 1.2 et SAAJ 1.3 sont présentées dans la liste suivante :

Pour obtenir la liste complète des normes et spécifications prises en charge, voir les spécifications des services Web et la documentation des API.


Icône indiquant le type de rubrique Rubrique de concept



Icône d'horodatage Dernière mise à jour: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=cwbs_saajverdiffs
Nom du fichier : cwbs_saajverdiffs.html