The
SOAP with Attachments API for JavaTM
(SAAJ) 1.3 provides the API for creating and sending SOAP messages by
means of
the javax.xml.soap
package. It is used for the SOAP
messaging that goes on behind the scenes in JAX-RPC and JAXR
implementations. Developers can also use it to write SOAP messaging
applications directly instead of using JAX-RPC.
javax.xml.messaging
package, defined in
the Java API for XML Messaging (JAXM) 1.1 specification, is not part of
the Java Web Services Developer Pack. The JAXM API is available as a
separate download from http://java.sun.com/webservices/jaxm/docs.html/
.
The SAAJ API allows a client to send messages directly to the
ultimate recipient using a SOAPConnection
object, which
provides a point-to-point connection to the intended recipient.
Response messages
are received synchronously using a request-response
model.
SOAPConnection
(and its related classes) is a pure library
implementation that lets you send SOAP messages directly to a remote
party. A standalone client, that is, one that does not run in a
container
such as a servlet, must include client-side libraries in its CLASSPATH.
This model is simple to get started but has limited possibilities for
reliability and message delivery guarantees. For instance, the
point-to-point message exchange model relies largely on the reliability
of the underlying transport for delivering a message.
Please send feedback on this SAAJ 1.3 release to jwsdp-feedback@sun.com.