Spring Web Services Framework

org.springframework.ws.soap.server
Class SoapMessageDispatcher

java.lang.Object
  extended by org.springframework.ws.server.MessageDispatcher
      extended by 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)

Spring Web Services Framework

Copyright © 2005-2013 The Spring Web Services Framework. All Rights Reserved.