org.springframework.ws.soap.server
Class SoapMessageDispatcher

java.lang.Object
  org.springframework.ws.server.MessageDispatcher
      org.springframework.ws.soap.server.SoapMessageDispatcher

All Implemented Interfaces:

Aware, BeanNameAware, ApplicationContextAware, WebServiceMessageReceiver

public class SoapMessageDispatcher
extends MessageDispatcher

SOAP-specific subclass of the MessageDispatcher. Adds functionality for adding actor roles to a endpoint invocation chain, and endpoint interception using SoapEndpointInterceptor objects.

Since:

1.0.0

Author:

Arjen Poutsma

See Also:

SoapMessage, SoapEndpointInterceptor

Field Summary

static String

DEFAULT_MUST_UNDERSTAND_FAULT_STRING Default message used when creating a SOAP MustUnderstand fault.

Fields inherited from class org.springframework.ws.server.MessageDispatcher

ENDPOINT_NOT_FOUND_LOG_CATEGORY, endpointNotFoundLogger, logger, MESSAGE_TRACING_LOG_CATEGORY, receivedMessageTracingLogger, sentMessageTracingLogger

Constructor Summary

SoapMessageDispatcher()

Method Summary

protected boolean	handleRequest(EndpointInvocationChain mappedEndpoint, MessageContext messageContext) Process the headers targeted at the actor or role fullfilled by the endpoint.
void	setMustUnderstandFaultString(String mustUnderstandFaultString) Sets the message used for MustUnderstand fault.
void	setMustUnderstandFaultStringLocale(Locale mustUnderstandFaultStringLocale) Sets the locale of the message used for MustUnderstand fault.

Methods inherited from class org.springframework.ws.server.MessageDispatcher

dispatch, getEndpoint, getEndpointAdapter, getEndpointAdapters, getEndpointExceptionResolvers, getEndpointMappings, processEndpointException, receive, setApplicationContext, setBeanName, setEndpointAdapters, setEndpointExceptionResolvers, setEndpointMappings

Methods inherited from class java.lang.Object

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

Field Detail

DEFAULT_MUST_UNDERSTAND_FAULT_STRING

public static final String DEFAULT_MUST_UNDERSTAND_FAULT_STRING

Default message used when creating a SOAP MustUnderstand fault.

See Also:

Constant Field Values

Constructor Detail

SoapMessageDispatcher

public SoapMessageDispatcher()

Method Detail

setMustUnderstandFaultString

public void setMustUnderstandFaultString(String mustUnderstandFaultString)

Sets the message used for MustUnderstand fault. Default to DEFAULT_MUST_UNDERSTAND_FAULT_STRING.

setMustUnderstandFaultStringLocale

public void setMustUnderstandFaultStringLocale(Locale mustUnderstandFaultStringLocale)

Sets the locale of the message used for MustUnderstand fault. Default to Locale.ENGLISH.

handleRequest

protected boolean handleRequest(EndpointInvocationChain mappedEndpoint,
                                MessageContext messageContext)

Process the headers targeted at the actor or role fullfilled by the endpoint. Also processed the MustUnderstand headers in the incoming SOAP request message. Iterates over all SOAP headers which should be understood for this role, and determines whether these are supported. Generates a SOAP MustUnderstand fault if a header is not understood.

Overrides:

handleRequest in class MessageDispatcher

Parameters:

mappedEndpoint - the mapped EndpointInvocationChain

messageContext - the message context

Returns:

true if all necessary headers are understood; false otherwise

See Also:

SoapEndpointInvocationChain.getActorsOrRoles(), SoapHeader.examineMustUnderstandHeaderElements(String)