|Modifier and Type||Method and Description|
Creates a copy of this
Encodes an XML infoset portion of the
The version of
Get the MIME type associated with this Codec.
If the MIME content-type of the encoding is known statically then this method returns it.
decode, writeAsAscii, writeln, writeln
public String getMimeType()
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.
public ContentType getStaticContentType(Packet packet)
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.
Codecs that always use a constant content type,
This method allows a transport to streamline the write operation.
public ContentType encode(Packet packet, OutputStream out) throws IOException
Message(from <soap:Envelope> to </soap:Envelope>).
Internally, this method is most likely invoke
to turn the message into infoset.
out- Must not be null. The caller is responsible for closing the stream, not the callee.
IOException- if a
public void decode(InputStream in, String contentType, Packet packet) throws IOException
InputStreamand constructs a
The design encourages lazy decoding of a
Message is returned even before the whole message is parsed,
and additional parsing is done as the
Message body is read along.
Codec is most likely have its own implementation of
for this purpose.
in- the data to be read into a
Message. The transport would have read any transport-specific header before it passes an
InputStreamis 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
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
Messagewill be set to this
Codecmay add additional properties to this
Packet. On a successful method completion, a
Packetmust contain a
InputStreamthrows an exception.
protected void decode(MimeMultipartParser mpp, Packet packet) throws IOException
Note that this method might be invoked by one thread while
another thread is executing one of the
Codec.encode(com.sun.xml.internal.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.
Codecthat 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.)
Codec implementation is already
re-entrant and multi-thread safe to begin with,
then this method may simply return this.
public static boolean requiresTransformationOfDataSource(boolean isFastInfoset, boolean useFastInfoset)