org.apache.tephra.hbase

Class TransactionAwareHTable

java.lang.Object

org.apache.tephra.AbstractTransactionAwareTable

org.apache.tephra.hbase.TransactionAwareHTable

All Implemented Interfaces:

Closeable, AutoCloseable, org.apache.hadoop.hbase.client.Table, TransactionAware

public class TransactionAwareHTable
extends AbstractTransactionAwareTable
implements org.apache.hadoop.hbase.client.Table, TransactionAware

A Transaction Aware HTable implementation for HBase 2.0. Operations are committed as usual, but upon a failed or aborted transaction, they are rolled back to the state before the transaction was started.

Nested Class Summary

Nested classes/interfaces inherited from class org.apache.tephra.AbstractTransactionAwareTable

AbstractTransactionAwareTable.ActionChange

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

org.apache.hadoop.hbase.client.Table.CheckAndMutateBuilder

Field Summary

Fields inherited from class org.apache.tephra.AbstractTransactionAwareTable

allowNonTransactional, changeSets, conflictLevel, pre014ChangeSetKey, SEPARATOR_BYTE_ARRAY, tx, txCodec

Constructor Summary

Constructors

Constructor and Description
TransactionAwareHTable(org.apache.hadoop.hbase.client.Table hTable) Create a transactional aware instance of the passed HTable
TransactionAwareHTable(org.apache.hadoop.hbase.client.Table hTable, boolean allowNonTransactional) Create a transactional aware instance of the passed HTable, with the option of allowing non-transactional operations.
TransactionAwareHTable(org.apache.hadoop.hbase.client.Table hTable, TxConstants.ConflictDetection conflictLevel) Create a transactional aware instance of the passed HTable
TransactionAwareHTable(org.apache.hadoop.hbase.client.Table hTable, TxConstants.ConflictDetection conflictLevel, boolean allowNonTransactional) Create a transactional aware instance of the passed HTable, with the option of allowing non-transactional operations.

Method Summary

