public class SOAPBindingCodec extends MimeCodec implements SOAPBindingCodec
Codec that can handle MTOM, SwA, and SOAP messages
encoded using XML or Fast Infoset.
This is used when we need to determine the encoding from what we received (for decoding)
and from configuration and Message contents (for encoding)
TODO: Split this Codec into two, one that supports FI and one that does not. Then further split the FI Codec into two, one for client and one for server. This will simplify the logic and make it easier to understand/maintain.
| Modifier and Type | Field and Description |
|---|---|
static String |
DEFAULT_ENCODING |
static String |
UTF8_ENCODING |
features, mimeRootCodec, MULTIPART_RELATED_MIME_TYPE, version| Constructor and Description |
|---|
SOAPBindingCodec(WSFeatureList features) |
SOAPBindingCodec(WSFeatureList features,
StreamSOAPCodec xmlSoapCodec) |
| Modifier and Type | Method and Description |
|---|---|
SOAPBindingCodec |
copy()
Creates a copy of this
Codec. |
void |
decode(InputStream in,
String contentType,
Packet packet)
Reads bytes from
InputStream and constructs a Message. |
protected void |
decode(MimeMultipartParser mpp,
Packet packet)
Parses a
Packet from a MimeMultipartParser. |
void |
decode(ReadableByteChannel in,
String contentType,
Packet packet) |
ContentType |
encode(Packet packet,
OutputStream out)
Encodes an XML infoset portion of the
Message
(from <soap:Envelope> to </soap:Envelope>). |
ContentType |
encode(Packet packet,
WritableByteChannel buffer)
The version of
Codec.encode(Packet,OutputStream)
that writes to NIO ByteBuffer. |
String |
getMimeType()
Get the MIME type associated with this Codec.
|
ContentType |
getStaticContentType(Packet packet)
If the MIME content-type of the encoding is known statically
then this method returns it.
|
StreamSOAPCodec |
getXMLCodec() |
getMimeRootCodec, writeAsAscii, writeln, writelnpublic static final String UTF8_ENCODING
public static final String DEFAULT_ENCODING
public SOAPBindingCodec(WSFeatureList features)
public SOAPBindingCodec(WSFeatureList features, StreamSOAPCodec xmlSoapCodec)
public StreamSOAPCodec getXMLCodec()
getXMLCodec in interface SOAPBindingCodecpublic String getMimeType()
CodecIf available the MIME type will represent the media that the codec encodes and decodes. The MIME type returned will be the most general representation independent of an instance of this MIME type utilized as a MIME content-type.
getMimeType in interface CodecgetMimeType in class MimeCodecCodec
implementation. Otherwise the MIME type is returned.public ContentType getStaticContentType(Packet packet)
Codec
Transports often need to write the content type before it writes
the message body, and since the encode method returns the content type
after the body is written, it requires a buffering.
For those Codecs that always use a constant content type,
This method allows a transport to streamline the write operation.
getStaticContentType in interface CodecgetStaticContentType in class MimeCodecPacket,
such as "application/xml".public ContentType encode(Packet packet, OutputStream out) throws IOException
CodecMessage
(from <soap:Envelope> to </soap:Envelope>).
Internally, this method is most likely invoke Message.writeTo(XMLStreamWriter)
to turn the message into infoset.
encode in interface Codecencode in class MimeCodecout - Must not be null. The caller is responsible for closing the stream,
not the callee.IOException - if a OutputStream throws IOException.public ContentType encode(Packet packet, WritableByteChannel buffer)
CodecCodec.encode(Packet,OutputStream)
that writes to NIO ByteBuffer.
TODO: for the convenience of implementation, write
an adapter that wraps WritableByteChannel to OutputStream.
public void decode(InputStream in, String contentType, Packet packet) throws IOException
CodecInputStream and constructs a Message.
The design encourages lazy decoding of a Message, where
a Message is returned even before the whole message is parsed,
and additional parsing is done as the Message body is read along.
A Codec is most likely have its own implementation of Message
for this purpose.
decode in interface Codecdecode in class MimeCodecin - the data to be read into a Message. The transport would have
read any transport-specific header before it passes an InputStream,
and InputStream is expected to be read until EOS. Never null.
Some transports, such as SMTP, may 'encode' data into another format
(such as uuencode, base64, etc.) It is the caller's responsibility to
'decode' these transport-level encoding before it passes data into
Codec.
contentType - The MIME content type (like "application/xml") of this byte stream.
Thie text includes all the sub-headers of the content-type header. Therefore,
in more complex case, this could be something like
multipart/related; boundary="--=_outer_boundary"; type="multipart/alternative".
This parameter must not be null.packet - The parsed Message will be set to this Packet.
Codec may add additional properties to this Packet.
On a successful method completion, a Packet must contain a
Message.IOException - if InputStream throws an exception.public void decode(ReadableByteChannel in, String contentType, Packet packet)
decode in interface Codecdecode in class MimeCodecCodec.decode(InputStream, String, Packet)public SOAPBindingCodec copy()
CodecCodec.
Since Codec instance is not re-entrant, the caller
who needs to encode two Messages simultaneously will
want to have two Codec instances. That's what this
method produces.
Note that this method might be invoked by one thread while
another thread is executing one of the Codec.encode(com.sun.xml.ws.api.message.Packet, java.io.OutputStream) methods.
This should be OK because you'll be only copying things that
are thread-safe, and creating new ones for thread-unsafe resources,
but please let us know if this contract is difficult.
copy in interface Codeccopy in class MimeCodecCodec that performs
the encoding work in the same way --- that is, if you
copy an FI codec, you'll get another FI codec.
Once copied, two Codecs may be invoked from
two threads concurrently; therefore, they must not share
any state that requires isolation (such as temporary buffer.)
If the Codec implementation is already
re-entrant and multi-thread safe to begin with,
then this method may simply return this.
protected void decode(MimeMultipartParser mpp, Packet packet) throws IOException
MimeCodecPacket from a MimeMultipartParser.decode in class MimeCodecIOExceptionCopyright (c) 1997-2012 Oracle and/or its affiliates. All rights reserved.