com.whitestein.lsps.engine

Interface ErrorHandlingService

All Known Subinterfaces:

ErrorHandlingServiceLocal, ErrorHandlingServiceRemote

All Known Implementing Classes:

ErrorHandlingServiceBean

public interface ErrorHandlingService

Error reporting for services and model instances.

Author:

Martin Vysny

Method Summary

Modifier and Type	Method and Description
RollbackInfoList	findRollbackInfos(RollbackInfoCriteria criteria) Returns all rollback information for given agent.
ModelInstance	getErrorModelInstance(long rollbackInfoId, long errorModelInstanceId) Returns model instance at the time of exception.
RollbackInfo	getRollbackInfo(long rollbackInfoId) Retrieves a full rollback info instance.
void	removeRollbackInfo(long rollbackInfoId) Removes given rollback info.
boolean	retryOperation(long rollbackInfoId) Re-sends given communication unit to the agent.

Method Detail

getRollbackInfo

RollbackInfo getRollbackInfo(long rollbackInfoId)

Retrieves a full rollback info instance. Required right: EngineRights.READ_ROLLBACK_INFO

Parameters:

rollbackInfoId - the identifier of the rollback info

Returns:

instance of RollbackInfo

findRollbackInfos

RollbackInfoList findRollbackInfos(RollbackInfoCriteria criteria)

Returns all rollback information for given agent. Required right: EngineRights.READ_ROLLBACK_INFO

Parameters:

criteria - the agent name.

Returns:

collection of RollbackInfo objects.

retryOperation

boolean retryOperation(long rollbackInfoId)
                throws RollbackInfoNotFoundException

Re-sends given communication unit to the agent. Required right: EngineRights.RESEND_ROLLBACK_INFO

Parameters:

rollbackInfoId - the RollbackInfo.getId() value.

Returns:

true if processing of RollBackInfo succeeded, false otherwise

Throws:

RollbackInfoNotFoundException - if no rollback-info can be found for the given id

removeRollbackInfo

void removeRollbackInfo(long rollbackInfoId)
                 throws RollbackInfoNotFoundException

Removes given rollback info. Required right: EngineRights.REMOVE_ROLLBACK_INFO

Parameters:

rollbackInfoId - the RollbackInfo.getId() value

Throws:

RollbackInfoNotFoundException - if no rollback-info can be found for the given id

getErrorModelInstance

ModelInstance getErrorModelInstance(long rollbackInfoId,
                                    long errorModelInstanceId)
                             throws RollbackInfoNotFoundException,
                                    ModelInstanceStateException

Returns model instance at the time of exception.

Parameters:

rollbackInfoId -

errorModelInstanceId -

Returns:

model instance at the time of exception

Throws:

RollbackInfoNotFoundException

ModelInstanceStateException