Modifier and Type	Method and Description
void	addToOperation(org.apache.hadoop.hbase.client.OperationWithAttributes op, Transaction tx)
org.apache.hadoop.hbase.client.Result	append(org.apache.hadoop.hbase.client.Append append)
void	batch(List<? extends org.apache.hadoop.hbase.client.Row> actions, Object[] results)
<R> void	batchCallback(List<? extends org.apache.hadoop.hbase.client.Row> actions, Object[] results, org.apache.hadoop.hbase.client.coprocessor.Batch.Callback<R> callback)
<R extends com.google.protobuf.Message> Map<byte[],R>	batchCoprocessorService(com.google.protobuf.Descriptors.MethodDescriptor methodDescriptor, com.google.protobuf.Message request, byte[] startKey, byte[] endKey, R responsePrototype)
<R extends com.google.protobuf.Message> void	batchCoprocessorService(com.google.protobuf.Descriptors.MethodDescriptor methodDescriptor, com.google.protobuf.Message request, byte[] startKey, byte[] endKey, R responsePrototype, org.apache.hadoop.hbase.client.coprocessor.Batch.Callback<R> callback)
boolean	checkAndDelete(byte[] row, byte[] family, byte[] qualifier, byte[] value, org.apache.hadoop.hbase.client.Delete delete)
boolean	checkAndDelete(byte[] bytes, byte[] bytes1, byte[] bytes2, org.apache.hadoop.hbase.filter.CompareFilter.CompareOp compareOp, byte[] bytes3, org.apache.hadoop.hbase.client.Delete delete)
boolean	checkAndDelete(byte[] row, byte[] family, byte[] qualifier, org.apache.hadoop.hbase.CompareOperator op, byte[] value, org.apache.hadoop.hbase.client.Delete delete)
org.apache.hadoop.hbase.client.Table.CheckAndMutateBuilder	checkAndMutate(byte[] row, byte[] family)
boolean	checkAndMutate(byte[] row, byte[] family, byte[] qualifier, org.apache.hadoop.hbase.filter.CompareFilter.CompareOp compareOp, byte[] value, org.apache.hadoop.hbase.client.RowMutations rowMutations)
boolean	checkAndMutate(byte[] row, byte[] family, byte[] qualifier, org.apache.hadoop.hbase.CompareOperator op, byte[] value, org.apache.hadoop.hbase.client.RowMutations mutation)
boolean	checkAndPut(byte[] row, byte[] family, byte[] qualifier, byte[] value, org.apache.hadoop.hbase.client.Put put)
boolean	checkAndPut(byte[] bytes, byte[] bytes1, byte[] bytes2, org.apache.hadoop.hbase.filter.CompareFilter.CompareOp compareOp, byte[] bytes3, org.apache.hadoop.hbase.client.Put put)
boolean	checkAndPut(byte[] row, byte[] family, byte[] qualifier, org.apache.hadoop.hbase.CompareOperator op, byte[] value, org.apache.hadoop.hbase.client.Put put)
void	close()
org.apache.hadoop.hbase.ipc.CoprocessorRpcChannel	coprocessorService(byte[] row)
<T extends com.google.protobuf.Service,R> Map<byte[],R>	coprocessorService(Class<T> service, byte[] startKey, byte[] endKey, org.apache.hadoop.hbase.client.coprocessor.Batch.Call<T,R> callable)
<T extends com.google.protobuf.Service,R> void	coprocessorService(Class<T> service, byte[] startKey, byte[] endKey, org.apache.hadoop.hbase.client.coprocessor.Batch.Call<T,R> callable, org.apache.hadoop.hbase.client.coprocessor.Batch.Callback<R> callback)
void	delete(org.apache.hadoop.hbase.client.Delete delete)
void	delete(List<org.apache.hadoop.hbase.client.Delete> deletes)
protected boolean	doCommit()
protected boolean	doRollback()
boolean	exists(org.apache.hadoop.hbase.client.Get get)
boolean[]	exists(List<org.apache.hadoop.hbase.client.Get> gets)
boolean[]	existsAll(List<org.apache.hadoop.hbase.client.Get> gets)
org.apache.hadoop.hbase.client.Result	get(org.apache.hadoop.hbase.client.Get get)
org.apache.hadoop.hbase.client.Result[]	get(List<org.apache.hadoop.hbase.client.Get> gets)
org.apache.hadoop.conf.Configuration	getConfiguration()
org.apache.hadoop.hbase.client.TableDescriptor	getDescriptor()
org.apache.hadoop.hbase.TableName	getName()
int	getOperationTimeout()
long	getOperationTimeout(TimeUnit unit)
int	getReadRpcTimeout()
long	getReadRpcTimeout(TimeUnit unit)
int	getRpcTimeout()
long	getRpcTimeout(TimeUnit unit)
org.apache.hadoop.hbase.client.ResultScanner	getScanner(byte[] family)
org.apache.hadoop.hbase.client.ResultScanner	getScanner(byte[] family, byte[] qualifier)
org.apache.hadoop.hbase.client.ResultScanner	getScanner(org.apache.hadoop.hbase.client.Scan scan)
org.apache.hadoop.hbase.HTableDescriptor	getTableDescriptor()
protected byte[]	getTableKey()
int	getWriteRpcTimeout()
long	getWriteRpcTimeout(TimeUnit unit)
org.apache.hadoop.hbase.client.Result	increment(org.apache.hadoop.hbase.client.Increment increment)
long	incrementColumnValue(byte[] row, byte[] family, byte[] qualifier, long amount)
long	incrementColumnValue(byte[] row, byte[] family, byte[] qualifier, long amount, org.apache.hadoop.hbase.client.Durability durability)
protected void	makeRollbackOperation(org.apache.hadoop.hbase.client.Delete delete)
void	mutateRow(org.apache.hadoop.hbase.client.RowMutations rm)
void	put(List<org.apache.hadoop.hbase.client.Put> puts)
void	put(org.apache.hadoop.hbase.client.Put put)
void	setOperationTimeout(int operationTimeout)
void	setReadRpcTimeout(int readRpcTimeout)
void	setRpcTimeout(int rpcTimeout)
void	setWriteRpcTimeout(int writeRpcTimeout)

