org.apache.hadoop.hbase.master.procedure

Class TestMasterProcedureQueue.TestTableProcedure

java.lang.Object

org.apache.hadoop.hbase.procedure2.Procedure<Void>

org.apache.hadoop.hbase.master.procedure.TestMasterProcedureQueue.TestTableProcedure

All Implemented Interfaces:

Comparable<Procedure>, TableProcedureInterface

Enclosing class:

TestMasterProcedureQueue

public static class TestMasterProcedureQueue.TestTableProcedure
extends Procedure<Void>
implements TableProcedureInterface

Nested Class Summary

Nested classes/interfaces inherited from interface org.apache.hadoop.hbase.master.procedure.TableProcedureInterface

TableProcedureInterface.TableOperationType

Constructor Summary

Constructors

Constructor and Description
TestTableProcedure()
TestTableProcedure(long procId, TableName tableName, TableProcedureInterface.TableOperationType opType)

Method Summary

Modifier and Type	Method and Description
protected boolean	abort(Void env) The abort() call is asynchronous and each procedure must decide how to deal with that, if they want to be abortable.
protected void	deserializeStateData(InputStream stream) Called on store load to allow the user to decode the previously serialized state.
protected Procedure[]	execute(Void env) The main code of the procedure.
TableName	getTableName()
TableProcedureInterface.TableOperationType	getTableOperationType() Given an operation type we can take decisions about what to do with pending operations.
protected void	rollback(Void env) The code to undo what done by the execute() code.
protected void	serializeStateData(OutputStream stream) The user-level code of the procedure may have some state to persist (e.g.

Methods inherited from class org.apache.hadoop.hbase.procedure2.Procedure

acquireLock, addStackIndex, beforeReplay, childrenCountDown, compareTo, completionCleanup, convert, convert, createProcedureInfo, doExecute, doRollback, elapsedTime, getException, getLastUpdate, getOwner, getParentProcId, getProcId, getResult, getRootProcedureId, getStackIndexes, getStartTime, getState, getTimeout, getTimeRemaining, hasException, hasOwner, hasParent, hasTimeout, incChildrenLatch, isFailed, isFinished, isSuccess, isWaiting, newInstance, releaseLock, removeStackIndex, setAbortFailure, setChildrenLatch, setFailure, setFailure, setOwner, setParentProcId, setProcId, setResult, setStackIndexes, setStartTime, setState, setTimeout, setTimeoutFailure, toString, toStringClass, toStringClassDetails, toStringDetails, toStringSimpleSB, updateTimestamp, validateClass, wasExecuted

Methods inherited from class java.lang.Object

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

Constructor Detail

TestTableProcedure

public TestTableProcedure()

TestTableProcedure

public TestTableProcedure(long procId,
                          TableName tableName,
                          TableProcedureInterface.TableOperationType opType)

Method Detail

getTableName

public TableName getTableName()

Specified by:

getTableName in interface TableProcedureInterface

Returns:

the name of the table the procedure is operating on

getTableOperationType

public TableProcedureInterface.TableOperationType getTableOperationType()

Description copied from interface: TableProcedureInterface

Given an operation type we can take decisions about what to do with pending operations. e.g. if we get a delete and we have some table operation pending (e.g. add column) we can abort those operations.

Specified by:

getTableOperationType in interface TableProcedureInterface

Returns:

the operation type that the procedure is executing.

execute

protected Procedure[] execute(Void env)

Description copied from class: Procedure

The main code of the procedure. It must be idempotent since execute() may be called multiple time in case of machine failure in the middle of the execution.

Specified by:

execute in class Procedure<Void>

Returns:

a set of sub-procedures or null if there is nothing else to execute.

rollback

protected void rollback(Void env)

Description copied from class: Procedure

The code to undo what done by the execute() code. It is called when the procedure or one of the sub-procedure failed or an abort was requested. It should cleanup all the resources created by the execute() call. The implementation must be idempotent since rollback() may be called multiple time in case of machine failure in the middle of the execution.

Specified by:

rollback in class Procedure<Void>

abort

protected boolean abort(Void env)

Description copied from class: Procedure

The abort() call is asynchronous and each procedure must decide how to deal with that, if they want to be abortable. The simplest implementation is to have an AtomicBoolean set in the abort() method and then the execute() will check if the abort flag is set or not. abort() may be called multiple times from the client, so the implementation must be idempotent. NOTE: abort() is not like Thread.interrupt() it is just a notification that allows the procedure implementor where to abort to avoid leak and have a better control on what was executed and what not.

Specified by:

abort in class Procedure<Void>

serializeStateData

protected void serializeStateData(OutputStream stream)
                           throws IOException

Description copied from class: Procedure

The user-level code of the procedure may have some state to persist (e.g. input arguments) to be able to resume on failure.

Specified by:

serializeStateData in class Procedure<Void>

Parameters:

stream - the stream that will contain the user serialized data

Throws:

IOException

deserializeStateData

protected void deserializeStateData(InputStream stream)
                             throws IOException

Description copied from class: Procedure

Called on store load to allow the user to decode the previously serialized state.

Specified by:

deserializeStateData in class Procedure<Void>

Parameters:

stream - the stream that contains the user serialized data

Throws:

IOException