ResumeTxTest (GemFire XD Java API Documentation)

java.lang.Object
- resumeTx.ResumeTxTest

```
public class ResumeTxTest
extends Object
```
A class to test resumeable transactions.

Since:

6.6

Field Summary

Fields
Modifier and Type	Field and Description
`protected static int`	`BEGIN_TX`
`protected static int`	`COMMIT`
`protected static int`	`EXECUTE_NONTX_OPS`
`protected static int`	`EXECUTE_TX_OPS`
`protected long`	`minTaskGranularityMS`
`protected long`	`minTaskGranularitySec`
`protected static int`	`ROLLBACK`
`static ResumeTxTest`	`testInstance`

Constructor Summary

Constructors
Constructor and Description

ResumeTxTest()

Constructors
Constructor and Description
`ResumeTxTest()`

Method Summary

All Methods Static Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`static String`	`activeTxnsToString(Map activeTxns)`
`protected TxInfo`	`begin()`
`static void`	`CloseTask_finishAllActiveTx()`
`protected boolean`	`commit(TxInfo txInfo)`
`protected void`	`concTxWithFE()`
`void`	`doTransactions()` Based on ResumeTxBB ACTIVE_TXNs map, execute being, tx ops or commit.
`protected boolean`	`executeNonTxOps()`
`protected boolean`	`executeTxOps(TxInfo txInfo)`
`protected void`	`finishAllActiveTx()`
`static void`	`HydraTask_concTxWithFE()` Hydratask for concurrent resumeable transaction with function execution tests
`static void`	`HydraTask_initialize()`
`static void`	`HydraTask_serialRRTxWithFE()` Hydratask for serial round robin test
`static void`	`HydraTask_stopStartDataStores()` Randomly stop and restart dataStore vms.
`static void`	`HydraTask_tryResumeWithWait()` Threads in this task will obtain an active transaction from the ResumeTxBB (blackboard) and use function execution to enter a tryResume(with wait).
`static void`	`HydraTask_TXController()` Assigned to only one thread at a time, this thread executes a resumeable transaction via Function Execution, but does not suspend between begin, doOps and commit.
`protected void`	`initialize()`
`protected boolean`	`rollback(TxInfo txInfo)`
`protected void`	`serialRRTxWithFE()`
`static void`	`StartTask_initialize()`
`protected void`	`stopStartDataStores()`
`protected boolean`	`tryResume(TxInfo txInfo)`
`protected void`	`tryResumeWithWait()`
`protected void`	`TXController()` Launch TXController function (begin, execute transactional ops, commit without suspending)
`protected void`	`verifyTx(TxInfo txInfo)` verifyTx executes a function on each server.

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Field Detail
  - testInstance
```
public static ResumeTxTest testInstance
```
  - minTaskGranularitySec
```
protected long minTaskGranularitySec
```
  - minTaskGranularityMS
```
protected long minTaskGranularityMS
```
  - BEGIN_TX
```
protected static final int BEGIN_TX
```
    See Also:
    
    Constant Field Values
  - EXECUTE_TX_OPS
```
protected static final int EXECUTE_TX_OPS
```
    See Also:
    
    Constant Field Values
  - EXECUTE_NONTX_OPS
```
protected static final int EXECUTE_NONTX_OPS
```
    See Also:
    
    Constant Field Values
  - COMMIT
```
protected static final int COMMIT
```
    See Also:
    
    Constant Field Values
  - ROLLBACK
```
protected static final int ROLLBACK
```
    See Also:
    
    Constant Field Values
- Constructor Detail
  - ResumeTxTest
```
public ResumeTxTest()
```
- Method Detail
  - StartTask_initialize
```
public static void StartTask_initialize()
```
  - HydraTask_initialize
```
public static void HydraTask_initialize()
```
  - initialize
```
protected void initialize()
```
  - HydraTask_concTxWithFE
```
public static void HydraTask_concTxWithFE()
                                   throws Exception
```
    Hydratask for concurrent resumeable transaction with function execution tests
    
    Throws:
    
    Exception
  - concTxWithFE
```
protected void concTxWithFE()
                     throws Exception
```
    Throws:
    
    Exception
  - doTransactions
