com.atomikos.datasource

Interface RecoverableResource

All Known Subinterfaces:

TransactionalResource

public interface RecoverableResource

A Recoverable Resource is the abstraction of a resource that supports recoverable work (i.e., that supports Participant instances). A recoverable resource is invoked at recovery time by the transaction core.

Method Summary

Modifier and Type	Method and Description
void	close() Closes the resource for shutdown.
String	getName() Gets the name of the resource.
boolean	hasMoreToRecover()
boolean	isClosed() Tests if the resource is closed.
boolean	isSameRM(RecoverableResource res) Tests if a resource is the same as another one.
boolean	recover(long startOfRecoveryScan, Collection<PendingTransactionRecord> expiredCommittingCoordinators, Collection<PendingTransactionRecord> indoubtForeignCoordinatorsToKeep) Instructs the resource to recover.
void	setRecoveryService(RecoveryService recoveryService) Initializes this resource with the recovery service.

Method Detail

setRecoveryService

void setRecoveryService(RecoveryService recoveryService)
                 throws ResourceException

Initializes this resource with the recovery service. This method is called by the transaction service during intialization of the transaction service or when the resource is added, whichever comes last. If the resource wants to recover, it should subsequently ask the recoveryService to do so.

Parameters:

recoveryService - The recovery service. This instance can be used by the resource to ask recovery from the transaction engine.

Throws:

ResourceException - On errors.

close

void close()
    throws ResourceException

Closes the resource for shutdown. This notifies the resource that it is no longer needed.

Throws:

ResourceException

getName

String getName()

Gets the name of the resource. Names should be unique within one TM domain.

Returns:

String The name.

isSameRM

boolean isSameRM(RecoverableResource res)
          throws ResourceException

Tests if a resource is the same as another one.

Throws:

ResourceException

isClosed

boolean isClosed()

Tests if the resource is closed.

Returns:

boolean True if the resource is closed.

recover

boolean recover(long startOfRecoveryScan,
                Collection<PendingTransactionRecord> expiredCommittingCoordinators,
                Collection<PendingTransactionRecord> indoubtForeignCoordinatorsToKeep)

Instructs the resource to recover.

Parameters:

startOfRecoveryScan -

expiredCommittingCoordinators -

indoubtForeignCoordinatorsToKeep -

Returns:

True if this resource has no more participants for the supplied expiredCommittingCoordinators.

hasMoreToRecover

boolean hasMoreToRecover()

Returns:

True if this resource had pending participants in the last recovery scan.