org.apache.hadoop.hbase.coprocessor

类 ObserverContextImpl<E extends CoprocessorEnvironment>

java.lang.Object

org.apache.hadoop.hbase.coprocessor.ObserverContextImpl<E>

所有已实现的接口:

ObserverContext<E>

直接已知子类:

CoprocessorHost.ObserverOperationWithoutResult, CoprocessorHost.ObserverOperationWithResult

@InterfaceAudience.Private
public class ObserverContextImpl<E extends CoprocessorEnvironment>
extends Object
implements ObserverContext<E>

This is the only implementation of ObserverContext, which serves as the interface for third-party Coprocessor developers.

构造器概要

构造器

构造器和说明
ObserverContextImpl(User caller)
ObserverContextImpl(User caller, boolean bypassable)

方法概要

限定符和类型	方法和说明
void	bypass() Call to indicate that the current coprocessor's return value (or parameter -- depends on the call-type) should be used in place of the value that would be obtained via normal processing; i.e. bypass the core call and return the Coprocessor's result instead.
static <E extends CoprocessorEnvironment> ObserverContext<E>	createAndPrepare(E env) 已过时。
Optional<User>	getCaller() Returns the active user for the coprocessor call.
E	getEnvironment()
boolean	isBypassable()
void	prepare(E env)
boolean	shouldBypass()

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

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

构造器详细资料

ObserverContextImpl

public ObserverContextImpl(User caller)

ObserverContextImpl

public ObserverContextImpl(User caller,
                           boolean bypassable)

方法详细资料

getEnvironment

public E getEnvironment()

指定者:

getEnvironment 在接口中 ObserverContext<E extends CoprocessorEnvironment>

prepare

public void prepare(E env)

isBypassable

public boolean isBypassable()

bypass

public void bypass()

从接口复制的说明: ObserverContext

Call to indicate that the current coprocessor's return value (or parameter -- depends on the call-type) should be used in place of the value that would be obtained via normal processing; i.e. bypass the core call and return the Coprocessor's result instead. DOES NOT work for all Coprocessor invocations, only on a small subset of methods, mostly preXXX calls in RegionObserver. Check javadoc on the pertinent Coprocessor Observer to see if bypass is supported.

This behavior of honoring only a subset of methods is new since hbase-2.0.0.

Where bypass is supported what is being bypassed is all of the core code implementing the remainder of the operation. In order to understand what calling bypass() will skip, a coprocessor implementer should read and understand all of the remaining code and its nuances. Although this is good practice for coprocessor developers in general, it demands a lot. What is skipped is extremely version dependent. The core code will vary, perhaps significantly, even between point releases. We do not provide the promise of consistent behavior even between point releases for the bypass semantic. To achieve that we could not change any code between hook points. Therefore the coprocessor implementer becomes an HBase core developer in practice as soon as they rely on bypass(). Every release of HBase may break the assumption that the replacement for the bypassed code takes care of all necessary skipped concerns. Because those concerns can change at any point, such an assumption is never safe.

As of hbase2, when bypass has been set, we will NOT call any Coprocessors follow the bypassing Coprocessor; we cut short the processing and return the bypassing Coprocessors response (this used be a separate 'complete' option that has been folded into the 'bypass' in hbase2.

指定者:

bypass 在接口中 ObserverContext<E extends CoprocessorEnvironment>

shouldBypass

public boolean shouldBypass()

返回:

true, if ObserverContext.bypass() was called by one of the loaded coprocessors, false otherwise.

getCaller

public Optional<User> getCaller()

从接口复制的说明: ObserverContext

Returns the active user for the coprocessor call. If an explicit User instance was provided to the constructor, that will be returned, otherwise if we are in the context of an RPC call, the remote user is used. May not be present if the execution is outside of an RPC context.

指定者:

getCaller 在接口中 ObserverContext<E extends CoprocessorEnvironment>

createAndPrepare

@Deprecated
public static <E extends CoprocessorEnvironment> ObserverContext<E> createAndPrepare(E env)

已过时。

Instantiates a new ObserverContext instance if the passed reference is null and sets the environment in the new or existing instance. This allows deferring the instantiation of a ObserverContext until it is actually needed.

类型参数:

E - The environment type for the context

参数:

env - The coprocessor environment to set

返回:

An instance of ObserverContext with the environment set