Package com.sun.xml.ws.api.pipe

Class Codecs

java.lang.Object

com.sun.xml.ws.api.pipe.Codecs

public abstract class Codecs
extends Object

Factory methods for some of the Codec implementations.

This class provides methods to create codecs for SOAP/HTTP binding. It allows to replace default SOAP envelope(primary part in MIME message) codec in the whole Codec.

This is a part of the JAX-WS RI internal API so that Tube and transport implementations can reuse the implementations done inside the JAX-WS.

Author:

Jitendra Kotamraju, Kohsuke Kawaguchi

Constructor Summary

Constructors

Constructor	Description
Codecs()

Method Summary

Modifier and Type	Method	Description
static SOAPBindingCodec	createSOAPBindingCodec(WSBinding binding, StreamSOAPCodec xmlEnvelopeCodec)	This creates a full Codec for SOAP binding using the primary XML codec argument.
static SOAPBindingCodec	createSOAPBindingCodec(WSFeatureList feature)	This creates a full Codec for SOAP binding.
static StreamSOAPCodec	createSOAPEnvelopeXmlCodec(SOAPVersion version)	Creates a default Codec that can be used to used to decode XML infoset in SOAP envelope(primary part in MIME message).
static StreamSOAPCodec	createSOAPEnvelopeXmlCodec(WSBinding binding)	Deprecated. use createSOAPEnvelopeXmlCodec(WSFeatureList)
static StreamSOAPCodec	createSOAPEnvelopeXmlCodec(WSFeatureList features)	Creates a default Codec that can be used to used to decode XML infoset in SOAP envelope(primary part in MIME message).
static Codec	createXMLCodec(WSFeatureList feature)	This creates a full Codec for XML binding.

Methods inherited from class java.lang.Object

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

Constructor Detail

Codecs

public Codecs()

Method Detail

createSOAPBindingCodec

@NotNull
public static SOAPBindingCodec createSOAPBindingCodec(WSFeatureList feature)

This creates a full Codec for SOAP binding.

Parameters:

feature - the WebServiceFeature objects

Returns:

non null codec to parse entire SOAP message(including MIME parts)

createXMLCodec

@NotNull
public static Codec createXMLCodec(WSFeatureList feature)

This creates a full Codec for XML binding.

Parameters:

feature - the WebServiceFeature objects

Returns:

non null codec to parse entire XML message.

createSOAPBindingCodec

@NotNull
public static SOAPBindingCodec createSOAPBindingCodec(WSBinding binding,
                                                      StreamSOAPCodec xmlEnvelopeCodec)

This creates a full Codec for SOAP binding using the primary XML codec argument. The codec argument is used to encode/decode SOAP envelopes while the returned codec is responsible for encoding/decoding the whole message.

Creates codecs can be set during the Tubeline assembly process.

Parameters:

binding - binding of the webservice

xmlEnvelopeCodec - SOAP envelope codec

Returns:

non null codec to parse entire SOAP message(including MIME parts)

See Also:

ServerTubeAssemblerContext.setCodec(Codec), ClientTubeAssemblerContext.setCodec(Codec)

createSOAPEnvelopeXmlCodec

@NotNull
public static StreamSOAPCodec createSOAPEnvelopeXmlCodec(@NotNull
                                                         SOAPVersion version)

Creates a default Codec that can be used to used to decode XML infoset in SOAP envelope(primary part in MIME message). New codecs can be written using this codec as delegate.

Parameters:

version - SOAP version of the binding

Returns:

non null default xml codec

createSOAPEnvelopeXmlCodec

@NotNull
public static StreamSOAPCodec createSOAPEnvelopeXmlCodec(@NotNull
                                                         WSBinding binding)

Deprecated.

use createSOAPEnvelopeXmlCodec(WSFeatureList)

Creates a default Codec that can be used to used to decode XML infoset in SOAP envelope(primary part in MIME message). New codecs can be written using this codec as delegate. WSBinding parameter is used to get SOAP version and features.

Parameters:

binding - SOAP version and features are used from this binding

Returns:

non null default xml codec

createSOAPEnvelopeXmlCodec

@NotNull
public static StreamSOAPCodec createSOAPEnvelopeXmlCodec(@NotNull
                                                         WSFeatureList features)

Creates a default Codec that can be used to used to decode XML infoset in SOAP envelope(primary part in MIME message). New codecs can be written using this codec as delegate. WSFeatureList parameter is used to get SOAP version and features.

Parameters:

features - SOAP version and features are used from this WSFeatureList

Returns:

non null default xml codec