util

Class BaseValueHolder

java.lang.Object

util.BaseValueHolder

All Implemented Interfaces:

ValueHolderIF

Direct Known Subclasses:

ValueHolder, VHDataSerializable

public abstract class BaseValueHolder
extends Object
implements ValueHolderIF

DO NOT make this class implement java.io.Serializable!!! This is important for testing functions and partition resolvers which changed their API from using java.io.Serializable to Object in 6.6.2 (product changes by Darrel).

Field Summary

Fields

Modifier and Type	Field and Description
Object	extraObject The other object referred to by this ValueHolder
Integer	modVal An object that can be manipulated (leaving myValue to hold a value which allows validation against the key)
Object	myValue The value held by this ValueHolder
String	myVersion

Constructor Summary

Constructors

Constructor and Description
BaseValueHolder() No-arg constructor
BaseValueHolder(Object anObj, RandomValues randomValues) Create a new instance of ValueHolder.
BaseValueHolder(Object anObj, RandomValues randomValues, Integer initModVal) Create a new instance of ValueHolder.
BaseValueHolder(RandomValues randomValues) Create a new instance of ValueHolder.
BaseValueHolder(String nameFactoryName, RandomValues randomValues) Create a new instance of ValueHolder.
BaseValueHolder(String nameFactoryName, RandomValues randomValues, Integer initModVal) Create a new instance of ValueHolder.

Method Summary

Modifier and Type	Method and Description
boolean	equals(Object anObj)
BaseValueHolder	getAlternateValueHolder(RandomValues randomValues) Using the current values in this ValueHolder, return a new ValueHolder that has the same "value" in myValue and a new extraObject if extraObject is used.
Object	getExtraObject() Returns the extra object associated with this value holder.
Integer	getModVal() Returns the extra object associated with this value holder.
Object	getMyValue() Returns the value associated with this value holder.
int	hashCode()
void	incrementModVal(Integer val)
void	setModVal(Integer val)
String	toString()
void	verifyMyFields(long base) Verify the fields of this instance
void	verifyMyFields(String string, long base)

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Field Detail

myVersion

public String myVersion

myValue

public Object myValue

The value held by this ValueHolder

extraObject

public Object extraObject

The other object referred to by this ValueHolder

modVal

public Integer modVal

An object that can be manipulated (leaving myValue to hold a value which allows validation against the key)

Constructor Detail

BaseValueHolder

public BaseValueHolder()

No-arg constructor

BaseValueHolder

public BaseValueHolder(Object anObj,
                       RandomValues randomValues)

Create a new instance of ValueHolder. The new ValueHolder will have anObj placed as its myValue field and, if desired, extraObject will be filled in using randomValues if ValueHolderPrms.useExtraObject is set to true.

Parameters:

anObj - - Used for myValue.

randomValues - - Used to generate extraObject, if needed.

BaseValueHolder

public BaseValueHolder(RandomValues randomValues)

Create a new instance of ValueHolder. The new ValueHolder will have random values for myValue and, if desired, extraObject. If ValueHolderPrms.useExtraObject is set, the extraObject field will be filled in.

Parameters:

randomValues - - Used to generate myValue and extraObject, if needed.

BaseValueHolder

public BaseValueHolder(String nameFactoryName,
                       RandomValues randomValues)

Create a new instance of ValueHolder. The new ValueHolder will have a Long for myValue, using the nameFactoryName to extract the long. If ValueHolderPrms.useExtraObject is set, the extraObject field will be filled in using randomValues.

Parameters:

nameFactoryName - - A name from NameFactory, used to extract a value for the ValueHolder myValue.

randomValues - - Used to generate an extraObject, if needed. If useExtraObject is false, this can be null

See Also:

NameFactory.getCounterForName(java.lang.Object)

BaseValueHolder

public BaseValueHolder(Object anObj,
                       RandomValues randomValues,
                       Integer initModVal)

Create a new instance of ValueHolder. The new ValueHolder will have anObj placed as its myValue field and, if desired, extraObject will be filled in using randomValues if ValueHolderPrms.useExtraObject is set to true. In addition, modVal will be initialized with initModVal.

Parameters:

anObj - - Used for myValue.

randomValues - - Used to generate extraObject, if needed.

initModVal - - Use for initialization of modVal

BaseValueHolder

public BaseValueHolder(String nameFactoryName,
                       RandomValues randomValues,
                       Integer initModVal)

Create a new instance of ValueHolder. The new ValueHolder will have a Long for myValue, using the nameFactoryName to extract the long. If ValueHolderPrms.useExtraObject is set, the extraObject field will be filled in using randomValues. initModVal will be used to initialize modVal

Parameters:

nameFactoryName - - A name from NameFactory, used to extract a value for the ValueHolder myValue.

randomValues - - Used to generate an extraObject, if needed. If useExtraObject is false, this can be null

initModVal - - initializer for modVal

See Also:

NameFactory.getCounterForName(java.lang.Object)

Method Detail

getMyValue

public Object getMyValue()

Description copied from interface: ValueHolderIF

Returns the value associated with this value holder.

Specified by:

getMyValue in interface ValueHolderIF

getExtraObject

public Object getExtraObject()

Description copied from interface: ValueHolderIF

Returns the extra object associated with this value holder.

Specified by:

getExtraObject in interface ValueHolderIF

getModVal

public Integer getModVal()

Description copied from interface: ValueHolderIF

Returns the extra object associated with this value holder.

Specified by:

getModVal in interface ValueHolderIF

setModVal

public void setModVal(Integer val)

incrementModVal

public void incrementModVal(Integer val)

toString

public String toString()

Overrides:

toString in class Object

getAlternateValueHolder

public BaseValueHolder getAlternateValueHolder(RandomValues randomValues)

Using the current values in this ValueHolder, return a new ValueHolder that has the same "value" in myValue and a new extraObject if extraObject is used. For example, if this.myValue contains a Long of value 34, the new ValueHolder will also have a myValue of 34, but it may be a String, an Integer, a BigInteger, etc.

Returns:

A new instance of ValueHolder

Throws:

TestException - If we cannot find an alternative value for this value in this ValueHolder.

verifyMyFields

public void verifyMyFields(long base)

Verify the fields of this instance

Parameters:

base - The expected base value used to give the fields values.

verifyMyFields

public void verifyMyFields(String string,
                           long base)

Parameters:

string -

hashCode

public int hashCode()

Overrides:

hashCode in class Object

equals

public boolean equals(Object anObj)

Overrides:

equals in class Object