tx

Class RegionValidator

java.lang.Object

tx.RegionValidator

public class RegionValidator
extends Object

A class that holds information to aid in region validation and supplies methods to get the expected behavior (based on operation and whether or not the tx operation should be visible in the calling thread) as well as the actual values. A compare() method is also suppled to provide a check of expected data values / actual data values. Each instance holds: - regionName - operation (for better logging when comparisons fail) - regionExists (boolean) - hasKeys (boolean) - hasValues (boolean) In order to support the expected values on a per operation basis, Maps holding templates of RegionValidators are established at class initialization (one for the checks required if the tx should be visible by the calling thread and another if the tx should NOT be visible. A calling application will get the expected behavior by invoking: getExpected(Operation op, boolean isVisible). - regionExists (whether or not the region should exist for this operation) - hasKeys (whether or not the region should contain keys) - hasValues (whether or not the keys in this region are expected to have values Applications also invoke the getActual(Operation op) method to get the actual state from the VMs cache: regionExists (getRegion) hasKeys (region.keySet().size()) hasValues (iterate over keys and check containsValueForKey) Once both RegionValidator instances have been constructed, the application can invoke the instance method .compare( ) If the expected values/state are not found, a Test Exception is thrown.

Constructor Summary

Constructors

Constructor and Description
RegionValidator(boolean regionExists, boolean hasKeys, boolean hasValues) Constructor to create a RegionValidator used internally by this class to create templates based on expected values maps.
RegionValidator(Operation op) noArg constructor
RegionValidator(Operation op, String regionName, boolean regionExists, boolean hasKeys, boolean hasValues) Constructor to create a RegionValidator

Method Summary

Modifier and Type	Method and Description
void	compare(RegionValidator vc) Compare two validator controls, throw an exception if not a match
static RegionValidator	getActual(Operation op)
static RegionValidator	getExpected(Operation op, boolean isVisible)
String	getRegionName()
void	setRegionName(String regionName)
String	toString() Return a string description of the RegionValidator

Methods inherited from class java.lang.Object

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

Constructor Detail

RegionValidator

public RegionValidator(Operation op)

noArg constructor

RegionValidator

public RegionValidator(boolean regionExists,
                       boolean hasKeys,
                       boolean hasValues)

Constructor to create a RegionValidator used internally by this class to create templates based on expected values maps. (See static initializer above)

Parameters:

regionExists - boolean (true => expect region to exist)

hasKeys - boolean (true => expect region.containsKey() == true)

hasValues - boolean (true => expect region.containsValueForKey() == true)

RegionValidator

public RegionValidator(Operation op,
                       String regionName,
                       boolean regionExists,
                       boolean hasKeys,
                       boolean hasValues)

Constructor to create a RegionValidator

Parameters:

op - - The Operation being validated

regionName - The name of the region involved in the operation.

regionExists - boolean (true => expect region.containsKey() == true)

hasKeys - booealn (true => expect region to contain keyset)

hasValue - boolean (true => expect keys in region to return true for .containsValueForKey())

Method Detail

getRegionName

public String getRegionName()

setRegionName

public void setRegionName(String regionName)

getExpected

public static RegionValidator getExpected(Operation op,
                                          boolean isVisible)

getActual

public static RegionValidator getActual(Operation op)

compare

public void compare(RegionValidator vc)

Compare two validator controls, throw an exception if not a match

toString

public String toString()

Return a string description of the RegionValidator

Overrides:

toString in class Object