Skip navigation links

Oracle® Coherence Java API Reference
v3.5

E14977-01


com.tangosol.io.pof.reflect
Interface PofValue

All Known Implementing Classes:
AbstractPofValue, ComplexPofValue, PofArray, PofCollection, PofSparseArray, PofSparseArray.NilPofValue, PofUniformArray, PofUniformCollection, PofUniformSparseArray, PofUserType, SimplePofValue

public interface PofValue

PofValue represents the POF data structure in a POF stream, or any sub-structure or value thereof.

Since:
Coherence 3.5
Author:
as 2009.02.12
See Also:
PofValueParser.parse(ReadBuffer, PofContext)

Method Summary
 Binary applyChanges()
          Apply all the changes that were made to this value and return a binary representation of the new value.
 ReadBuffer getChanges()
          Return a buffer containing changes made to this PofValue in the format defined by the BinaryDeltaCompressor.
 PofValue getChild(int nIndex)
          Locate a child PofValue contained within this PofValue.
 PofValue getParent()
          Return the parent of this value.
 PofValue getRoot()
          Return the root of the hierarchy this value belongs to.
 int getTypeId()
          Obtain the POF type identifier for this value.
 java.lang.Object getValue()
          Return the deserialized value which this PofValue represents.
 void setValue(java.lang.Object oValue)
          Update this PofValue.

 

Method Detail

getTypeId

int getTypeId()
Obtain the POF type identifier for this value.
Returns:
POF type identifier for this value

getRoot

PofValue getRoot()
Return the root of the hierarchy this value belongs to.
Returns:
the root value

getParent

PofValue getParent()
Return the parent of this value.
Returns:
the parent value, or null if this is root value

getChild

PofValue getChild(int nIndex)
Locate a child PofValue contained within this PofValue. <p/> Note: the returned PofValue could represent a non-existent (null) value.
Parameters:
nIndex - index of the child value
Returns:
the child PofValue
Throws:
PofNavigationException - if this value is a "terminal" or the child value cannot be located for any other reason

getValue

java.lang.Object getValue()
Return the deserialized value which this PofValue represents.
Returns:
the deserialized value

setValue

void setValue(java.lang.Object oValue)
Update this PofValue. <p/> The changes made using this method will be immediately reflected in the result of getValue() method, but will not be applied to the underlying POF stream until the applyChanges() method is invoked on the root PofValue.
Parameters:
oValue - new deserialized value for this PofValue

applyChanges

Binary applyChanges()
Apply all the changes that were made to this value and return a binary representation of the new value. <p/> Any format prefixes and/or decorations that were present in the original buffer this value orginated from will be preserved. <p/> Note: this method can only be called on the root PofValue.
Returns:
new Binary object that contains modified PofValue
Throws:
java.lang.UnsupportedOperationException - if called on a non-root PofValue

getChanges

ReadBuffer getChanges()
Return a buffer containing changes made to this PofValue in the format defined by the BinaryDeltaCompressor. <p/> Note: this method can only be called on the root PofValue
Returns:
a buffer containing changes made to this PofValue
Throws:
java.lang.UnsupportedOperationException - if called on a non-root PofValue

Skip navigation links

Oracle® Coherence Java API Reference
v3.5

E14977-01


Copyright © 2000, 2009, Oracle. All rights reserved.