org.hibernate.ogm.compensation

Interface ErrorHandler

All Known Implementing Classes:

BaseErrorHandler

@Experimental
public interface ErrorHandler

Implementations receive applied and failed grid dialect operations upon exceptions when persisting data in the NoSQL backend.

Intended for those stores without transactional semantics, where it allows to determine the changes applied prior to a failure during application of the changes collected for a a unit of work.

Instead of implementing this interface directly, implementations should be derived from BaseErrorHandler, as new methods will be added to the contract in the future. Implementations must be thread-safe.

Error handlers are registered via the OgmProperties.ERROR_HANDLER property.

Author:

Gunnar Morling

See Also:

OgmProperties.ERROR_HANDLER

Nested Class Summary

Nested Classes

Modifier and Type	Interface and Description
static interface	ErrorHandler.FailedGridDialectOperationContext Provides contextual information when notifying an ErrorHandler about a failed grid dialect operation.
static interface	ErrorHandler.RollbackContext Provides contextual information when notifying an ErrorHandler about a transaction rollback.

Method Summary

Modifier and Type	Method and Description
ErrorHandlingStrategy	onFailedGridDialectOperation(ErrorHandler.FailedGridDialectOperationContext context) Callback method invoked if an error occurred during the execution of a grid dialect method.
void	onRollback(ErrorHandler.RollbackContext context) Callback method invoked if the current "transaction" is rolled back.

Method Detail

onFailedGridDialectOperation

ErrorHandlingStrategy onFailedGridDialectOperation(ErrorHandler.FailedGridDialectOperationContext context)

Callback method invoked if an error occurred during the execution of a grid dialect method. The error handler can decide whether to abort the current "transaction" or abort it.

onRollback

void onRollback(ErrorHandler.RollbackContext context)

Callback method invoked if the current "transaction" is rolled back. Provides access to all grid dialect operations successfully applied before the error causing the rollback occurred.