Methods inherited from class org.apache.tephra.AbstractTransactionAwareTable

addToChangeSet, commitTx, getAllowNonTransactional, getChangeKey, getTransactionAwareName, getTxChanges, getVIntBytes, postTxCommit, rollbackTx, setAllowNonTransactional, startTx, updateTx

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.apache.tephra.TransactionAware

commitTx, getTransactionAwareName, getTxChanges, postTxCommit, rollbackTx, startTx, updateTx

Constructor Detail

TransactionAwareHTable

public TransactionAwareHTable(org.apache.hadoop.hbase.client.Table hTable)

Create a transactional aware instance of the passed HTable

Parameters:

hTable - underlying HBase table to use

TransactionAwareHTable

public TransactionAwareHTable(org.apache.hadoop.hbase.client.Table hTable,
                              TxConstants.ConflictDetection conflictLevel)

Create a transactional aware instance of the passed HTable

Parameters:

hTable - underlying HBase table to use

conflictLevel - level of conflict detection to perform (defaults to COLUMN)

TransactionAwareHTable

public TransactionAwareHTable(org.apache.hadoop.hbase.client.Table hTable,
                              boolean allowNonTransactional)

Create a transactional aware instance of the passed HTable, with the option of allowing non-transactional operations.

Parameters:

hTable - underlying HBase table to use

allowNonTransactional - if true, additional operations (checkAndPut, increment, checkAndDelete) will be available, though non-transactional

TransactionAwareHTable

public TransactionAwareHTable(org.apache.hadoop.hbase.client.Table hTable,
                              TxConstants.ConflictDetection conflictLevel,
                              boolean allowNonTransactional)

Create a transactional aware instance of the passed HTable, with the option of allowing non-transactional operations.

Parameters:

hTable - underlying HBase table to use

conflictLevel - level of conflict detection to perform (defaults to COLUMN)

allowNonTransactional - if true, additional operations (checkAndPut, increment, checkAndDelete) will be available, though non-transactional

Method Detail

getTableKey

protected byte[] getTableKey()

Specified by:

getTableKey in class AbstractTransactionAwareTable

doCommit

protected boolean doCommit()
                    throws IOException

Specified by:

doCommit in class AbstractTransactionAwareTable

Throws:

IOException

doRollback

protected boolean doRollback()
                      throws Exception

Specified by:

doRollback in class AbstractTransactionAwareTable

Throws:

Exception

getName

public org.apache.hadoop.hbase.TableName getName()

Specified by:

getName in interface org.apache.hadoop.hbase.client.Table

getConfiguration

public org.apache.hadoop.conf.Configuration getConfiguration()

Specified by:

getConfiguration in interface org.apache.hadoop.hbase.client.Table

getTableDescriptor

public org.apache.hadoop.hbase.HTableDescriptor getTableDescriptor()
                                                            throws IOException

Specified by:

getTableDescriptor in interface org.apache.hadoop.hbase.client.Table

Throws:

IOException

exists

public boolean exists(org.apache.hadoop.hbase.client.Get get)
               throws IOException

Specified by:

exists in interface org.apache.hadoop.hbase.client.Table

Throws:

IOException

batch

public void batch(List<? extends org.apache.hadoop.hbase.client.Row> actions,
                  Object[] results)
           throws IOException,
                  InterruptedException

Specified by:

batch in interface org.apache.hadoop.hbase.client.Table

Throws:

IOException

InterruptedException

batchCallback

public <R> void batchCallback(List<? extends org.apache.hadoop.hbase.client.Row> actions,
                              Object[] results,
                              org.apache.hadoop.hbase.client.coprocessor.Batch.Callback<R> callback)
                       throws IOException,
                              InterruptedException

Specified by:

batchCallback in interface org.apache.hadoop.hbase.client.Table

Throws:

IOException

InterruptedException

get

public org.apache.hadoop.hbase.client.Result get(org.apache.hadoop.hbase.client.Get get)
                                          throws IOException

Specified by:

get in interface org.apache.hadoop.hbase.client.Table

Throws:

IOException

get

