org.apache.cxf.ws.addressing.soap
Class VersionTransformer

java.lang.Object
  org.apache.cxf.ws.addressing.VersionTransformer
      org.apache.cxf.ws.addressing.soap.VersionTransformer

public class VersionTransformer
extends VersionTransformer

This class is responsible for transforming between the native WS-Addressing schema version (i.e. 2005/08) and exposed version (currently may be 2005/08 or 2004/08).

The native version is that used throughout the stack, were the WS-A types are represented via the JAXB generated types for the 2005/08 schema.

The exposed version is that used when the WS-A types are externalized, i.e. are encoded in the headers of outgoing messages. For outgoing requests, the exposed version is determined from configuration. For outgoing responses, the exposed version is determined by the exposed version of the corresponding request.

The motivation for using different native and exposed types is usually to facilitate a WS-* standard based on an earlier version of WS-Adressing (for example WS-RM depends on the 2004/08 version).

HEADERS

public static final Set<QName> HEADERS

codec

protected MAPCodec codec

VersionTransformer

public VersionTransformer(MAPCodec mapCodec)

Constructor.

Parameters:

mapCodec - the MAPCodec to use

encodeAsExposed

public <T> void encodeAsExposed(String exposeAs,
                                T value,
                                String localName,
                                Class<T> clz,
                                Element header,
                                javax.xml.bind.Marshaller marshaller)
                     throws javax.xml.bind.JAXBException

Encode message in exposed version.

Parameters:

exposeAs - specifies the WS-Addressing version to expose

value - the value to encode

localName - the localName for the header

clz - the class

header - the SOAP header element

marshaller - the JAXB marshaller to use

Throws:

javax.xml.bind.JAXBException

decodeAsNative

public <T> T decodeAsNative(String encodedAs,
                            Class<T> clz,
                            Element headerElement,
                            javax.xml.bind.Unmarshaller unmarshaller)
                 throws javax.xml.bind.JAXBException

Decodes a MAP from a exposed version.

Parameters:

encodedAs - specifies the encoded version

clz - the class

headerElement - the SOAP header element

marshaller - the JAXB marshaller to use

Returns:

the decoded value

Throws:

javax.xml.bind.JAXBException