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

java.lang.Object
  org.apache.cxf.phase.AbstractPhaseInterceptor<SoapMessage>
      org.apache.cxf.binding.soap.interceptor.AbstractSoapInterceptor
          org.apache.cxf.ws.addressing.soap.MAPCodec

All Implemented Interfaces:

SoapInterceptor, Interceptor<SoapMessage>, PhaseInterceptor<SoapMessage>

public class MAPCodec
extends AbstractSoapInterceptor

SOAP interceptor responsible for {en|de}coding the Message Addressing Properties for {outgo|incom}ing messages.

uncorrelatedExchanges

protected final Map<String,Exchange> uncorrelatedExchanges

REVISIT: map usage that the *same* interceptor instance is used in all chains.

MAPCodec

public MAPCodec()

Constructor.

getUncorrelatedExchanges

public Map<String,Exchange> getUncorrelatedExchanges()

getUnderstoodHeaders

public Set<QName> getUnderstoodHeaders()

Specified by:

getUnderstoodHeaders in interface SoapInterceptor

Overrides:

getUnderstoodHeaders in class AbstractSoapInterceptor

Returns:

the set of SOAP headers understood by this handler

handleMessage

public void handleMessage(SoapMessage message)

Invoked for normal processing of inbound and outbound messages.

Parameters:

message - the messsage

handleFault

public void handleFault(SoapMessage message)

Invoked when unwinding normal interceptor chain when a fault occurred.

Specified by:

handleFault in interface Interceptor<SoapMessage>

Overrides:

handleFault in class AbstractPhaseInterceptor<SoapMessage>

Parameters:

message - the messsage message

unmarshalMAPs

public AddressingProperties unmarshalMAPs(SoapMessage message)

Decode the MAPs from protocol-specific headers.

Parameters:

message - the SOAP message

the - decoded MAPs

Throws:

SOAPFaultException - if decoded MAPs are invalid

decodeAsNative

public <T> T decodeAsNative(String encodedAs,
                            Class<T> clz,
                            Element headerElement,
                            Unmarshaller unmarshaller)
                 throws 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:

JAXBException

encodeMAP

protected <T> void encodeMAP(SoapMessage message,
                             T value,
                             QName qname,
                             Class<T> clz,
                             JAXBContext ctx,
                             boolean mustUnderstand)
                  throws JAXBException

Encodes an MAP as a SOAP header.

Parameters:

message - the message to store the headers on

value - the value to encode

qname - the QName for the header

clz - the class

header - the SOAP header element

marshaller - the JAXB context to use

Throws:

JAXBException

decodeMAP

protected <T> T decodeMAP(Class<T> clz,
                          Element headerElement,
                          Unmarshaller unmarshaller)
               throws JAXBException

Decodes a MAP from a SOAP header.

Parameters:

clz - the class

headerElement - the SOAP header element

marshaller - the JAXB marshaller to use

Returns:

the decoded value

Throws:

JAXBException

getHeaderFactory

protected MAPCodec.HeaderFactory getHeaderFactory()

setHeaderFactory

protected void setHeaderFactory(MAPCodec.HeaderFactory factory)