mq5.0-source.main.jaxm-api.src.main.java.javax.xml.messaging.package.html Maven / Gradle / Ivy
Provides the API for using a messaging provider to send and receive
SOAP messages. This package is specified in the
JavaTM API for XML Messaging (JAXM)
1.1 specification.
A client using JavaTM
API for XML Messaging technology ("JAXM client") makes its connections
to a messaging provider, which means that
all messages it sends or receives go through the provider.
The messaging provider is responsible for the delivery of messages,
performing many functions behind the scenes. With a messaging provider, it
is possible to send a message to multiple destinations, and a messaging
provider can be configured to do the following:
- maintain a list of endpoints to which messages will be sent
- send, and if necessary, resend a message until the message is delivered
successfully or until the specified limit for retries is reached
- log messages in a specified directory
In addition, a messaging provider can make it possible for a protocol such
as ebXML or SOAP RP to operate on top of SOAP, extending the Quality of
Service available to JAXM messages.
The API in the javax.xml.messaging
package makes it
possible to do one-way messaging.
One-way messaging allows the client to send a message
and immediately go on to other work because the
response, if there is one, will be sent as a separate operation at
some time in the future.
The javax.xml.messaging
package must always work in conjunction
with the javax.xml.soap
package, which provides the
API for constructing SOAP messages and retreiving their content.
(The javax.xml.soap
package is
defined in the SOAP with Attachments API for
JavaTM (SAAJ) 1.1 specification.)
Package Specification
The JAXM 1.1 specification includes an overview of the
javax.xml.messaging
package and
explains how its classes and interfaces work.