Package org.springframework.ws.soap.server

Class SoapMessageDispatcher

java.lang.Object

org.springframework.ws.server.MessageDispatcher

org.springframework.ws.soap.server.SoapMessageDispatcher

All Implemented Interfaces:

org.springframework.beans.factory.Aware, org.springframework.beans.factory.BeanNameAware, org.springframework.context.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

Fields

Modifier and Type	Field	Description
static final 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

Constructors

Constructor	Description
SoapMessageDispatcher()

Method Summary

Modifier and Type	Method	Description
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 Details

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 Details

SoapMessageDispatcher

public SoapMessageDispatcher()

Method Details

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)