```
public void doTransactions()
                    throws Exception
```
    Based on ResumeTxBB ACTIVE_TXNs map, execute being, tx ops or commit. Map consists of the key (txId) + the number of times we resumed this tx (EXECUTE_TX_OPS). Entries are removed when the transaction is committed or rolled back.
    
    Throws:
    
    Exception
  - CloseTask_finishAllActiveTx
```
public static void CloseTask_finishAllActiveTx()
                                        throws Exception
```
    Throws:
    
    Exception
  - finishAllActiveTx
```
protected void finishAllActiveTx()
                          throws Exception
```
    Throws:
    
    Exception
  - begin
```
protected TxInfo begin()
```
  - executeTxOps
```
protected boolean executeTxOps(TxInfo txInfo)
```
  - executeNonTxOps
```
protected boolean executeNonTxOps()
```
  - commit
```
protected boolean commit(TxInfo txInfo)
```
  - rollback
```
protected boolean rollback(TxInfo txInfo)
```
  - HydraTask_serialRRTxWithFE
```
public static void HydraTask_serialRRTxWithFE()
                                       throws Exception
```
    Hydratask for serial round robin test
    
    Throws:
    
    Exception
  - serialRRTxWithFE
```
protected void serialRRTxWithFE()
                         throws Exception
```
    Throws:
    
    Exception
  - verifyTx
```
protected void verifyTx(TxInfo txInfo)
```
    verifyTx executes a function on each server. This function verifies that the server regions contain the expected keysValues (see ResumeTxBB.computeExpectedKeysValues()). This snapshot is based on the BB OpList which is updated after each client returns from executing the ExecuteTx function. Throws a TestException is validation is not successful (see ResumeTxBB.ERRSTR).
  - HydraTask_TXController
```
public static void HydraTask_TXController()
```
    Assigned to only one thread at a time, this thread executes a resumeable transaction via Function Execution, but does not suspend between begin, doOps and commit. All other threads will be in a tryResume(with wait) and should return immediately after this thread commits the transaction.
  - TXController
```
protected void TXController()
```
    Launch TXController function (begin, execute transactional ops, commit without suspending)
  - HydraTask_tryResumeWithWait
```
public static void HydraTask_tryResumeWithWait()
                                        throws Exception
```
    Threads in this task will obtain an active transaction from the ResumeTxBB (blackboard) and use function execution to enter a tryResume(with wait). Since the TXController thread does not suspend during its transaction, any threads in tryResume should exit immmediately when the TXController commits.
    
    Throws:
    
    Exception
  - tryResumeWithWait
```
protected void tryResumeWithWait()
                          throws Exception
```
    Throws:
    
    Exception
  - tryResume
```
protected boolean tryResume(TxInfo txInfo)
```
  - HydraTask_stopStartDataStores
```
public static void HydraTask_stopStartDataStores()
```
    Randomly stop and restart dataStore vms. Tests which invoke this must also call util.StopStartVMs.StopStart_init as a INITTASK (to write clientNames to the Blackboard). For peer tests with PRs, dataStore vm names must include "dataStore"; for client/server tests the server/dataStore names must contain "bridge". (See matchStr below). For peer tests with RRs (replicated regions), vm names must include "client"; for client/server tests, the server names must contain "bridge".
  - stopStartDataStores
```
protected void stopStartDataStores()
```
  - activeTxnsToString
```
public static String activeTxnsToString(Map activeTxns)
```

Class ResumeTxTest

Field Summary

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Field Detail

testInstance

minTaskGranularitySec

minTaskGranularityMS

BEGIN_TX

EXECUTE_TX_OPS

EXECUTE_NONTX_OPS

COMMIT

ROLLBACK

Constructor Detail

ResumeTxTest

Method Detail

StartTask_initialize

HydraTask_initialize

initialize

HydraTask_concTxWithFE

concTxWithFE

doTransactions

CloseTask_finishAllActiveTx

finishAllActiveTx

begin

executeTxOps

executeNonTxOps

commit

rollback

HydraTask_serialRRTxWithFE

serialRRTxWithFE

verifyTx

HydraTask_TXController

TXController

HydraTask_tryResumeWithWait

tryResumeWithWait

tryResume

HydraTask_stopStartDataStores

stopStartDataStores

activeTxnsToString