| com.sun.xml.ws.api.message |
| Message and related abstractions that represent a SOAP message. |
| Java Source File Name | Type | Comment |
| Attachment.java | Interface | Attachment. |
| AttachmentSet.java | Interface | A set of
Attachment on a
Message . |
| ExceptionHasMessage.java | Class | This class represents an Exception that needs to be marshalled
with a specific protocol wire format. |
| Header.java | Interface | A SOAP header.
A header is immutable, but unlike body it can be read
multiple times.
The
Header abstraction hides how the header
data is represented in memory; instead, it commits to
the ability to write itself to XML infoset.
When a message is received from the transport and
being processed, the processor needs to "peek"
some information of a header, such as the tag name,
the mustUnderstand attribute, and so on. |
| HeaderList.java | Class | A list of
Header s on a
Message .
This list can be modified to add headers
from outside a
Message , this is necessary
since intermediate processing layers often need to
put additional headers.
Following the SOAP convention, the order among headers
are not significant. |
| Headers.java | Class | Factory methods for various
Header implementations. |
| Message.java | Class | Represents a SOAP message.
What is a message?
A
Message consists of the following:
-
Random-accessible list of headers.
a header is a representation of an element inside
<soap:Header>.
It can be read multiple times,
can be added or removed, but it is not modifiable.
See
HeaderList for more about headers.
-
The payload of the message, which is a representation
of an element inside <soap:Body>.
the payload is streamed, and therefore it can be
only read once (or can be only written to something once.)
once a payload is used, a message is said to be consumed.
A message
Message.hasPayload() may not have any payload.
|
| Messages.java | Class | Factory methods for various
Message implementations. |
| package-info.java | | |
| Packet.java | Class | Represents a container of a
Message .
A packet can be thought of as a frame/envelope/package that wraps
a
Message . |