Package org.springframework.ws.server.endpoint

Class AbstractEndpointExceptionResolver

java.lang.Object

org.springframework.ws.server.endpoint.AbstractEndpointExceptionResolver

All Implemented Interfaces:

org.springframework.core.Ordered, EndpointExceptionResolver

Direct Known Subclasses:

AbstractSoapFaultDefinitionExceptionResolver, SimpleSoapExceptionResolver

public abstract class AbstractEndpointExceptionResolver
extends Object
implements EndpointExceptionResolver, org.springframework.core.Ordered

Abstract base class for EndpointExceptionResolvers.

Provides a set of mapped endpoints that the resolver should map.

Since:

1.0.0

Field Summary

Fields

Modifier and Type	Field	Description
protected final org.apache.commons.logging.Log	logger	Shared Log for subclasses to use.

Fields inherited from interface org.springframework.core.Ordered

HIGHEST_PRECEDENCE, LOWEST_PRECEDENCE

Constructor Summary

Constructors

Constructor	Description
AbstractEndpointExceptionResolver()

Method Summary

Modifier and Type	Method	Description
protected String	buildLogMessage(MessageContext messageContext, Exception ex)	Build a log message for the given exception, occured during processing the given message context.
final int	getOrder()
protected void	logException(MessageContext messageContext, Exception ex)	Log the given exception at warn level, provided that warn logging has been activated through the "warnLogCategory" property.
final boolean	resolveException(MessageContext messageContext, @Nullable Object endpoint, Exception ex)	Default implementation that checks whether the given endpoint is in the set of mapped endpoints.
protected abstract boolean	resolveExceptionInternal(MessageContext messageContext, @Nullable Object endpoint, Exception ex)	Template method for resolving exceptions that is called by EndpointExceptionResolver.resolveException(org.springframework.ws.context.MessageContext, java.lang.Object, java.lang.Exception).
void	setMappedEndpoints(Set<?> mappedEndpoints)	Specify the set of endpoints that this exception resolver should map.
final void	setOrder(int order)	Specify the order value for this mapping.
void	setWarnLogCategory(String loggerName)	Set the log category for warn logging.

Methods inherited from class java.lang.Object

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

Field Details

logger

protected final org.apache.commons.logging.Log logger

Shared Log for subclasses to use.

Constructor Details

AbstractEndpointExceptionResolver

public AbstractEndpointExceptionResolver()

Method Details

setMappedEndpoints

public void setMappedEndpoints(Set<?> mappedEndpoints)

Specify the set of endpoints that this exception resolver should map.

The exception mappings and the default fault will only apply to the specified endpoints.

If no endpoints are set, both the exception mappings and the default fault will apply to all handlers. This means that a specified default fault will be used as fallback for all exceptions; any further EndpointExceptionResolvers in the chain will be ignored in this case.

setWarnLogCategory

public void setWarnLogCategory(String loggerName)

Set the log category for warn logging. The name will be passed to the underlying logger implementation through Commons Logging, getting interpreted as log category according to the logger's configuration.

Default is no warn logging. Specify this setting to activate warn logging into a specific category. Alternatively, override the logException(org.springframework.ws.context.MessageContext, java.lang.Exception) method for custom logging.

setOrder

public final void setOrder(int order)

Specify the order value for this mapping.

Default value is Integer.MAX_VALUE, meaning that it's non-ordered.

See Also:

• Ordered.getOrder()

getOrder

public final int getOrder()

Specified by:

getOrder in interface org.springframework.core.Ordered

resolveException

public final boolean resolveException(MessageContext messageContext,
 @Nullable Object endpoint,
 Exception ex)

Default implementation that checks whether the given endpoint is in the set of mapped endpoints.

Specified by:

resolveException in interface EndpointExceptionResolver

Parameters:

messageContext - current message context

endpoint - the executed endpoint, or null if none chosen at the time of the exception

ex - the exception that got thrown during endpoint execution

Returns:

true if resolved; false otherwise

See Also:

• resolveExceptionInternal(MessageContext, Object, Exception)

logException

protected void logException(MessageContext messageContext,
 Exception ex)

Log the given exception at warn level, provided that warn logging has been activated through the "warnLogCategory" property.

Calls buildLogMessage(org.springframework.ws.context.MessageContext, java.lang.Exception) in order to determine the concrete message to log. Always passes the full exception to the logger.

Parameters:

messageContext - current message context request

ex - the exception that got thrown during handler execution

See Also:

• setWarnLogCategory(java.lang.String)
• buildLogMessage(org.springframework.ws.context.MessageContext, java.lang.Exception)
• Log.warn(Object, Throwable)

buildLogMessage

protected String buildLogMessage(MessageContext messageContext,
 Exception ex)

Build a log message for the given exception, occured during processing the given message context.

Parameters:

messageContext - the message context

ex - the exception that got thrown during handler execution

Returns:

the log message to use

resolveExceptionInternal

protected abstract boolean resolveExceptionInternal(MessageContext messageContext,
 @Nullable Object endpoint,
 Exception ex)

Template method for resolving exceptions that is called by EndpointExceptionResolver.resolveException(org.springframework.ws.context.MessageContext, java.lang.Object, java.lang.Exception).

Parameters:

messageContext - current message context

endpoint - the executed endpoint, or null if none chosen at the time of the exception

ex - the exception that got thrown during endpoint execution

Returns:

true if resolved; false otherwise

See Also:

• EndpointExceptionResolver.resolveException(MessageContext, Object, Exception)