delta

Class DeltaObject

java.lang.Object

util.QueryObject

delta.DeltaObject

All Implemented Interfaces:

com.gemstone.gemfire.Delta, Serializable, Cloneable, Comparable

Direct Known Subclasses:

BadDeltaObject

public class DeltaObject
extends QueryObject
implements com.gemstone.gemfire.Delta

See Also:

Serialized Form

Field Summary

Fields

Modifier and Type	Field and Description
boolean	aByteArrayChanged
boolean	aPrimitiveBooleanChanged
boolean	aPrimitiveByteChanged
boolean	aPrimitiveCharChanged
boolean	aPrimitiveDoubleChanged
boolean	aPrimitiveFloatChanged
boolean	aPrimitiveIntChanged
boolean	aPrimitiveLongChanged
boolean	aPrimitiveShortChanged
boolean	aStringChanged
static boolean	cloningEnabled

Fields inherited from class util.QueryObject

aBoolean, aByte, aByteArray, aCharacter, aDouble, aFloat, aLong, anInteger, aPrimitiveBoolean, aPrimitiveByte, aPrimitiveChar, aPrimitiveDouble, aPrimitiveFloat, aPrimitiveInt, aPrimitiveLong, aPrimitiveShort, aQueryObject, aShort, aString, EQUAL_VALUES, extra, id, INCREMENT, myVersion, NEGATE, NULL_NONPRIM_FIELDS, RANDOM_VALUES, SEQUENTIAL_VALUES

Constructor Summary

Constructors

Constructor and Description
DeltaObject(long base, int valueGeneration, int byteArraySize, int levels) All the delta fields are initialized using the given base value and valueGeneration to determine the values of each field.

Method Summary

Modifier and Type	Method and Description
protected void	_fromDelta(DataInput in)
protected void	_toDelta(DataOutput out)
Object	clone() Make a copy of the DeltaObject.
DeltaObject	copy() Make a copy of the DeltaObject.
void	fromDelta(DataInput in) Read in and set the changed fields
boolean	hasDelta() Return true if this object has changed a field, false otherwise
void	modify(int changeValueGeneration, int delta, boolean log) Modify the DeltaObject according to changeValueGeneration and delta.
void	reset() Reset the delta object to indicate no changes
void	toDelta(DataOutput out) Write out changed fields

Methods inherited from class util.QueryObject

compareTo, constantToString, depth, equals, fieldsToString, fillInBaseValues, getAtDepth, hasEqualId, hashCode, main, modify, modifyWithNewInstance, modifyWithNewInstance, toString, toString, toString, toStringAbbreviated, toStringAbbreviated, toStringAbbreviated, toStringFull, toStringFull, toStringFull, toStringOneLevel

Methods inherited from class java.lang.Object

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

Field Detail

cloningEnabled

public static boolean cloningEnabled

aPrimitiveLongChanged

public transient boolean aPrimitiveLongChanged

aPrimitiveIntChanged

public transient boolean aPrimitiveIntChanged

aPrimitiveShortChanged

public transient boolean aPrimitiveShortChanged

aPrimitiveFloatChanged

public transient boolean aPrimitiveFloatChanged

aPrimitiveDoubleChanged

public transient boolean aPrimitiveDoubleChanged

aPrimitiveByteChanged

public transient boolean aPrimitiveByteChanged

aPrimitiveCharChanged

public transient boolean aPrimitiveCharChanged

aPrimitiveBooleanChanged

public transient boolean aPrimitiveBooleanChanged

aByteArrayChanged

public transient boolean aByteArrayChanged

aStringChanged

public transient boolean aStringChanged

Constructor Detail

DeltaObject

public DeltaObject(long base,
                   int valueGeneration,
                   int byteArraySize,
                   int levels)

All the delta fields are initialized using the given base value and valueGeneration to determine the values of each field.

Parameters:

base - The base value for all fields. Fields are all set to a value using base as appropriate. Unused if valueGeneration is RANDOM_VALUES.

valueGeneration - How to generate the values of the fields. Can be one of QueryObject.EQUAL_VALUES QueryObject.SEQUENTIAL_VALUES QueryObject.RANDOM_VALUES

byteArraySize - The size of byte[]. If < 0 then there is no byteArray (it is null).

levels - The number of levels of QueryObjects. 1 means the field aQueryObject is null, 2 means aQueryObject contains an instance of QueryObject with fields initialized with base+1, the next level is initialized with base+2 etc.

Method Detail

toDelta

public void toDelta(DataOutput out)
             throws IOException

Write out changed fields

Specified by:

toDelta in interface com.gemstone.gemfire.Delta

Throws:

IOException

_toDelta

protected void _toDelta(DataOutput out)
                 throws IOException

Throws:

IOException

fromDelta

public void fromDelta(DataInput in)
               throws IOException

Read in and set the changed fields

Specified by:

fromDelta in interface com.gemstone.gemfire.Delta

Throws:

IOException

_fromDelta

protected void _fromDelta(DataInput in)
                   throws IOException

Throws:

IOException

hasDelta

public boolean hasDelta()

Return true if this object has changed a field, false otherwise

Specified by:

hasDelta in interface com.gemstone.gemfire.Delta

reset

public void reset()

Reset the delta object to indicate no changes

clone

public Object clone()
             throws CloneNotSupportedException

Make a copy of the DeltaObject.

Overrides:

clone in class QueryObject

Throws:

CloneNotSupportedException

copy

public DeltaObject copy()

Make a copy of the DeltaObject. This is so the test can make a copy of a DeltaObject without calling DeltaObject's clone() method, which does bookkeeping for validation so the test can verify when clone() is called by the product. This copy is used in the regionsnapshot to record what the field values should be for validation; since the delta feature writes fields directly, it's a bit safer to put our own copy of the values into the regionsnapshot.

modify

public void modify(int changeValueGeneration,
                   int delta,
                   boolean log)

Modify the DeltaObject according to changeValueGeneration and delta.

Overrides:

modify in class QueryObject

Parameters:

changeValueGeneration - How to determine the new values Can be one of: QueryObject.INCREMENT QueryObject.NEGATE QueryObject.NULL_NONPRIM_FIELDS If any fields are null and this is INCREMENT or NEGATE then the field is filled in with a random value.

delta - The number to increment or decrement; unused if changeValueGeneration is QueryObject.NEGATE.

log - If true, then log what is being modified, if false don't log since output can be large.