org.apache.hadoop.hbase.errorhandling

接口 ForeignExceptionSnare

所有已知实现类:

DisabledTableSnapshotHandler, EnabledTableSnapshotHandler, ForeignExceptionDispatcher, TakeSnapshotHandler

@InterfaceAudience.Private
public interface ForeignExceptionSnare

This is an interface for a cooperative exception throwing mechanism. Implementations are containers that holds an exception from a separate thread. This can be used to receive exceptions from 'foreign' threads or from separate 'foreign' processes.

To use, one would pass an implementation of this object to a long running method and periodically check by calling rethrowException(). If any foreign exceptions have been received, the calling thread is then responsible for handling the rethrown exception.

One could use the boolean hasException() to determine if there is an exceptoin as well.

NOTE: This is very similar to the InterruptedException/interrupt/interrupted pattern. There, the notification state is bound to a Thread. Using this, applications receive Exceptions in the snare. The snare is referenced and checked by multiple threads which enables exception notification in all the involved threads/processes.

方法概要

方法

限定符和类型	方法和说明
ForeignException	getException() Get the value of the captured exception.
boolean	hasException() Non-exceptional form of rethrowException().
void	rethrowException() Rethrow an exception currently held by the ForeignExceptionSnare.

方法详细资料

rethrowException

void rethrowException()
                      throws ForeignException

Rethrow an exception currently held by the ForeignExceptionSnare. If there is no exception this is a no-op

抛出:

ForeignException - all exceptions from remote sources are procedure exceptions

hasException

boolean hasException()

Non-exceptional form of rethrowException(). Checks to see if any process to which the exception checkers is bound has created an error that would cause a failure.

返回:

true if there has been an error,false otherwise

getException

ForeignException getException()

Get the value of the captured exception.

返回:

the captured foreign exception or null if no exception captured.