public org.apache.hadoop.hbase.client.Result[] get(List<org.apache.hadoop.hbase.client.Get> gets)
                                            throws IOException

Specified by:

get in interface org.apache.hadoop.hbase.client.Table

Throws:

IOException

getScanner

public org.apache.hadoop.hbase.client.ResultScanner getScanner(org.apache.hadoop.hbase.client.Scan scan)
                                                        throws IOException

Specified by:

getScanner in interface org.apache.hadoop.hbase.client.Table

Throws:

IOException

getScanner

public org.apache.hadoop.hbase.client.ResultScanner getScanner(byte[] family)
                                                        throws IOException

Specified by:

getScanner in interface org.apache.hadoop.hbase.client.Table

Throws:

IOException

getScanner

public org.apache.hadoop.hbase.client.ResultScanner getScanner(byte[] family,
                                                               byte[] qualifier)
                                                        throws IOException

Specified by:

getScanner in interface org.apache.hadoop.hbase.client.Table

Throws:

IOException

put

public void put(org.apache.hadoop.hbase.client.Put put)
         throws IOException

Specified by:

put in interface org.apache.hadoop.hbase.client.Table

Throws:

IOException

put

public void put(List<org.apache.hadoop.hbase.client.Put> puts)
         throws IOException

Specified by:

put in interface org.apache.hadoop.hbase.client.Table

Throws:

IOException

delete

public void delete(org.apache.hadoop.hbase.client.Delete delete)
            throws IOException

Specified by:

delete in interface org.apache.hadoop.hbase.client.Table

Throws:

IOException

delete

public void delete(List<org.apache.hadoop.hbase.client.Delete> deletes)
            throws IOException

Specified by:

delete in interface org.apache.hadoop.hbase.client.Table

Throws:

IOException

checkAndPut

public boolean checkAndPut(byte[] row,
                           byte[] family,
                           byte[] qualifier,
                           byte[] value,
                           org.apache.hadoop.hbase.client.Put put)
                    throws IOException

Specified by:

checkAndPut in interface org.apache.hadoop.hbase.client.Table

Throws:

IOException

checkAndDelete

public boolean checkAndDelete(byte[] row,
                              byte[] family,
                              byte[] qualifier,
                              byte[] value,
                              org.apache.hadoop.hbase.client.Delete delete)
                       throws IOException

Specified by:

checkAndDelete in interface org.apache.hadoop.hbase.client.Table

Throws:

IOException

checkAndDelete

public boolean checkAndDelete(byte[] bytes,
                              byte[] bytes1,
                              byte[] bytes2,
                              org.apache.hadoop.hbase.filter.CompareFilter.CompareOp compareOp,
                              byte[] bytes3,
                              org.apache.hadoop.hbase.client.Delete delete)
                       throws IOException

Specified by:

checkAndDelete in interface org.apache.hadoop.hbase.client.Table

Throws:

IOException

checkAndPut

public boolean checkAndPut(byte[] bytes,
                           byte[] bytes1,
                           byte[] bytes2,
                           org.apache.hadoop.hbase.filter.CompareFilter.CompareOp compareOp,
                           byte[] bytes3,
                           org.apache.hadoop.hbase.client.Put put)
                    throws IOException

Specified by:

checkAndPut in interface org.apache.hadoop.hbase.client.Table

Throws:

IOException

checkAndMutate

public boolean checkAndMutate(byte[] row,
                              byte[] family,
                              byte[] qualifier,
                              org.apache.hadoop.hbase.filter.CompareFilter.CompareOp compareOp,
                              byte[] value,
                              org.apache.hadoop.hbase.client.RowMutations rowMutations)
                       throws IOException

Specified by:

checkAndMutate in interface org.apache.hadoop.hbase.client.Table

Throws:

IOException

checkAndPut

public boolean checkAndPut(byte[] row,
                           byte[] family,
                           byte[] qualifier,
                           org.apache.hadoop.hbase.CompareOperator op,
                           byte[] value,
                           org.apache.hadoop.hbase.client.Put put)
                    throws IOException

Specified by:

checkAndPut in interface org.apache.hadoop.hbase.client.Table

Throws:

IOException

checkAndDelete

