org.springframework.ws.soap.server.endpoint.mapping
Class DelegatingSoapEndpointMapping

java.lang.Object
  org.springframework.ws.soap.server.endpoint.mapping.DelegatingSoapEndpointMapping

All Implemented Interfaces:

InitializingBean, EndpointMapping, SoapEndpointMapping

public class DelegatingSoapEndpointMapping
extends Object
implements InitializingBean, SoapEndpointMapping

EndpointMapping implement that adds SOAP actors or roles to a delegate endpoint. Delegates to another EndpointMapping, set by delegate, and adds the actors or roles specified by actorsOrRoles.

This endpoint mapping makes it possible to set actors/roles on a specific endpoint, without making the all endpoint mappings depend on SOAP-specific functionality. For normal use, setting an actor or role on an endpoint is not required, the default 'next' role is sufficient.

It is only in a scenario when a certain endpoint act as a SOAP intermediary for another endpoint, as described in the SOAP specificication, this mapping is useful.

Since:

1.0.0

Author:

Arjen Poutsma

See Also:

SoapHeader.examineMustUnderstandHeaderElements(String), SoapVersion.getNextActorOrRoleUri()

Constructor Summary

DelegatingSoapEndpointMapping()

Method Summary

void	afterPropertiesSet()
EndpointInvocationChain	getEndpoint(MessageContext messageContext) Creates a new SoapEndpointInvocationChain based on the delegate endpoint, the delegate interceptors, and set actors/roles.
void	setActorOrRole(String actorOrRole) Sets a single SOAP actor/actorOrRole to apply to all endpoints mapped by the delegate endpoint mapping.
void	setActorsOrRoles(String[] actorsOrRoles) Sets the array of SOAP actors/actorsOrRoles to apply to all endpoints mapped by the delegate endpoint mapping.
void	setDelegate(EndpointMapping delegate) Sets the delegate EndpointMapping to resolve the endpoint with.
void	setUltimateReceiver(boolean ultimateReceiver) Indicates whether this the endpoint fulfills the SOAP 1.2 Ultimate Receiver role.

Methods inherited from class java.lang.Object

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

Constructor Detail

DelegatingSoapEndpointMapping

public DelegatingSoapEndpointMapping()

Method Detail

setDelegate

public void setDelegate(EndpointMapping delegate)

Sets the delegate EndpointMapping to resolve the endpoint with.

setActorOrRole

public final void setActorOrRole(String actorOrRole)

Description copied from interface: SoapEndpointMapping

Sets a single SOAP actor/actorOrRole to apply to all endpoints mapped by the delegate endpoint mapping.

Specified by:

setActorOrRole in interface SoapEndpointMapping

setActorsOrRoles

public final void setActorsOrRoles(String[] actorsOrRoles)

Description copied from interface: SoapEndpointMapping

Sets the array of SOAP actors/actorsOrRoles to apply to all endpoints mapped by the delegate endpoint mapping.

Specified by:

setActorsOrRoles in interface SoapEndpointMapping

setUltimateReceiver

public final void setUltimateReceiver(boolean ultimateReceiver)

Description copied from interface: SoapEndpointMapping

Indicates whether this the endpoint fulfills the SOAP 1.2 Ultimate Receiver role.

Specified by:

setUltimateReceiver in interface SoapEndpointMapping

getEndpoint

public EndpointInvocationChain getEndpoint(MessageContext messageContext)
                                    throws Exception

Creates a new SoapEndpointInvocationChain based on the delegate endpoint, the delegate interceptors, and set actors/roles.

Specified by:

getEndpoint in interface EndpointMapping

Returns:

a HandlerExecutionChain instance containing endpoint object and any interceptors, or null if no mapping is found

Throws:

Exception - if there is an internal error

See Also:

setActorsOrRoles(String[])

afterPropertiesSet

public void afterPropertiesSet()
                        throws Exception

Specified by:

afterPropertiesSet in interface InitializingBean

Throws:

Exception