org.apache.hadoop.hbase.errorhandling

类 ForeignExceptionDispatcher

java.lang.Object

org.apache.hadoop.hbase.errorhandling.ForeignExceptionDispatcher

所有已实现的接口:

ForeignExceptionListener, ForeignExceptionSnare

@InterfaceAudience.Private
public class ForeignExceptionDispatcher
extends Object
implements ForeignExceptionListener, ForeignExceptionSnare

The dispatcher acts as the state holding entity for foreign error handling. The first exception received by the dispatcher get passed directly to the listeners. Subsequent exceptions are dropped.

If there are multiple dispatchers that are all in the same foreign exception monitoring group, ideally all these monitors are "peers" -- any error on one dispatcher should get propagated to all others (via rpc, or some other mechanism). Due to racing error conditions the exact reason for failure may be different on different peers, but the fact that they are in error state should eventually hold on all.

This is thread-safe and must be because this is expected to be used to propagate exceptions from foreign threads.

字段概要

字段

限定符和类型	字段和说明
protected List<ForeignExceptionListener>	listeners
protected String	name

构造器概要

构造器

构造器和说明
ForeignExceptionDispatcher()
ForeignExceptionDispatcher(String name)

方法概要

限定符和类型	方法和说明
void	addListener(ForeignExceptionListener errorable) Listen for failures to a given process.
ForeignException	getException() Get the value of the captured exception.
String	getName()
boolean	hasException() Non-exceptional form of ForeignExceptionSnare.rethrowException().
void	receive(ForeignException e) Receive a ForeignException.
void	rethrowException() Rethrow an exception currently held by the ForeignExceptionSnare.

从类继承的方法 java.lang.Object

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

字段详细资料

name

protected final String name

listeners

protected final List<ForeignExceptionListener> listeners

构造器详细资料

ForeignExceptionDispatcher

public ForeignExceptionDispatcher(String name)

ForeignExceptionDispatcher

public ForeignExceptionDispatcher()

方法详细资料

getName

public String getName()

receive

public void receive(ForeignException e)

从接口复制的说明: ForeignExceptionListener

Receive a ForeignException.

Implementers must ensure that this method is thread-safe.

指定者:

receive 在接口中 ForeignExceptionListener

参数:

e - exception causing the error. Implementations must accept and handle null here.

rethrowException

public void rethrowException()
                      throws ForeignException

从接口复制的说明: ForeignExceptionSnare

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

指定者:

rethrowException 在接口中 ForeignExceptionSnare

抛出:

ForeignException - all exceptions from remote sources are procedure exceptions

hasException

public boolean hasException()

从接口复制的说明: ForeignExceptionSnare

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

指定者:

hasException 在接口中 ForeignExceptionSnare

返回:

true if there has been an error,false otherwise

getException

public ForeignException getException()

从接口复制的说明: ForeignExceptionSnare

Get the value of the captured exception.

指定者:

getException 在接口中 ForeignExceptionSnare

返回:

the captured foreign exception or null if no exception captured.

addListener

public void addListener(ForeignExceptionListener errorable)

Listen for failures to a given process. This method should only be used during initialization and not added to after exceptions are accepted.

参数:

errorable - listener for the errors. may be null.