public boolean checkAndDelete(byte[] row,
                              byte[] family,
                              byte[] qualifier,
                              org.apache.hadoop.hbase.CompareOperator op,
                              byte[] value,
                              org.apache.hadoop.hbase.client.Delete delete)
                       throws IOException

Specified by:

checkAndDelete in interface org.apache.hadoop.hbase.client.Table

Throws:

IOException

checkAndMutate

public boolean checkAndMutate(byte[] row,
                              byte[] family,
                              byte[] qualifier,
                              org.apache.hadoop.hbase.CompareOperator op,
                              byte[] value,
                              org.apache.hadoop.hbase.client.RowMutations mutation)
                       throws IOException

Specified by:

checkAndMutate in interface org.apache.hadoop.hbase.client.Table

Throws:

IOException

existsAll

public boolean[] existsAll(List<org.apache.hadoop.hbase.client.Get> gets)
                    throws IOException

Specified by:

existsAll in interface org.apache.hadoop.hbase.client.Table

Throws:

IOException

mutateRow

public void mutateRow(org.apache.hadoop.hbase.client.RowMutations rm)
               throws IOException

Specified by:

mutateRow in interface org.apache.hadoop.hbase.client.Table

Throws:

IOException

append

public org.apache.hadoop.hbase.client.Result append(org.apache.hadoop.hbase.client.Append append)
                                             throws IOException

Specified by:

append in interface org.apache.hadoop.hbase.client.Table

Throws:

IOException

increment

public org.apache.hadoop.hbase.client.Result increment(org.apache.hadoop.hbase.client.Increment increment)
                                                throws IOException

Specified by:

increment in interface org.apache.hadoop.hbase.client.Table

Throws:

IOException

incrementColumnValue

public long incrementColumnValue(byte[] row,
                                 byte[] family,
                                 byte[] qualifier,
                                 long amount)
                          throws IOException

Specified by:

incrementColumnValue in interface org.apache.hadoop.hbase.client.Table

Throws:

IOException

incrementColumnValue

public long incrementColumnValue(byte[] row,
                                 byte[] family,
                                 byte[] qualifier,
                                 long amount,
                                 org.apache.hadoop.hbase.client.Durability durability)
                          throws IOException

Specified by:

incrementColumnValue in interface org.apache.hadoop.hbase.client.Table

Throws:

IOException

close

public void close()
           throws IOException

Specified by:

close in interface Closeable

Specified by:

close in interface AutoCloseable

Specified by:

close in interface org.apache.hadoop.hbase.client.Table

Throws:

IOException

coprocessorService

public org.apache.hadoop.hbase.ipc.CoprocessorRpcChannel coprocessorService(byte[] row)

Specified by:

coprocessorService in interface org.apache.hadoop.hbase.client.Table

coprocessorService

public <T extends com.google.protobuf.Service,R> Map<byte[],R> coprocessorService(Class<T> service,
                                                                                  byte[] startKey,
                                                                                  byte[] endKey,
                                                                                  org.apache.hadoop.hbase.client.coprocessor.Batch.Call<T,R> callable)
                                                                           throws com.google.protobuf.ServiceException,
                                                                                  Throwable

Specified by:

coprocessorService in interface org.apache.hadoop.hbase.client.Table

Throws:

com.google.protobuf.ServiceException

Throwable

coprocessorService

public <T extends com.google.protobuf.Service,R> void coprocessorService(Class<T> service,
                                                                         byte[] startKey,
                                                                         byte[] endKey,
                                                                         org.apache.hadoop.hbase.client.coprocessor.Batch.Call<T,R> callable,
                                                                         org.apache.hadoop.hbase.client.coprocessor.Batch.Callback<R> callback)
                                                                  throws com.google.protobuf.ServiceException,
                                                                         Throwable

Specified by:

coprocessorService in interface org.apache.hadoop.hbase.client.Table

Throws:

com.google.protobuf.ServiceException

Throwable

batchCoprocessorService

