org.apache.hadoop.hbase.regionserver

接口 SplitTransaction

所有已知实现类:

SplitTransactionImpl

@InterfaceAudience.LimitedPrivate(value="Coprocesssor")
@InterfaceStability.Evolving
public interface SplitTransaction

Executes region split as a "transaction". Call prepare() to setup the transaction, execute(Server, RegionServerServices) to run the transaction and rollback(Server, RegionServerServices) to cleanup if execute fails.

Here is an example of how you would use this interface:

  SplitTransactionFactory factory = new SplitTransactionFactory(conf);
  SplitTransaction st = factory.create(parent, midKey)
    .registerTransactionListener(new TransactionListener() {
       public void transition(SplitTransaction transaction, SplitTransactionPhase from,
           SplitTransactionPhase to) throws IOException {
         // ...
       }
       public void rollback(SplitTransaction transaction, SplitTransactionPhase from,
           SplitTransactionPhase to) {
         // ...
       }
    });
  if (!st.prepare()) return;
  try {
    st.execute(server, services);
  } catch (IOException e) {
    try {
      st.rollback(server, services);
      return;
    } catch (RuntimeException e) {
      // abort the server
    }
  }
 

A split transaction is not thread safe. Callers must ensure a split is run by one thread only.

嵌套类概要

嵌套类

限定符和类型	接口和说明
static interface	SplitTransaction.JournalEntry Split transaction journal entry
static class	SplitTransaction.SplitTransactionPhase Each enum is a step in the split transaction.
static interface	SplitTransaction.TransactionListener Split transaction listener

方法概要

方法

限定符和类型	方法和说明
PairOfSameType<Region>	execute(Server server, RegionServerServices services) 已过时。 use #execute(Server, RegionServerServices, User)
PairOfSameType<Region>	execute(Server server, RegionServerServices services, User user) Run the transaction.
List<SplitTransaction.JournalEntry>	getJournal() Get the journal for the transaction.
RegionServerServices	getRegionServerServices() Get the RegonServerServices of the server running the transaction or rollback
Server	getServer() Get the Server running the transaction or rollback
boolean	prepare() Check split inputs and prepare the transaction.
SplitTransaction	registerTransactionListener(SplitTransaction.TransactionListener listener) Register a listener for transaction preparation, execution, and possibly rollback phases.
boolean	rollback(Server server, RegionServerServices services) 已过时。 use #rollback(Server, RegionServerServices, User)
boolean	rollback(Server server, RegionServerServices services, User user) Roll back a failed transaction

方法详细资料

prepare

boolean prepare()
                throws IOException

Check split inputs and prepare the transaction.

返回:

true if the region is splittable else false if it is not (e.g. its already closed, etc.).

抛出:

IOException

execute

@Deprecated
PairOfSameType<Region> execute(Server server,
                                        RegionServerServices services)
                               throws IOException

已过时。 use #execute(Server, RegionServerServices, User)

Run the transaction.

参数:

server - Hosting server instance. Can be null when testing.

services - Used to online/offline regions.

返回:

Regions created

抛出:

IOException - If thrown, transaction failed. Call rollback(Server, RegionServerServices)

IOException

另请参阅:

rollback(Server, RegionServerServices)

execute

PairOfSameType<Region> execute(Server server,
                             RegionServerServices services,
                             User user)
                               throws IOException

Run the transaction.

参数:

server - Hosting server instance. Can be null when testing.

services - Used to online/offline regions.

user -

返回:

Regions created

抛出:

IOException - If thrown, transaction failed. Call rollback(Server, RegionServerServices)

IOException

另请参阅:

rollback(Server, RegionServerServices)

rollback

@Deprecated
boolean rollback(Server server,
                          RegionServerServices services)
                 throws IOException

已过时。 use #rollback(Server, RegionServerServices, User)

Roll back a failed transaction

参数:

server - Hosting server instance (May be null when testing).

services -

返回:

True if we successfully rolled back, false if we got to the point of no return and so now need to abort the server to minimize damage.

抛出:

IOException - If thrown, rollback failed. Take drastic action.

rollback

boolean rollback(Server server,
               RegionServerServices services,
               User user)
                 throws IOException

Roll back a failed transaction

参数:

server - Hosting server instance (May be null when testing).

services -

user -

返回:

True if we successfully rolled back, false if we got to the point of no return and so now need to abort the server to minimize damage.

抛出:

IOException - If thrown, rollback failed. Take drastic action.

registerTransactionListener

SplitTransaction registerTransactionListener(SplitTransaction.TransactionListener listener)

Register a listener for transaction preparation, execution, and possibly rollback phases.

A listener can abort a transaction by throwing an exception.

参数:

listener - the listener

返回:

'this' for chaining

getJournal

List<SplitTransaction.JournalEntry> getJournal()

Get the journal for the transaction.

Journal entries are an opaque type represented as JournalEntry. They can also provide useful debugging information via their toString method.

返回:

the transaction journal

getServer

Server getServer()

Get the Server running the transaction or rollback

返回:

server instance

getRegionServerServices

RegionServerServices getRegionServerServices()

Get the RegonServerServices of the server running the transaction or rollback

返回:

region server services