SAAJ SOAP message factory
Factory for creating SOAP messages using SAAJ (SOAP with Attachments API for Java).
SAAJ (SOAP with Attachments API for Java) specific implementation of the WebServiceMessageFactory. Uses SOAP version 1.1 by default, but can be configured to use SOAP version 1.2 instead.
This factory will use SAAJ 1.3 when found, or fall back to SAAJ 1.2 or even 1.1.
SOAP version
Which SOAP version this factory will use. Default is SOAP 1.1.
Even though both versions of SOAP are quite similar in format, the 1.2 version is not backwards compatible with 1.1. The main differences are:
- XML namespace:
"http://schemas.xmlsoap.org/soap/envelope/"
(SOAP 1.1) vs"http://www.w3.org/2003/05/soap-envelope"
(SOAP 1.2) - Content-Type HTTP header:
"text/xml"
(SOAP 1.1) vs"application/soap+xml"
(SOAP 1.2) - <soap:Fault>: the structure of this XML element is different
- SOAPAction HTTP header: no longer used by SOAP 1.2
One important thing to note with SOAP version numbers, or WS-* specification version numbers in general, is that the latest version of a specification is generally not the most popular version. For SOAP, this means that currently, the best version to use is 1.1. Version 1.2 might become more popular in the future, but currently 1.1 is the safest bet.
Lang attribute on SOAP 1.1 Fault string
Whether a xml:lang
attribute should be set on SOAP 1.1 <faultstring>
elements.
The default is true to comply with WS-I, but this flag can be set to false for the older W3C SOAP 1.1 specification.
Id
Name that uniquely identifies this flow component.
Required