public <R extends com.google.protobuf.Message> Map<byte[],R> batchCoprocessorService(com.google.protobuf.Descriptors.MethodDescriptor methodDescriptor,
                                                                                     com.google.protobuf.Message request,
                                                                                     byte[] startKey,
                                                                                     byte[] endKey,
                                                                                     R responsePrototype)
                                                                              throws com.google.protobuf.ServiceException,
                                                                                     Throwable

Specified by:

batchCoprocessorService in interface org.apache.hadoop.hbase.client.Table

Throws:

com.google.protobuf.ServiceException

Throwable

batchCoprocessorService

public <R extends com.google.protobuf.Message> void batchCoprocessorService(com.google.protobuf.Descriptors.MethodDescriptor methodDescriptor,
                                                                            com.google.protobuf.Message request,
                                                                            byte[] startKey,
                                                                            byte[] endKey,
                                                                            R responsePrototype,
                                                                            org.apache.hadoop.hbase.client.coprocessor.Batch.Callback<R> callback)
                                                                     throws com.google.protobuf.ServiceException,
                                                                            Throwable

Specified by:

batchCoprocessorService in interface org.apache.hadoop.hbase.client.Table

Throws:

com.google.protobuf.ServiceException

Throwable

addToOperation

public void addToOperation(org.apache.hadoop.hbase.client.OperationWithAttributes op,
                           Transaction tx)
                    throws IOException

Throws:

IOException

makeRollbackOperation

protected void makeRollbackOperation(org.apache.hadoop.hbase.client.Delete delete)

getDescriptor

public org.apache.hadoop.hbase.client.TableDescriptor getDescriptor()
                                                             throws IOException

Specified by:

getDescriptor in interface org.apache.hadoop.hbase.client.Table

Throws:

IOException

exists

public boolean[] exists(List<org.apache.hadoop.hbase.client.Get> gets)
                 throws IOException

Specified by:

exists in interface org.apache.hadoop.hbase.client.Table

Throws:

IOException

getRpcTimeout

public long getRpcTimeout(TimeUnit unit)

Specified by:

getRpcTimeout in interface org.apache.hadoop.hbase.client.Table

getRpcTimeout

public int getRpcTimeout()

Specified by:

getRpcTimeout in interface org.apache.hadoop.hbase.client.Table

setRpcTimeout

public void setRpcTimeout(int rpcTimeout)

Specified by:

setRpcTimeout in interface org.apache.hadoop.hbase.client.Table

getReadRpcTimeout

public long getReadRpcTimeout(TimeUnit unit)

Specified by:

getReadRpcTimeout in interface org.apache.hadoop.hbase.client.Table

getReadRpcTimeout

public int getReadRpcTimeout()

Specified by:

getReadRpcTimeout in interface org.apache.hadoop.hbase.client.Table

setReadRpcTimeout

public void setReadRpcTimeout(int readRpcTimeout)

Specified by:

setReadRpcTimeout in interface org.apache.hadoop.hbase.client.Table

getWriteRpcTimeout

public long getWriteRpcTimeout(TimeUnit unit)

Specified by:

getWriteRpcTimeout in interface org.apache.hadoop.hbase.client.Table

getWriteRpcTimeout

public int getWriteRpcTimeout()

Specified by:

getWriteRpcTimeout in interface org.apache.hadoop.hbase.client.Table

setWriteRpcTimeout

public void setWriteRpcTimeout(int writeRpcTimeout)

Specified by:

setWriteRpcTimeout in interface org.apache.hadoop.hbase.client.Table

getOperationTimeout

public long getOperationTimeout(TimeUnit unit)

Specified by:

getOperationTimeout in interface org.apache.hadoop.hbase.client.Table

getOperationTimeout

public int getOperationTimeout()

Specified by:

getOperationTimeout in interface org.apache.hadoop.hbase.client.Table

setOperationTimeout

public void setOperationTimeout(int operationTimeout)

Specified by:

setOperationTimeout in interface org.apache.hadoop.hbase.client.Table

checkAndMutate

public org.apache.hadoop.hbase.client.Table.CheckAndMutateBuilder checkAndMutate(byte[] row,
                                                                                 byte[] family)

Specified by:

checkAndMutate in interface org.apache.hadoop.hbase.client.Table