org.apache.axis2.jaxws.handler
Class HandlerUtils

java.lang.Object
  org.apache.axis2.jaxws.handler.HandlerUtils

public class HandlerUtils
extends Object

Constructor Summary

HandlerUtils()

Method Summary

static void	checkMustUnderstand(MessageContext msgContext, List<QName> understood, List<String> additionalRoles) checkMustUnderstand will validate headers that where delegated by Axis Engine to MessageReceiver for mustUnderstand check.
static boolean	isHighFidelity(MessageContext mc) isHighFidelity The JAX-WS engine attempts to stream data as fast as possible.
static List<QName>	registerSOAPHandlerHeaders(MessageContext msgContext, List<Handler> handlers) registerHandlerHeaders will invoke getHeaders on SOAPHandlers and return a List of headers that are Understood by the handlers.

Methods inherited from class java.lang.Object

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

Constructor Detail

HandlerUtils

public HandlerUtils()

Method Detail

registerSOAPHandlerHeaders

public static List<QName> registerSOAPHandlerHeaders(MessageContext msgContext,
                                                     List<Handler> handlers)

registerHandlerHeaders will invoke getHeaders on SOAPHandlers and return a List of headers that are Understood by the handlers.

Parameters:

msgContext -

handlers -

checkMustUnderstand

public static void checkMustUnderstand(MessageContext msgContext,
                                       List<QName> understood,
                                       List<String> additionalRoles)
                                throws AxisFault

checkMustUnderstand will validate headers that where delegated by Axis Engine to MessageReceiver for mustUnderstand check. Note that there is other JAX-WS related mustUnderstand checking occuring elsewhere:

Parameters:

msgContext - Contains the SOAPEnvelope and optionally a list of headers not understood by the AxisEngine

understood - A list of header QNames understood by JAX-WS, for example those understood by associated application handlers. Can be null.

additionalRoles - An instance of RolePlayer for any addtional roles played by JAX-WS for example, roles configured for associated handlers. Can be null.

Throws:

AxisFault - if any headers marked mustUndersand are not understood.

See Also:

MustUnderstandValidationDispatcher, MustUnderstandChecker

isHighFidelity

public static boolean isHighFidelity(MessageContext mc)

isHighFidelity The JAX-WS engine attempts to stream data as fast as possible. For example, the message payload may be transformed into a JAXB object early in the processing. Unfortunately such transformations are lossy, some information is lost. An installed SOAP handler will see different namespaces (etc) then the original message. If the a customer enables the "jaxws.payload.highFidelity" flag, then lossy transformations are avoided until necessary.

Parameters:

mc -

Returns:

true if high fidelity is requested

See Also:

Constants.JAXWS_HIGH_FIDELITY