com.sun.xml.ws.encoding

Class SwACodec

java.lang.Object

com.sun.xml.ws.encoding.MimeCodec

com.sun.xml.ws.encoding.SwACodec

All Implemented Interfaces:

Codec

public final class SwACodec
extends MimeCodec

Codec that uses MIME/multipart as the base format.

Field Summary

Fields inherited from class com.sun.xml.ws.encoding.MimeCodec

features, mimeRootCodec, MULTIPART_RELATED_MIME_TYPE, version

Constructor Summary

Constructors

Constructor and Description
SwACodec(SOAPVersion version, WSFeatureList f, Codec rootCodec)

Method Summary

Methods

Modifier and Type	Method and Description
SwACodec	copy() Creates a copy of this Codec.
protected void	decode(MimeMultipartParser mpp, Packet packet) Parses a Packet from a MimeMultipartParser.
ContentType	encode(Packet packet, WritableByteChannel buffer) The version of Codec.encode(Packet,OutputStream) that writes to NIO ByteBuffer.

Methods inherited from class com.sun.xml.ws.encoding.MimeCodec

decode, decode, encode, getMimeRootCodec, getMimeType, getStaticContentType, writeAsAscii, writeln, writeln

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

SwACodec

public SwACodec(SOAPVersion version,
        WSFeatureList f,
        Codec rootCodec)

Method Detail

decode

protected void decode(MimeMultipartParser mpp,
          Packet packet)
               throws IOException

Description copied from class: MimeCodec

Parses a Packet from a MimeMultipartParser.

Specified by:

decode in class MimeCodec

Throws:

IOException

encode

public ContentType encode(Packet packet,
                 WritableByteChannel buffer)

Description copied from interface: Codec

The version of Codec.encode(Packet,OutputStream) that writes to NIO ByteBuffer.

TODO: for the convenience of implementation, write an adapter that wraps WritableByteChannel to OutputStream.

copy

public SwACodec copy()

Description copied from interface: Codec

Creates a copy of this Codec.

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.

Implentation Note

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.

Specified by:

copy in interface Codec

Specified by:

copy in class MimeCodec

Returns:

always non-null valid 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 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.