com.adaptris.core.services.exception

Class ExceptionReportService

java.lang.Object

com.adaptris.core.ServiceImp

com.adaptris.core.services.exception.ExceptionReportService

All Implemented Interfaces:

AdaptrisComponent, ComponentLifecycle, ComponentLifecycleExtension, JndiBindable, MessageEventGenerator, Service, StateManagedComponent

@ComponentProfile(summary="Generate a report based on the current exception",
                  tag="service,error-handling")
public class ExceptionReportService
extends ServiceImp

Service that takes an exception in object metadata and serializes that into the AdaptrisMessage payload.

In some scenarios (e.g. handling request reply scenarios), rather than directly handling the message exception in the adapter, it may be required to report back to the back-end application that an exception has occured along with the problem document.

See Also:

ExceptionSerializer, CoreConstants.OBJ_METADATA_EXCEPTION

In the adapter configuration file this class is aliased as exception-report-service which is the preferred alternative to the fully qualified classname when building your configuration.

Field Summary

Fields inherited from class com.adaptris.core.ServiceImp

log

Fields inherited from interface com.adaptris.core.MessageEventGenerator

CONFIRMATION_ID_KEY

Constructor Summary

Constructors

Constructor and Description
ExceptionReportService()
ExceptionReportService(ExceptionSerializer e)

Method Summary

Modifier and Type	Method and Description
protected void	closeService()
void	doService(AdaptrisMessage msg) Apply the service to the message.
ExceptionSerializer	getExceptionSerializer()
protected void	initService()
void	prepare() Prepare for initialisation.
void	setExceptionSerializer(ExceptionSerializer exceptionSerializer)

Methods inherited from class com.adaptris.core.ServiceImp

changeState, close, continueOnFailure, createName, createQualifier, getContinueOnFail, getIsTrackingEndpoint, getLookupName, getUniqueId, init, isBranching, isTrackingEndpoint, requestClose, requestInit, requestStart, requestStop, retrieveComponentState, setContinueOnFail, setIsTrackingEndpoint, setLookupName, setUniqueId, start, stop

Methods inherited from class java.lang.Object

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

Constructor Detail

ExceptionReportService

public ExceptionReportService()

ExceptionReportService

public ExceptionReportService(ExceptionSerializer e)

Method Detail

doService

public void doService(AdaptrisMessage msg)
               throws ServiceException

Description copied from interface: Service

Apply the service to the message.

Parameters:

msg - the AdaptrisMessage to process

Throws:

ServiceException - wrapping any underlying Exceptions

initService

protected void initService()
                    throws CoreException

Specified by:

initService in class ServiceImp

Throws:

CoreException

closeService

protected void closeService()

Specified by:

closeService in class ServiceImp

prepare

public void prepare()
             throws CoreException

Description copied from interface: ComponentLifecycleExtension

Prepare for initialisation.

Throws:

CoreException

getExceptionSerializer

public ExceptionSerializer getExceptionSerializer()

setExceptionSerializer

public void setExceptionSerializer(ExceptionSerializer exceptionSerializer)