org.apache.hadoop.hbase.coprocessor

Interface WALObserver

All Superinterfaces:

Coprocessor

@InterfaceAudience.LimitedPrivate(value="Coprocesssor")
 @InterfaceStability.Evolving
public interface WALObserver
extends Coprocessor

It's provided to have a way for coprocessors to observe, rewrite, or skip WALEdits as they are being written to the WAL. Note that implementers of WALObserver will not see WALEdits that report themselves as empty via WALEdit.isEmpty(). RegionObserver provides hooks for adding logic for WALEdits in the region context during reconstruction. Defines coprocessor hooks for interacting with operations on the WAL. Since most implementations will be interested in only a subset of hooks, this class uses 'default' functions to avoid having to add unnecessary overrides. When the functions are non-empty, it's simply to satisfy the compiler by returning value of expected (non-void) type. It is done in a way that these default definitions act as no-op. So our suggestion to implementation would be to not call these 'default' methods from overrides.

Exception Handling

For all functions, exception handling is done as follows:

• Exceptions of type IOException are reported back to client.
• For any other kind of exception:
  • If the configuration CoprocessorHost.ABORT_ON_ERROR_KEY is set to true, then the server aborts.
  • Otherwise, coprocessor is removed from the server and DoNotRetryIOException is returned to the client.

Nested Class Summary

Nested classes/interfaces inherited from interface org.apache.hadoop.hbase.Coprocessor

Coprocessor.State

Field Summary

Fields inherited from interface org.apache.hadoop.hbase.Coprocessor

PRIORITY_HIGHEST, PRIORITY_LOWEST, PRIORITY_SYSTEM, PRIORITY_USER, VERSION

Method Summary

Modifier and Type	Method and Description
default void	postWALRoll(ObserverContext<? extends WALCoprocessorEnvironment> ctx, org.apache.hadoop.fs.Path oldPath, org.apache.hadoop.fs.Path newPath) Called after rolling the current WAL
default void	postWALWrite(ObserverContext<? extends WALCoprocessorEnvironment> ctx, HRegionInfo info, WALKey logKey, WALEdit logEdit) Called after a WALEdit is writen to WAL.
default void	preWALRoll(ObserverContext<? extends WALCoprocessorEnvironment> ctx, org.apache.hadoop.fs.Path oldPath, org.apache.hadoop.fs.Path newPath) Called before rolling the current WAL
default boolean	preWALWrite(ObserverContext<? extends WALCoprocessorEnvironment> ctx, HRegionInfo info, WALKey logKey, WALEdit logEdit) Called before a WALEdit is writen to WAL.

Methods inherited from interface org.apache.hadoop.hbase.Coprocessor

start, stop

Method Detail

preWALWrite

default boolean preWALWrite(ObserverContext<? extends WALCoprocessorEnvironment> ctx,
                            HRegionInfo info,
                            WALKey logKey,
                            WALEdit logEdit)
                     throws IOException

Called before a WALEdit is writen to WAL.

Returns:

true if default behavior should be bypassed, false otherwise

Throws:

IOException

postWALWrite

default void postWALWrite(ObserverContext<? extends WALCoprocessorEnvironment> ctx,
                          HRegionInfo info,
                          WALKey logKey,
                          WALEdit logEdit)
                   throws IOException

Called after a WALEdit is writen to WAL.

Throws:

IOException

preWALRoll

default void preWALRoll(ObserverContext<? extends WALCoprocessorEnvironment> ctx,
                        org.apache.hadoop.fs.Path oldPath,
                        org.apache.hadoop.fs.Path newPath)
                 throws IOException

Called before rolling the current WAL

Parameters:

oldPath - the path of the current wal that we are replacing

newPath - the path of the wal we are going to create

Throws:

IOException

postWALRoll

default void postWALRoll(ObserverContext<? extends WALCoprocessorEnvironment> ctx,
                         org.apache.hadoop.fs.Path oldPath,
                         org.apache.hadoop.fs.Path newPath)
                  throws IOException

Called after rolling the current WAL

Parameters:

oldPath - the path of the wal that we replaced

newPath - the path of the wal we have created and now is the current

Throws:

IOException