|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Objectcom.sun.xml.ws.encoding.MtomCodec
public class MtomCodec
Mtom message Codec. It can be used even for non-soap message's mtom encoding.
Nested Class Summary | |
---|---|
static class |
MtomCodec.ByteArrayBuffer
|
static class |
MtomCodec.MtomStreamWriterImpl
|
static class |
MtomCodec.MtomXMLStreamReaderEx
|
Field Summary | |
---|---|
protected WSFeatureList |
features
|
protected Codec |
mimeRootCodec
|
static java.lang.String |
MULTIPART_RELATED_MIME_TYPE
|
protected SOAPVersion |
version
|
static java.lang.String |
XOP_XML_MIME_TYPE
|
Method Summary | |
---|---|
MtomCodec |
copy()
Creates a copy of this Codec . |
void |
decode(java.io.InputStream in,
java.lang.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(java.nio.channels.ReadableByteChannel in,
java.lang.String contentType,
Packet packet)
|
static java.lang.String |
determinePacketEncoding(Packet packet)
|
ContentType |
encode(Packet packet,
java.io.OutputStream out)
Encodes an XML infoset portion of the Message
(from <soap:Envelope> to </soap:Envelope>). |
ContentType |
encode(Packet packet,
java.nio.channels.WritableByteChannel buffer)
The version of Codec.encode(Packet,OutputStream)
that writes to NIO ByteBuffer . |
static java.lang.String |
getActionParameter(Packet packet,
SOAPVersion version)
|
protected Codec |
getMimeRootCodec(Packet packet)
|
java.lang.String |
getMimeType()
Get the MIME type associated with this Codec. |
static java.lang.String |
getSOAPXopContentType(java.lang.String encoding,
SOAPVersion version,
java.lang.String actionParameter)
|
ContentType |
getStaticContentType(Packet packet)
Return the soap 1.1 and soap 1.2 specific XOP packaged ContentType |
static ContentType |
getStaticContentTypeStatic(Packet packet,
SOAPVersion version)
|
static void |
writeAsAscii(java.lang.String s,
java.io.OutputStream out)
Writes a string as ASCII string. |
static void |
writeln(java.io.OutputStream out)
|
static void |
writeln(java.lang.String s,
java.io.OutputStream out)
|
static void |
writeMimeHeaders(java.lang.String contentType,
java.lang.String contentId,
java.io.OutputStream out)
|
Methods inherited from class java.lang.Object |
---|
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
Field Detail |
---|
public static final java.lang.String XOP_XML_MIME_TYPE
public static final java.lang.String MULTIPART_RELATED_MIME_TYPE
protected Codec mimeRootCodec
protected final SOAPVersion version
protected final WSFeatureList features
Method Detail |
---|
public ContentType getStaticContentType(Packet packet)
getStaticContentType
in interface Codec
public static ContentType getStaticContentTypeStatic(Packet packet, SOAPVersion version)
public ContentType encode(Packet packet, java.io.OutputStream out) throws java.io.IOException
Codec
Message
(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 Codec
out
- Must not be null. The caller is responsible for closing the stream,
not the callee.
java.io.IOException
- if a OutputStream
throws IOException
.public static java.lang.String getSOAPXopContentType(java.lang.String encoding, SOAPVersion version, java.lang.String actionParameter)
public static java.lang.String getActionParameter(Packet packet, SOAPVersion version)
public static void writeMimeHeaders(java.lang.String contentType, java.lang.String contentId, java.io.OutputStream out) throws java.io.IOException
java.io.IOException
public ContentType encode(Packet packet, java.nio.channels.WritableByteChannel buffer)
Codec
Codec.encode(Packet,OutputStream)
that writes to NIO ByteBuffer
.
TODO: for the convenience of implementation, write
an adapter that wraps WritableByteChannel
to OutputStream
.
public MtomCodec copy()
Codec
Codec
.
Since Codec
instance is not re-entrant, the caller
who needs to encode two Message
s 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 Codec
Codec
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 Codec
s 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 java.io.IOException
Packet
from a MimeMultipartParser
.
java.io.IOException
public static java.lang.String determinePacketEncoding(Packet packet)
public java.lang.String getMimeType()
Codec
If 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 Codec
Codec
implementation. Otherwise the MIME type is returned.protected Codec getMimeRootCodec(Packet packet)
public void decode(java.io.InputStream in, java.lang.String contentType, Packet packet) throws java.io.IOException
Codec
InputStream
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 Codec
in
- 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
.
java.io.IOException
- if InputStream
throws an exception.public void decode(java.nio.channels.ReadableByteChannel in, java.lang.String contentType, Packet packet)
decode
in interface Codec
Codec.decode(InputStream, String, Packet)
public static void writeln(java.lang.String s, java.io.OutputStream out) throws java.io.IOException
java.io.IOException
public static void writeAsAscii(java.lang.String s, java.io.OutputStream out) throws java.io.IOException
java.io.IOException
public static void writeln(java.io.OutputStream out) throws java.io.IOException
java.io.IOException
|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |