BasicDLockClient (GemFire XD Java API Documentation)

java.lang.Object
- dlock.BasicDLockClient

```
public class BasicDLockClient
extends Object
```
N clients compete for M objects and lock P objects at a time.

Field Summary

Fields
Modifier and Type Field and Description

protected static HydraThreadLocal localindex

protected static HydraThreadLocal localinfo

static String ROOT_REGION_NAME

Fields
Modifier and Type	Field and Description
`protected static HydraThreadLocal`	`localindex`
`protected static HydraThreadLocal`	`localinfo`
`static String`	`ROOT_REGION_NAME`

Constructor Summary

Constructors
Constructor and Description

BasicDLockClient()

Constructors
Constructor and Description
`BasicDLockClient()`

Method Summary

All Methods Static Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`static void`	`closeCacheTask()` closeCacheTask: General task to unhook the vm from the distributed cache.
`static void`	`closeTask()` closeTask: CLOSETASK to report results of validation structures
`static void`	`crashLockHolderTask()` Task: TASK to verify crashing the lock holder doesn't prevent other threads from successfully proceeding to get locks (on same objects).
`static void`	`createCacheTask()` createCacheTask: General task to hook the vm to the distributed cache.
`static void`	`createDataTask()` createDataTask: STARTTASK to create lockable data.
`static void`	`initBBCrashLockHolderTask()` Task: INITTASK to put starting number of threads in shared counter
`static void`	`initTask()` initTask: INITTASK to initialize information about lockable data for validation.
`static void`	`lockEmAllAtOnceTask()` lockEmAllAtOnceTask: TASK to lock all objects on all datatypes before updates
`static void`	`lockRegionTask()` lockRegionTask: TASK to lock all objects on all datatypes by locking the region itself
`protected static com.gemstone.gemfire.LogWriter`	`log()`
`static void`	`noContentionTask()` noContentionTask: TASK to lock one object at a time with no contention.
`static void`	`randomLockTask()` randomLockTask: TASK to lock random objects on random datatypes before updates
`protected void`	`randomLockWork()`
`static void`	`singleFileTask()` singleFileTask: TASK to lock N objects before updates, with all clients starting at the origin
`static void`	`stickLocks()` stickLocks: TASK to creat stuck locks This works to create stuck lock - but per spec change - that's not the main point anymore.
`protected static ConfigHashtable`	`tab()`
`static void`	`validateTask()` validateTask: CLOSETASK to validate results

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

- Field Detail
  - ROOT_REGION_NAME
```
public static final String ROOT_REGION_NAME
```
    See Also:
    
    Constant Field Values
  - localinfo
```
protected static HydraThreadLocal localinfo
```
  - localindex
```
protected static HydraThreadLocal localindex
```
- Constructor Detail
  - BasicDLockClient
```
public BasicDLockClient()
```
- Method Detail
  - createCacheTask
```
public static void createCacheTask()
```
    createCacheTask: General task to hook the vm to the distributed cache.
  - closeCacheTask
```
public static void closeCacheTask()
```
    closeCacheTask: General task to unhook the vm from the distributed cache.
  - createDataTask
```
public static void createDataTask()
```
    createDataTask: STARTTASK to create lockable data.
  - initTask
```
public static void initTask()
```
    initTask: INITTASK to initialize information about lockable data for validation.
  - noContentionTask
```
public static void noContentionTask()
```
    noContentionTask: TASK to lock one object at a time with no contention.
    
    Throws:
    
    HydraConfigException - if there are fewer objects than client threads.
  - singleFileTask
```
public static void singleFileTask()
```
    singleFileTask: TASK to lock N objects before updates, with all clients starting at the origin
  - randomLockTask
```
public static void randomLockTask()
```
    randomLockTask: TASK to lock random objects on random datatypes before updates
  - randomLockWork
```
protected void randomLockWork()
```
  - lockRegionTask
```
public static void lockRegionTask()
```
    lockRegionTask: TASK to lock all objects on all datatypes by locking the region itself
  - lockEmAllAtOnceTask
```
public static void lockEmAllAtOnceTask()
```
    lockEmAllAtOnceTask: TASK to lock all objects on all datatypes before updates
  - initBBCrashLockHolderTask
```
public static void initBBCrashLockHolderTask()
```
    Task: INITTASK to put starting number of threads in shared counter
  - crashLockHolderTask
```
public static void crashLockHolderTask()
                                throws ClientVmNotFoundException
```
    Task: TASK to verify crashing the lock holder doesn't prevent other threads from successfully proceeding to get locks (on same objects). This test follows the pattern of the LeaseTime test. All threads get ready to lock, one (which may also be the lock grantor) starts locking and then crashes.
    
    Throws:
    
    ClientVmNotFoundException
  - stickLocks
```
public static void stickLocks()
```
    stickLocks: TASK to creat stuck locks This works to create stuck lock - but per spec change - that's not the main point anymore.
  - closeTask
```
public static void closeTask()
```
    closeTask: CLOSETASK to report results of validation structures
  - validateTask
```
public static void validateTask()
```
    validateTask: CLOSETASK to validate results
  - log
```
protected static com.gemstone.gemfire.LogWriter log()
```
  - tab
```
protected static ConfigHashtable tab()
```

Class BasicDLockClient

Field Summary

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Field Detail

ROOT_REGION_NAME

localinfo

localindex

Constructor Detail

BasicDLockClient

Method Detail

createCacheTask

closeCacheTask

createDataTask

initTask

noContentionTask

singleFileTask

randomLockTask

randomLockWork

lockRegionTask

lockEmAllAtOnceTask

initBBCrashLockHolderTask

crashLockHolderTask

stickLocks

closeTask

validateTask

log

tab