org.apache.hadoop.hbase.regionserver

Class RegionMergeTransactionImpl

java.lang.Object

org.apache.hadoop.hbase.regionserver.RegionMergeTransactionImpl

All Implemented Interfaces:

RegionMergeTransaction

@InterfaceAudience.Private
public class RegionMergeTransactionImpl
extends Object
implements RegionMergeTransaction

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	RegionMergeTransactionImpl.JournalEntryImpl

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

RegionMergeTransaction.JournalEntry, RegionMergeTransaction.RegionMergeTransactionPhase, RegionMergeTransaction.TransactionListener

Constructor Summary

Constructors

Constructor and Description
RegionMergeTransactionImpl(Region a, Region b, boolean forcible) Constructor
RegionMergeTransactionImpl(Region a, Region b, boolean forcible, long masterSystemTime) Constructor

Method Summary

Modifier and Type	Method and Description
Put	addLocation(Put p, ServerName sn, long openSeqNum)
HRegion	execute(Server server, RegionServerServices services) Run the transaction.
HRegion	execute(Server server, RegionServerServices services, User user) Run the transaction.
List<RegionMergeTransaction.JournalEntry>	getJournal() Get the journal for the transaction.
HRegionInfo	getMergedRegionInfo()
static HRegionInfo	getMergedRegionInfo(HRegionInfo a, HRegionInfo b) Get merged region info through the specified two regions
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(RegionServerServices services) Does checks on merge inputs.
void	prepareMutationsForMerge(HRegionInfo mergedRegion, HRegionInfo regionA, HRegionInfo regionB, ServerName serverName, List<Mutation> mutations, int regionReplication)
RegionMergeTransaction	registerTransactionListener(RegionMergeTransaction.TransactionListener listener) Register a listener for transaction preparation, execution, and possibly rollback phases.
boolean	rollback(Server server, RegionServerServices services) Roll back a failed transaction
boolean	rollback(Server server, RegionServerServices services, User user) Roll back a failed transaction
void	stepsAfterPONR(Server server, RegionServerServices services, HRegion mergedRegion) Deprecated.
void	stepsAfterPONR(Server server, RegionServerServices services, HRegion mergedRegion, User user)
HRegion	stepsBeforePONR(Server server, RegionServerServices services, boolean testing)

Methods inherited from class java.lang.Object

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

Constructor Detail

RegionMergeTransactionImpl

public RegionMergeTransactionImpl(Region a,
                                  Region b,
                                  boolean forcible)

Constructor

Parameters:

a - region a to merge

b - region b to merge

forcible - if false, we will only merge adjacent regions

RegionMergeTransactionImpl

public RegionMergeTransactionImpl(Region a,
                                  Region b,
                                  boolean forcible,
                                  long masterSystemTime)

Constructor

Parameters:

a - region a to merge

b - region b to merge

forcible - if false, we will only merge adjacent regions

masterSystemTime - the time at the master side

Method Detail

prepare

public boolean prepare(RegionServerServices services)
                throws IOException

Does checks on merge inputs.

Specified by:

prepare in interface RegionMergeTransaction

Parameters:

services -

Returns:

true if the regions are mergeable else false if they are not (e.g. its already closed, etc.).

Throws:

IOException

execute

public HRegion execute(Server server,
                       RegionServerServices services)
                throws IOException

Run the transaction.

Specified by:

execute in interface RegionMergeTransaction

Parameters:

server - Hosting server instance. Can be null when testing

services - Used to online/offline regions.

Returns:

merged region

Throws:

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

IOException

See Also:

rollback(Server, RegionServerServices)

execute

public HRegion execute(Server server,
                       RegionServerServices services,
                       User user)
                throws IOException

Description copied from interface: RegionMergeTransaction

Run the transaction.

Specified by:

execute in interface RegionMergeTransaction

Parameters:

server - Hosting server instance. Can be null when testing

services - Used to online/offline regions.

Returns:

merged region

Throws:

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

See Also:

RegionMergeTransaction.rollback(Server, RegionServerServices, User)

stepsAfterPONR

@Deprecated
public void stepsAfterPONR(Server server,
                                       RegionServerServices services,
                                       HRegion mergedRegion)
                                throws IOException

Deprecated.

Throws:

IOException

stepsAfterPONR

public void stepsAfterPONR(Server server,
                           RegionServerServices services,
                           HRegion mergedRegion,
                           User user)
                    throws IOException

Throws:

IOException

prepareMutationsForMerge

public void prepareMutationsForMerge(HRegionInfo mergedRegion,
                                     HRegionInfo regionA,
                                     HRegionInfo regionB,
                                     ServerName serverName,
                                     List<Mutation> mutations,
                                     int regionReplication)
                              throws IOException

Throws:

IOException

addLocation

public Put addLocation(Put p,
                       ServerName sn,
                       long openSeqNum)

stepsBeforePONR

public HRegion stepsBeforePONR(Server server,
                               RegionServerServices services,
                               boolean testing)
                        throws IOException

Throws:

IOException

getMergedRegionInfo

public static HRegionInfo getMergedRegionInfo(HRegionInfo a,
                                              HRegionInfo b)

Get merged region info through the specified two regions

Parameters:

a - merging region A

b - merging region B

Returns:

the merged region info

rollback

public boolean rollback(Server server,
                        RegionServerServices services)
                 throws IOException

Description copied from interface: RegionMergeTransaction

Roll back a failed transaction

Specified by:

rollback in interface RegionMergeTransaction

Parameters:

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

services - Services of regionserver, used to online regions.

Returns:

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.

Throws:

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

rollback

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

Description copied from interface: RegionMergeTransaction

Roll back a failed transaction

Specified by:

rollback in interface RegionMergeTransaction

Parameters:

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

services - Services of regionserver, used to online regions.

Returns:

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.

Throws:

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

getMergedRegionInfo

public HRegionInfo getMergedRegionInfo()

Specified by:

getMergedRegionInfo in interface RegionMergeTransaction

Returns:

merged region info

getJournal

public List<RegionMergeTransaction.JournalEntry> getJournal()

Description copied from interface: RegionMergeTransaction

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.

Specified by:

getJournal in interface RegionMergeTransaction

Returns:

the transaction journal

registerTransactionListener

public RegionMergeTransaction registerTransactionListener(RegionMergeTransaction.TransactionListener listener)

Description copied from interface: RegionMergeTransaction

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

A listener can abort a transaction by throwing an exception.

Specified by:

registerTransactionListener in interface RegionMergeTransaction

Parameters:

listener - the listener

Returns:

'this' for chaining

getServer

public Server getServer()

Description copied from interface: RegionMergeTransaction

Get the Server running the transaction or rollback

Specified by:

getServer in interface RegionMergeTransaction

Returns:

server instance

getRegionServerServices

public RegionServerServices getRegionServerServices()

Description copied from interface: RegionMergeTransaction

Get the RegonServerServices of the server running the transaction or rollback

Specified by:

getRegionServerServices in interface RegionMergeTransaction

Returns:

region server services