EclipseLink1.0 - 20080707 API Reference

org.eclipse.persistence.sdo
Class SDODataObject

java.lang.Object
  extended by org.eclipse.persistence.sdo.SDODataObject
All Implemented Interfaces:
commonj.sdo.DataObject, java.io.Serializable, SequencedObject

public class SDODataObject
extends java.lang.Object
implements commonj.sdo.DataObject, SequencedObject

See Also:
Serialized Form

Constructor Summary
SDODataObject()
          INTERNAL: Private constructor.
 
Method Summary
 java.lang.String _getContainmentPropertyName()
          INTERNAL: Return the name of the Property of the DataObject containing this data object or null if there is no container.
 ValueStore _getCurrentValueStore()
          INTERNAL: Map interface into the currentValueStore of this DataObject.
 java.util.List _getOpenContentProperties()
          INTERNAL: Returns a list of the Properties currently used in this DataObject which are not included in getType().getProperties
 java.util.List _getOpenContentPropertiesAttributes()
           
 java.util.Map _getOpenContentPropertiesAttributesMap()
           
 java.util.List _getOpenContentPropertiesWithXMLRoots()
          INTERNAL: This function is implemented by SDOType.setOpen() in a mapping setGet/SetMethodName call
 java.lang.String _getPath()
          INTERNAL: Return an SDO Path string from root of the caller to itself
 java.lang.String _getSdoRef()
          INTERNAL: Return the sdoref attribute value during unmarshaling
 void _setChangeSummary(commonj.sdo.ChangeSummary aChangeSummary)
          INTERNAL: Recursively Set this DataObject's ChangeSummary as passed in value.
 void _setContainer(commonj.sdo.DataObject aContainer)
          INTERNAL: Sets the DataObject which contains this DataObject.
 void _setContainmentPropertyName(java.lang.String aContainmentPropertyName)
          INTERNAL: Sets the name of the property on the containing DataObject which contains this DataObject as a value.
 void _setCreated(boolean created)
          INTERNAL: Set flag created value.
 void _setCurrentValueStore(ValueStore aValueStore)
          INTERNAL: Pluggable Interface for substituting the default Map with a custom Map Class
 void _setHelperContext(commonj.sdo.helper.HelperContext aContext)
          INTERNAL: Set the HelperContext that will be associated with this DataObject.
 void _setModified(boolean modified)
          INTERNAL: Set flag modified value.
 void _setOpenContentPropertiesAttributes(java.util.List openContentPropertiesAttributes)
           
 void _setOpenContentPropertiesAttributesMap(java.util.Map openAttributeProperties)
           
 void _setOpenContentPropertiesWithXMLRoots(java.util.List openContentPropertiesWithXMLRoots)
          INTERNAL: This function is implemented by SDOType.setOpen() in a mapping setGet/SetMethodName call
 void _setSdoRef(java.lang.String newRef)
           
 void _setType(commonj.sdo.Type aType)
          INTERNAL:
 void addOpenContentProperty(commonj.sdo.Property property)
          INTERNAL: Add the open content property into all 3 data structures.
 java.lang.Object convertObjectToValue(commonj.sdo.Property property, java.lang.Class cls)
          INTERNAL:
 java.lang.Object convertObjectToValue(commonj.sdo.Property property, int position, java.lang.Class cls)
          INTERNAL:
 commonj.sdo.DataObject createDataObject(int propertyIndex)
           
 commonj.sdo.DataObject createDataObject(int propertyIndex, java.lang.String namespaceURI, java.lang.String typeName)
           
 commonj.sdo.DataObject createDataObject(commonj.sdo.Property aProperty)
           
 commonj.sdo.DataObject createDataObject(commonj.sdo.Property property, commonj.sdo.Type aType)
           
 commonj.sdo.DataObject createDataObject(java.lang.String propertyName)
           
 commonj.sdo.DataObject createDataObject(java.lang.String propertyName, java.lang.String namespaceURI, java.lang.String typeName)
           
 commonj.sdo.Property defineOpenContentProperty(java.lang.String name, java.lang.Object value)
          INTERNAL: Create a dynamic open content property if no property exists for (name).
 commonj.sdo.Property defineOpenContentProperty(java.lang.String name, java.lang.Object value, commonj.sdo.Type sdotype)
           
 void delete()
           
 void detach()
           
 void detachOrDelete(boolean fromDelete)
          INTERNAL: Recursively walk the tree and set oldSettings for a detached/deleted object.
 java.lang.Object get(int propertyIndex)
           
 java.lang.Object get(commonj.sdo.Property property)
           
 java.lang.Object get(java.lang.String path)
           
 java.math.BigDecimal getBigDecimal(int propertyIndex)
           
 java.math.BigDecimal getBigDecimal(commonj.sdo.Property property)
           
 java.math.BigDecimal getBigDecimal(java.lang.String path)
           
 java.math.BigInteger getBigInteger(int propertyIndex)
           
 java.math.BigInteger getBigInteger(commonj.sdo.Property property)
           
 java.math.BigInteger getBigInteger(java.lang.String path)
           
 boolean getBoolean(int propertyIndex)
           
 boolean getBoolean(commonj.sdo.Property property)
           
 boolean getBoolean(java.lang.String path)
           
 byte getByte(int propertyIndex)
           
 byte getByte(commonj.sdo.Property property)
           
 byte getByte(java.lang.String path)
           
 byte[] getBytes(int propertyIndex)
           
 byte[] getBytes(commonj.sdo.Property property)
           
 byte[] getBytes(java.lang.String path)
           
 commonj.sdo.ChangeSummary getChangeSummary()
           
 char getChar(int propertyIndex)
           
 char getChar(commonj.sdo.Property property)
           
 char getChar(java.lang.String path)
           
 commonj.sdo.DataObject getContainer()
           
 SDOProperty getContainmentProperty()
           
 commonj.sdo.DataGraph getDataGraph()
           
 commonj.sdo.DataObject getDataObject(int propertyIndex)
           
 commonj.sdo.DataObject getDataObject(commonj.sdo.Property property)
           
 commonj.sdo.DataObject getDataObject(java.lang.String path)
           
 java.util.Date getDate(int propertyIndex)
           
 java.util.Date getDate(commonj.sdo.Property property)
           
 java.util.Date getDate(java.lang.String path)
           
 double getDouble(int propertyIndex)
           
 double getDouble(commonj.sdo.Property property)
           
 double getDouble(java.lang.String path)
           
 float getFloat(int propertyIndex)
           
 float getFloat(commonj.sdo.Property property)
           
 float getFloat(java.lang.String path)
           
 java.util.List getInstanceProperties()
           
 SDOProperty getInstanceProperty(int propertyIndex)
          INTERNAL:
 SDOProperty getInstanceProperty(java.lang.String propertyName)
           
 int getInt(int propertyIndex)
           
 int getInt(commonj.sdo.Property property)
           
 int getInt(java.lang.String path)
           
 java.util.List getList(int propertyIndex)
           
 java.util.List getList(commonj.sdo.Property property)
           
 java.util.List getList(java.lang.String path)
           
 long getLong(int propertyIndex)
           
 long getLong(commonj.sdo.Property property)
           
 long getLong(java.lang.String path)
           
 commonj.sdo.Property getProperty(java.lang.String propertyName)
           
 java.lang.Object getPropertyInternal(commonj.sdo.Property property)
          INTERNAL: Get the value of the property (open-content or declared)..
 commonj.sdo.DataObject getRootObject()
           
 commonj.sdo.Sequence getSequence()
           
 commonj.sdo.Sequence getSequence(int propertyIndex)
          Deprecated. in SDO 2.1.0.
 commonj.sdo.Sequence getSequence(commonj.sdo.Property property)
          Deprecated. in SDO 2.1.0.
 commonj.sdo.Sequence getSequence(java.lang.String path)
          Deprecated. in SDO 2.1.0.
 java.util.List<Setting> getSettings()
           
 short getShort(int propertyIndex)
           
 short getShort(commonj.sdo.Property property)
           
 short getShort(java.lang.String path)
           
 java.lang.String getString(int propertyIndex)
           
 java.lang.String getString(commonj.sdo.Property property)
           
 java.lang.String getString(java.lang.String path)
           
 SDOType getType()
           
 boolean isSet(int propertyIndex)
           
 boolean isSet(commonj.sdo.Property property)
           
 boolean isSet(java.lang.String path)
           
 boolean isSetInternal(commonj.sdo.Property property)
          INTERNAL: Return whether the property (open-content or declared) is set?
 boolean parentContains(java.lang.Object value)
          INTERNAL:
 void removeOpenContentProperty(commonj.sdo.Property property)
          INTERNAL: Remove the open content property (property) from all 3 data structures.
 void resetChanges()
          INTERNAL: Initialize all old settings related to ChangeSummary and recursively go down the tree to initialize all DataObjects rooted at this DataObject.
 void set(int propertyIndex, java.lang.Object value)
           
 void set(commonj.sdo.Property property, java.lang.Object value)
           
 void set(SDOProperty property, java.lang.Object value, boolean updateSequence)
          INTERNAL: Sets the value of the given property of the object to the new value.
 void set(java.lang.String path, java.lang.Object value)
           
 void setBigDecimal(int propertyIndex, java.math.BigDecimal value)
           
 void setBigDecimal(commonj.sdo.Property property, java.math.BigDecimal value)
           
 void setBigDecimal(java.lang.String path, java.math.BigDecimal value)
           
 void setBigInteger(int propertyIndex, java.math.BigInteger value)
           
 void setBigInteger(commonj.sdo.Property property, java.math.BigInteger value)
           
 void setBigInteger(java.lang.String path, java.math.BigInteger value)
           
 void setBoolean(int propertyIndex, boolean value)
           
 void setBoolean(commonj.sdo.Property property, boolean value)
           
 void setBoolean(java.lang.String path, boolean value)
           
 void setByte(int propertyIndex, byte value)
           
 void setByte(commonj.sdo.Property property, byte value)
           
 void setByte(java.lang.String path, byte value)
           
 void setBytes(int propertyIndex, byte[] value)
           
 void setBytes(commonj.sdo.Property property, byte[] value)
           
 void setBytes(java.lang.String path, byte[] value)
           
 void setChar(int propertyIndex, char value)
           
 void setChar(commonj.sdo.Property property, char value)
           
 void setChar(java.lang.String path, char value)
           
 void setDataGraph(commonj.sdo.DataGraph dataGraph)
           
 void setDataObject(int propertyIndex, commonj.sdo.DataObject value)
           
 void setDataObject(commonj.sdo.Property property, commonj.sdo.DataObject value)
           
 void setDataObject(java.lang.String path, commonj.sdo.DataObject value)
           
 void setDate(int propertyIndex, java.util.Date value)
           
 void setDate(commonj.sdo.Property property, java.util.Date value)
           
 void setDate(java.lang.String path, java.util.Date value)
           
 void setDouble(int propertyIndex, double value)
           
 void setDouble(commonj.sdo.Property property, double value)
           
 void setDouble(java.lang.String path, double value)
           
 void setFloat(int propertyIndex, float value)
           
 void setFloat(commonj.sdo.Property property, float value)
           
 void setFloat(java.lang.String path, float value)
           
 void setInt(int propertyIndex, int value)
           
 void setInt(commonj.sdo.Property property, int value)
           
 void setInt(java.lang.String path, int value)
           
 void setInternal(SDOProperty property, java.lang.Object value, boolean updateSequence)
           
 void setList(int propertyIndex, java.util.List value)
           
 void setList(commonj.sdo.Property property, java.util.List value)
           
 void setList(java.lang.String path, java.util.List value)
           
 void setLong(int propertyIndex, long value)
           
 void setLong(commonj.sdo.Property property, long value)
           
 void setLong(java.lang.String path, long value)
           
 void setPropertyInternal(SDOProperty property, java.lang.Object value, boolean updateSequence)
          INTERNAL: Update the ValueStore with the new property value and update any sequence if it exists.
 void setShort(int propertyIndex, short value)
           
 void setShort(commonj.sdo.Property property, short value)
           
 void setShort(java.lang.String path, short value)
           
 void setString(int propertyIndex, java.lang.String value)
           
 void setString(commonj.sdo.Property property, java.lang.String value)
           
 void setString(java.lang.String path, java.lang.String value)
           
 void undoChanges(boolean isCSRoot, commonj.sdo.ChangeSummary cs, SDODataObject origContainer, java.lang.String origContainmentPropName)
          INTERNAL: This function reverses any operations that were performed on this object since change tracking was turned on.
 void unset(int propertyIndex)
           
 void unset(commonj.sdo.Property property)
           
 void unset(commonj.sdo.Property property, boolean fromDelete, boolean updateSequence)
          INTERNAL: Unset the specified property on this DataObject.
 void unset(java.lang.String path)
           
 void updateContainment(commonj.sdo.Property property, java.util.Collection values)
          INTERNAL: Update containment on the specified collection of values and default to true = update the sequence
 void updateContainment(commonj.sdo.Property property, java.util.Collection values, boolean updateSequence)
          INTERNAL: Update containment with flagged update sequence state
 void updateContainment(commonj.sdo.Property property, commonj.sdo.DataObject value)
          INTERNAL: update containment and the update the sequence value by default.
 void updateContainment(commonj.sdo.Property property, commonj.sdo.DataObject value, boolean updateSequence)
          INTERNAL: Update containment on the dataObject with specified update sequence state
 java.lang.Object writeReplace()
          INTERNAL: Defined in SDO 2.01 spec on page 65 Externalizable function is called by ObjectStream.writeObject() A replacement object for serialization can be called here.
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Constructor Detail

SDODataObject

public SDODataObject()
INTERNAL: Private constructor. Use #SDODataObject(HelperContext) instead

Method Detail

_setHelperContext

public void _setHelperContext(commonj.sdo.helper.HelperContext aContext)
INTERNAL: Set the HelperContext that will be associated with this DataObject.

Parameters:
aContext -

get

public java.lang.Object get(java.lang.String path)
Specified by:
get in interface commonj.sdo.DataObject

set

public void set(java.lang.String path,
                java.lang.Object value)
         throws java.lang.ClassCastException,
                java.lang.UnsupportedOperationException,
                java.lang.IllegalArgumentException
Specified by:
set in interface commonj.sdo.DataObject
Throws:
java.lang.ClassCastException
java.lang.UnsupportedOperationException
java.lang.IllegalArgumentException

isSet

public boolean isSet(java.lang.String path)
Specified by:
isSet in interface commonj.sdo.DataObject

unset

public void unset(java.lang.String path)
Specified by:
unset in interface commonj.sdo.DataObject

getBoolean

public boolean getBoolean(java.lang.String path)
                   throws java.lang.ClassCastException
Specified by:
getBoolean in interface commonj.sdo.DataObject
Throws:
java.lang.ClassCastException

getByte

public byte getByte(java.lang.String path)
Specified by:
getByte in interface commonj.sdo.DataObject

getChar

public char getChar(java.lang.String path)
Specified by:
getChar in interface commonj.sdo.DataObject

getDouble

public double getDouble(java.lang.String path)
Specified by:
getDouble in interface commonj.sdo.DataObject

getFloat

public float getFloat(java.lang.String path)
Specified by:
getFloat in interface commonj.sdo.DataObject

getInt

public int getInt(java.lang.String path)
Specified by:
getInt in interface commonj.sdo.DataObject

getLong

public long getLong(java.lang.String path)
Specified by:
getLong in interface commonj.sdo.DataObject

getShort

public short getShort(java.lang.String path)
Specified by:
getShort in interface commonj.sdo.DataObject

getBytes

public byte[] getBytes(java.lang.String path)
Specified by:
getBytes in interface commonj.sdo.DataObject

getBigDecimal

public java.math.BigDecimal getBigDecimal(java.lang.String path)
Specified by:
getBigDecimal in interface commonj.sdo.DataObject

getBigInteger

public java.math.BigInteger getBigInteger(java.lang.String path)
Specified by:
getBigInteger in interface commonj.sdo.DataObject

getDataObject

public commonj.sdo.DataObject getDataObject(java.lang.String path)
                                     throws java.lang.ClassCastException
Specified by:
getDataObject in interface commonj.sdo.DataObject
Throws:
java.lang.ClassCastException

getDate

public java.util.Date getDate(java.lang.String path)
Specified by:
getDate in interface commonj.sdo.DataObject

getString

public java.lang.String getString(java.lang.String path)
Specified by:
getString in interface commonj.sdo.DataObject

getList

public java.util.List getList(java.lang.String path)
Specified by:
getList in interface commonj.sdo.DataObject

setBoolean

public void setBoolean(java.lang.String path,
                       boolean value)
Specified by:
setBoolean in interface commonj.sdo.DataObject

setByte

public void setByte(java.lang.String path,
                    byte value)
Specified by:
setByte in interface commonj.sdo.DataObject

setChar

public void setChar(java.lang.String path,
                    char value)
Specified by:
setChar in interface commonj.sdo.DataObject

setDouble

public void setDouble(java.lang.String path,
                      double value)
Specified by:
setDouble in interface commonj.sdo.DataObject

setFloat

public void setFloat(java.lang.String path,
                     float value)
Specified by:
setFloat in interface commonj.sdo.DataObject

setInt

public void setInt(java.lang.String path,
                   int value)
Specified by:
setInt in interface commonj.sdo.DataObject

setLong

public void setLong(java.lang.String path,
                    long value)
Specified by:
setLong in interface commonj.sdo.DataObject

setShort

public void setShort(java.lang.String path,
                     short value)
Specified by:
setShort in interface commonj.sdo.DataObject

setBytes

public void setBytes(java.lang.String path,
                     byte[] value)
Specified by:
setBytes in interface commonj.sdo.DataObject

setBigDecimal

public void setBigDecimal(java.lang.String path,
                          java.math.BigDecimal value)
Specified by:
setBigDecimal in interface commonj.sdo.DataObject

setBigInteger

public void setBigInteger(java.lang.String path,
                          java.math.BigInteger value)
Specified by:
setBigInteger in interface commonj.sdo.DataObject

setDataObject

public void setDataObject(java.lang.String path,
                          commonj.sdo.DataObject value)
Specified by:
setDataObject in interface commonj.sdo.DataObject

setDate

public void setDate(java.lang.String path,
                    java.util.Date value)
Specified by:
setDate in interface commonj.sdo.DataObject

setString

public void setString(java.lang.String path,
                      java.lang.String value)
Specified by:
setString in interface commonj.sdo.DataObject

setList

public void setList(java.lang.String path,
                    java.util.List value)
Specified by:
setList in interface commonj.sdo.DataObject

get

public java.lang.Object get(int propertyIndex)
                     throws java.lang.IllegalArgumentException
Specified by:
get in interface commonj.sdo.DataObject
Throws:
java.lang.IllegalArgumentException

set

public void set(int propertyIndex,
                java.lang.Object value)
Specified by:
set in interface commonj.sdo.DataObject

isSet

public boolean isSet(int propertyIndex)
Specified by:
isSet in interface commonj.sdo.DataObject

unset

public void unset(int propertyIndex)
Specified by:
unset in interface commonj.sdo.DataObject

getBoolean

public boolean getBoolean(int propertyIndex)
                   throws java.lang.IllegalArgumentException,
                          java.lang.ClassCastException
Specified by:
getBoolean in interface commonj.sdo.DataObject
Throws:
java.lang.IllegalArgumentException
java.lang.ClassCastException

getByte

public byte getByte(int propertyIndex)
             throws java.lang.IllegalArgumentException,
                    java.lang.ClassCastException
Specified by:
getByte in interface commonj.sdo.DataObject
Throws:
java.lang.IllegalArgumentException
java.lang.ClassCastException

getChar

public char getChar(int propertyIndex)
             throws java.lang.IllegalArgumentException,
                    java.lang.ClassCastException
Specified by:
getChar in interface commonj.sdo.DataObject
Throws:
java.lang.IllegalArgumentException
java.lang.ClassCastException

getDouble

public double getDouble(int propertyIndex)
                 throws java.lang.IllegalArgumentException,
                        java.lang.ClassCastException
Specified by:
getDouble in interface commonj.sdo.DataObject
Throws:
java.lang.IllegalArgumentException
java.lang.ClassCastException

getFloat

public float getFloat(int propertyIndex)
               throws java.lang.IllegalArgumentException,
                      java.lang.ClassCastException
Specified by:
getFloat in interface commonj.sdo.DataObject
Throws:
java.lang.IllegalArgumentException
java.lang.ClassCastException

getInt

public int getInt(int propertyIndex)
           throws java.lang.IllegalArgumentException,
                  java.lang.ClassCastException
Specified by:
getInt in interface commonj.sdo.DataObject
Throws:
java.lang.IllegalArgumentException
java.lang.ClassCastException

getLong

public long getLong(int propertyIndex)
             throws java.lang.IllegalArgumentException,
                    java.lang.ClassCastException
Specified by:
getLong in interface commonj.sdo.DataObject
Throws:
java.lang.IllegalArgumentException
java.lang.ClassCastException

getShort

public short getShort(int propertyIndex)
               throws java.lang.IllegalArgumentException,
                      java.lang.ClassCastException
Specified by:
getShort in interface commonj.sdo.DataObject
Throws:
java.lang.IllegalArgumentException
java.lang.ClassCastException

getBytes

public byte[] getBytes(int propertyIndex)
                throws java.lang.IllegalArgumentException,
                       java.lang.ClassCastException
Specified by:
getBytes in interface commonj.sdo.DataObject
Throws:
java.lang.IllegalArgumentException
java.lang.ClassCastException

getBigDecimal

public java.math.BigDecimal getBigDecimal(int propertyIndex)
                                   throws java.lang.IllegalArgumentException,
                                          java.lang.ClassCastException
Specified by:
getBigDecimal in interface commonj.sdo.DataObject
Throws:
java.lang.IllegalArgumentException
java.lang.ClassCastException

getBigInteger

public java.math.BigInteger getBigInteger(int propertyIndex)
                                   throws java.lang.IllegalArgumentException,
                                          java.lang.ClassCastException
Specified by:
getBigInteger in interface commonj.sdo.DataObject
Throws:
java.lang.IllegalArgumentException
java.lang.ClassCastException

getDataObject

public commonj.sdo.DataObject getDataObject(int propertyIndex)
Specified by:
getDataObject in interface commonj.sdo.DataObject

getDate

public java.util.Date getDate(int propertyIndex)
                       throws java.lang.IllegalArgumentException,
                              java.lang.ClassCastException
Specified by:
getDate in interface commonj.sdo.DataObject
Throws:
java.lang.IllegalArgumentException
java.lang.ClassCastException

getString

public java.lang.String getString(int propertyIndex)
                           throws java.lang.IllegalArgumentException,
                                  java.lang.ClassCastException
Specified by:
getString in interface commonj.sdo.DataObject
Throws:
java.lang.IllegalArgumentException
java.lang.ClassCastException

getList

public java.util.List getList(int propertyIndex)
Specified by:
getList in interface commonj.sdo.DataObject

getSequence

public commonj.sdo.Sequence getSequence(java.lang.String path)
Deprecated. in SDO 2.1.0.

Specified by:
getSequence in interface commonj.sdo.DataObject

getSequence

public commonj.sdo.Sequence getSequence(int propertyIndex)
Deprecated. in SDO 2.1.0.

Specified by:
getSequence in interface commonj.sdo.DataObject

getSequence

public commonj.sdo.Sequence getSequence(commonj.sdo.Property property)
Deprecated. in SDO 2.1.0.

Specified by:
getSequence in interface commonj.sdo.DataObject

getSequence

public commonj.sdo.Sequence getSequence()
Specified by:
getSequence in interface commonj.sdo.DataObject

setBoolean

public void setBoolean(int propertyIndex,
                       boolean value)
Specified by:
setBoolean in interface commonj.sdo.DataObject

setByte

public void setByte(int propertyIndex,
                    byte value)
Specified by:
setByte in interface commonj.sdo.DataObject

setChar

public void setChar(int propertyIndex,
                    char value)
Specified by:
setChar in interface commonj.sdo.DataObject

setDouble

public void setDouble(int propertyIndex,
                      double value)
Specified by:
setDouble in interface commonj.sdo.DataObject

setFloat

public void setFloat(int propertyIndex,
                     float value)
Specified by:
setFloat in interface commonj.sdo.DataObject

setInt

public void setInt(int propertyIndex,
                   int value)
Specified by:
setInt in interface commonj.sdo.DataObject

setLong

public void setLong(int propertyIndex,
                    long value)
Specified by:
setLong in interface commonj.sdo.DataObject

setShort

public void setShort(int propertyIndex,
                     short value)
Specified by:
setShort in interface commonj.sdo.DataObject

setBytes

public void setBytes(int propertyIndex,
                     byte[] value)
Specified by:
setBytes in interface commonj.sdo.DataObject

setBigDecimal

public void setBigDecimal(int propertyIndex,
                          java.math.BigDecimal value)
Specified by:
setBigDecimal in interface commonj.sdo.DataObject

setBigInteger

public void setBigInteger(int propertyIndex,
                          java.math.BigInteger value)
Specified by:
setBigInteger in interface commonj.sdo.DataObject

setDataObject

public void setDataObject(int propertyIndex,
                          commonj.sdo.DataObject value)
Specified by:
setDataObject in interface commonj.sdo.DataObject

setDate

public void setDate(int propertyIndex,
                    java.util.Date value)
Specified by:
setDate in interface commonj.sdo.DataObject

setString

public void setString(int propertyIndex,
                      java.lang.String value)
Specified by:
setString in interface commonj.sdo.DataObject

setList

public void setList(int propertyIndex,
                    java.util.List value)
Specified by:
setList in interface commonj.sdo.DataObject

get

public java.lang.Object get(commonj.sdo.Property property)
                     throws java.lang.IllegalArgumentException
Specified by:
get in interface commonj.sdo.DataObject
Throws:
java.lang.IllegalArgumentException

defineOpenContentProperty

public commonj.sdo.Property defineOpenContentProperty(java.lang.String name,
                                                      java.lang.Object value)
                                               throws java.lang.UnsupportedOperationException,
                                                      java.lang.IllegalArgumentException
INTERNAL: Create a dynamic open content property if no property exists for (name).

Parameters:
name -
value -
Returns:
Property
Throws:
java.lang.UnsupportedOperationException
java.lang.IllegalArgumentException

defineOpenContentProperty

public commonj.sdo.Property defineOpenContentProperty(java.lang.String name,
                                                      java.lang.Object value,
                                                      commonj.sdo.Type sdotype)
                                               throws java.lang.UnsupportedOperationException,
                                                      java.lang.IllegalArgumentException
Throws:
java.lang.UnsupportedOperationException
java.lang.IllegalArgumentException

set

public void set(commonj.sdo.Property property,
                java.lang.Object value)
         throws java.lang.UnsupportedOperationException,
                java.lang.IllegalArgumentException
Specified by:
set in interface commonj.sdo.DataObject
Throws:
java.lang.UnsupportedOperationException
java.lang.IllegalArgumentException

setInternal

public void setInternal(SDOProperty property,
                        java.lang.Object value,
                        boolean updateSequence)
                 throws java.lang.UnsupportedOperationException,
                        java.lang.IllegalArgumentException
Throws:
java.lang.UnsupportedOperationException
java.lang.IllegalArgumentException

set

public void set(SDOProperty property,
                java.lang.Object value,
                boolean updateSequence)
         throws java.lang.UnsupportedOperationException,
                java.lang.IllegalArgumentException
INTERNAL: Sets the value of the given property of the object to the new value.

The use of a false updateSequence flag is internally implemented during an SDOSequence.add() call. Refactor: we need to abstract this function using a type of Command pattern to handle the sequence context.

Parameters:
property -
value -
updateSequence -
Throws:
java.lang.UnsupportedOperationException
java.lang.IllegalArgumentException

isSet

public boolean isSet(commonj.sdo.Property property)
Specified by:
isSet in interface commonj.sdo.DataObject

unset

public void unset(commonj.sdo.Property property)
Specified by:
unset in interface commonj.sdo.DataObject

unset

public void unset(commonj.sdo.Property property,
                  boolean fromDelete,
                  boolean updateSequence)
INTERNAL: Unset the specified property on this DataObject. The fromDelete parameter specifies whether we are from a delete or unset/detach operation. The updateSequence parameter is used internally to stop a bidirectional update in the SDOSequence when originally called from this Sequence.

Parameters:
property -
fromDelete -
updateSequence -

getBoolean

public boolean getBoolean(commonj.sdo.Property property)
                   throws java.lang.IllegalArgumentException,
                          java.lang.ClassCastException
Specified by:
getBoolean in interface commonj.sdo.DataObject
Throws:
java.lang.IllegalArgumentException
java.lang.ClassCastException

getByte

public byte getByte(commonj.sdo.Property property)
             throws java.lang.IllegalArgumentException,
                    java.lang.ClassCastException
Specified by:
getByte in interface commonj.sdo.DataObject
Throws:
java.lang.IllegalArgumentException
java.lang.ClassCastException

getChar

public char getChar(commonj.sdo.Property property)
             throws java.lang.IllegalArgumentException
Specified by:
getChar in interface commonj.sdo.DataObject
Throws:
java.lang.IllegalArgumentException

getDouble

public double getDouble(commonj.sdo.Property property)
                 throws java.lang.IllegalArgumentException
Specified by:
getDouble in interface commonj.sdo.DataObject
Throws:
java.lang.IllegalArgumentException

getFloat

public float getFloat(commonj.sdo.Property property)
               throws java.lang.IllegalArgumentException
Specified by:
getFloat in interface commonj.sdo.DataObject
Throws:
java.lang.IllegalArgumentException

getInt

public int getInt(commonj.sdo.Property property)
           throws java.lang.IllegalArgumentException
Specified by:
getInt in interface commonj.sdo.DataObject
Throws:
java.lang.IllegalArgumentException

getLong

public long getLong(commonj.sdo.Property property)
             throws java.lang.IllegalArgumentException
Specified by:
getLong in interface commonj.sdo.DataObject
Throws:
java.lang.IllegalArgumentException

getShort

public short getShort(commonj.sdo.Property property)
               throws java.lang.IllegalArgumentException
Specified by:
getShort in interface commonj.sdo.DataObject
Throws:
java.lang.IllegalArgumentException

getBytes

public byte[] getBytes(commonj.sdo.Property property)
                throws java.lang.IllegalArgumentException
Specified by:
getBytes in interface commonj.sdo.DataObject
Throws:
java.lang.IllegalArgumentException

getBigDecimal

public java.math.BigDecimal getBigDecimal(commonj.sdo.Property property)
                                   throws java.lang.IllegalArgumentException
Specified by:
getBigDecimal in interface commonj.sdo.DataObject
Throws:
java.lang.IllegalArgumentException

getBigInteger

public java.math.BigInteger getBigInteger(commonj.sdo.Property property)
                                   throws java.lang.IllegalArgumentException
Specified by:
getBigInteger in interface commonj.sdo.DataObject
Throws:
java.lang.IllegalArgumentException

getDataObject

public commonj.sdo.DataObject getDataObject(commonj.sdo.Property property)
                                     throws java.lang.IllegalArgumentException,
                                            java.lang.ClassCastException
Specified by:
getDataObject in interface commonj.sdo.DataObject
Throws:
java.lang.IllegalArgumentException
java.lang.ClassCastException

getDate

public java.util.Date getDate(commonj.sdo.Property property)
Specified by:
getDate in interface commonj.sdo.DataObject

getString

public java.lang.String getString(commonj.sdo.Property property)
Specified by:
getString in interface commonj.sdo.DataObject

getList

public java.util.List getList(commonj.sdo.Property property)
Specified by:
getList in interface commonj.sdo.DataObject

setBoolean

public void setBoolean(commonj.sdo.Property property,
                       boolean value)
Specified by:
setBoolean in interface commonj.sdo.DataObject

setByte

public void setByte(commonj.sdo.Property property,
                    byte value)
Specified by:
setByte in interface commonj.sdo.DataObject

setChar

public void setChar(commonj.sdo.Property property,
                    char value)
Specified by:
setChar in interface commonj.sdo.DataObject

setDouble

public void setDouble(commonj.sdo.Property property,
                      double value)
Specified by:
setDouble in interface commonj.sdo.DataObject

setFloat

public void setFloat(commonj.sdo.Property property,
                     float value)
Specified by:
setFloat in interface commonj.sdo.DataObject

setInt

public void setInt(commonj.sdo.Property property,
                   int value)
Specified by:
setInt in interface commonj.sdo.DataObject

setLong

public void setLong(commonj.sdo.Property property,
                    long value)
Specified by:
setLong in interface commonj.sdo.DataObject

setShort

public void setShort(commonj.sdo.Property property,
                     short value)
Specified by:
setShort in interface commonj.sdo.DataObject

setBytes

public void setBytes(commonj.sdo.Property property,
                     byte[] value)
Specified by:
setBytes in interface commonj.sdo.DataObject

setBigDecimal

public void setBigDecimal(commonj.sdo.Property property,
                          java.math.BigDecimal value)
Specified by:
setBigDecimal in interface commonj.sdo.DataObject

setBigInteger

public void setBigInteger(commonj.sdo.Property property,
                          java.math.BigInteger value)
Specified by:
setBigInteger in interface commonj.sdo.DataObject

setDataObject

public void setDataObject(commonj.sdo.Property property,
                          commonj.sdo.DataObject value)
Specified by:
setDataObject in interface commonj.sdo.DataObject

setDate

public void setDate(commonj.sdo.Property property,
                    java.util.Date value)
Specified by:
setDate in interface commonj.sdo.DataObject

setString

public void setString(commonj.sdo.Property property,
                      java.lang.String value)
Specified by:
setString in interface commonj.sdo.DataObject

setList

public void setList(commonj.sdo.Property property,
                    java.util.List value)
Specified by:
setList in interface commonj.sdo.DataObject

createDataObject

public commonj.sdo.DataObject createDataObject(java.lang.String propertyName)
Specified by:
createDataObject in interface commonj.sdo.DataObject

createDataObject

public commonj.sdo.DataObject createDataObject(int propertyIndex)
Specified by:
createDataObject in interface commonj.sdo.DataObject

createDataObject

public commonj.sdo.DataObject createDataObject(commonj.sdo.Property aProperty)
Specified by:
createDataObject in interface commonj.sdo.DataObject

createDataObject

public commonj.sdo.DataObject createDataObject(java.lang.String propertyName,
                                               java.lang.String namespaceURI,
                                               java.lang.String typeName)
Specified by:
createDataObject in interface commonj.sdo.DataObject

createDataObject

public commonj.sdo.DataObject createDataObject(int propertyIndex,
                                               java.lang.String namespaceURI,
                                               java.lang.String typeName)
Specified by:
createDataObject in interface commonj.sdo.DataObject

createDataObject

public commonj.sdo.DataObject createDataObject(commonj.sdo.Property property,
                                               commonj.sdo.Type aType)
Specified by:
createDataObject in interface commonj.sdo.DataObject

detachOrDelete

public void detachOrDelete(boolean fromDelete)
INTERNAL: Recursively walk the tree and set oldSettings for a detached/deleted object. This function performs a single preOrder traversal of the tree. An unset is done for each property if the action = delete Implementors: detach() and delete() via detach

Parameters:
fromDelete - (flag the action true = delete, false = detach)

detach

public void detach()
Specified by:
detach in interface commonj.sdo.DataObject

delete

public void delete()
Specified by:
delete in interface commonj.sdo.DataObject

getContainer

public commonj.sdo.DataObject getContainer()
Specified by:
getContainer in interface commonj.sdo.DataObject

getContainmentProperty

public SDOProperty getContainmentProperty()
Specified by:
getContainmentProperty in interface commonj.sdo.DataObject

getDataGraph

public commonj.sdo.DataGraph getDataGraph()
Specified by:
getDataGraph in interface commonj.sdo.DataObject

setDataGraph

public void setDataGraph(commonj.sdo.DataGraph dataGraph)

getType

public SDOType getType()
Specified by:
getType in interface commonj.sdo.DataObject

getInstanceProperties

public java.util.List getInstanceProperties()
Specified by:
getInstanceProperties in interface commonj.sdo.DataObject

getProperty

public commonj.sdo.Property getProperty(java.lang.String propertyName)
Specified by:
getProperty in interface commonj.sdo.DataObject

getInstanceProperty

public SDOProperty getInstanceProperty(java.lang.String propertyName)
Specified by:
getInstanceProperty in interface commonj.sdo.DataObject

getInstanceProperty

public SDOProperty getInstanceProperty(int propertyIndex)
                                throws java.lang.IllegalArgumentException
INTERNAL:

Parameters:
propertyIndex -
Returns:
Throws:
SDOException
java.lang.IllegalArgumentException

getRootObject

public commonj.sdo.DataObject getRootObject()
Specified by:
getRootObject in interface commonj.sdo.DataObject

getChangeSummary

public commonj.sdo.ChangeSummary getChangeSummary()
Specified by:
getChangeSummary in interface commonj.sdo.DataObject

_setCreated

public void _setCreated(boolean created)
INTERNAL: Set flag created value.

Parameters:
created - flag created's new value.

_setModified

public void _setModified(boolean modified)
INTERNAL: Set flag modified value.

Parameters:
modified - flag modified's new value.

_setChangeSummary

public void _setChangeSummary(commonj.sdo.ChangeSummary aChangeSummary)
INTERNAL: Recursively Set this DataObject's ChangeSummary as passed in value.

Parameters:
aChangeSummary - the ChangeSummary taking this DataObject as root.

undoChanges

public void undoChanges(boolean isCSRoot,
                        commonj.sdo.ChangeSummary cs,
                        SDODataObject origContainer,
                        java.lang.String origContainmentPropName)
INTERNAL: This function reverses any operations that were performed on this object since change tracking was turned on. The object is returned to the state when logging was first started.

Parameters:
isCSRoot -
cs -
origContainer -
origContainmentPropName -

resetChanges

public void resetChanges()
INTERNAL: Initialize all old settings related to ChangeSummary and recursively go down the tree to initialize all DataObjects rooted at this DataObject. TODO: FIX


_setType

public void _setType(commonj.sdo.Type aType)
INTERNAL:

Parameters:
aType -

_setCurrentValueStore

public void _setCurrentValueStore(ValueStore aValueStore)
INTERNAL: Pluggable Interface for substituting the default Map with a custom Map Class

Parameters:
currentValueStore - void

_getCurrentValueStore

public ValueStore _getCurrentValueStore()
INTERNAL: Map interface into the currentValueStore of this DataObject.
Note: Implementers of the ValueStore interface require this accessor.

Returns:

_setContainer

public void _setContainer(commonj.sdo.DataObject aContainer)
INTERNAL: Sets the DataObject which contains this DataObject.

Parameters:
aContainer - the DataObject which is the container of this DataObject.

_getOpenContentPropertiesAttributesMap

public java.util.Map _getOpenContentPropertiesAttributesMap()

_setOpenContentPropertiesAttributesMap

public void _setOpenContentPropertiesAttributesMap(java.util.Map openAttributeProperties)

_setOpenContentPropertiesWithXMLRoots

public void _setOpenContentPropertiesWithXMLRoots(java.util.List openContentPropertiesWithXMLRoots)
INTERNAL: This function is implemented by SDOType.setOpen() in a mapping setGet/SetMethodName call

Parameters:
openContentPropertiesWithXMLRoots -

_getOpenContentPropertiesWithXMLRoots

public java.util.List _getOpenContentPropertiesWithXMLRoots()
INTERNAL: This function is implemented by SDOType.setOpen() in a mapping setGet/SetMethodName call

Returns:

_getOpenContentProperties

public java.util.List _getOpenContentProperties()
INTERNAL: Returns a list of the Properties currently used in this DataObject which are not included in getType().getProperties

Returns:
the List of open content Properties currently used in this DataObject.

convertObjectToValue

public java.lang.Object convertObjectToValue(commonj.sdo.Property property,
                                             java.lang.Class cls)
                                      throws java.lang.ClassCastException,
                                             java.lang.IllegalArgumentException
INTERNAL:

Parameters:
property -
cls -
Returns:
Throws:
java.lang.ClassCastException
java.lang.IllegalArgumentException

convertObjectToValue

public java.lang.Object convertObjectToValue(commonj.sdo.Property property,
                                             int position,
                                             java.lang.Class cls)
                                      throws java.lang.ClassCastException,
                                             java.lang.IllegalArgumentException
INTERNAL:

Parameters:
property -
position -
cls -
Returns:
Throws:
java.lang.ClassCastException
java.lang.IllegalArgumentException

_setContainmentPropertyName

public void _setContainmentPropertyName(java.lang.String aContainmentPropertyName)
INTERNAL: Sets the name of the property on the containing DataObject which contains this DataObject as a value.

Parameters:
aContainmentPropertyName - the name of the property on the containing DataObject which has this DataObject as a value.

_getContainmentPropertyName

public java.lang.String _getContainmentPropertyName()
INTERNAL: Return the name of the Property of the DataObject containing this data object or null if there is no container.

Returns:
the property containing this data object.

parentContains

public boolean parentContains(java.lang.Object value)
INTERNAL:

Parameters:
value -
Returns:

updateContainment

public void updateContainment(commonj.sdo.Property property,
                              java.util.Collection values,
                              boolean updateSequence)
INTERNAL: Update containment with flagged update sequence state

Parameters:
property -
values -
updateSequence -

updateContainment

public void updateContainment(commonj.sdo.Property property,
                              java.util.Collection values)
INTERNAL: Update containment on the specified collection of values and default to true = update the sequence

Parameters:
property -
values -

updateContainment

public void updateContainment(commonj.sdo.Property property,
                              commonj.sdo.DataObject value,
                              boolean updateSequence)
INTERNAL: Update containment on the dataObject with specified update sequence state

Parameters:
property -
value -

updateContainment

public void updateContainment(commonj.sdo.Property property,
                              commonj.sdo.DataObject value)
INTERNAL: update containment and the update the sequence value by default.

Parameters:
property -
value -

writeReplace

public java.lang.Object writeReplace()
INTERNAL: Defined in SDO 2.01 spec on page 65 Externalizable function is called by ObjectStream.writeObject() A replacement object for serialization can be called here.

Security Note: This public function exposes a data replacement vulnerability where an outside client can gain access and modify their non-final constants. We may need to wrap the GZIP streams in some sort of encryption when we are not using HTTPS or SSL/TLS on the wire.

See Also:
SDOResolvable

_getPath

public java.lang.String _getPath()
INTERNAL: Return an SDO Path string from root of the caller to itself

Returns:
String

getPropertyInternal

public java.lang.Object getPropertyInternal(commonj.sdo.Property property)
INTERNAL: Get the value of the property (open-content or declared)..

Parameters:
property -
Returns:

setPropertyInternal

public void setPropertyInternal(SDOProperty property,
                                java.lang.Object value,
                                boolean updateSequence)
INTERNAL: Update the ValueStore with the new property value and update any sequence if it exists.

Parameters:
property -
value -
updateSequence - (truncate call back from sequence when this function was called from sequence)

addOpenContentProperty

public void addOpenContentProperty(commonj.sdo.Property property)
INTERNAL: Add the open content property into all 3 data structures. Remove the property from the unset map.

Parameters:
property -

removeOpenContentProperty

public void removeOpenContentProperty(commonj.sdo.Property property)
INTERNAL: Remove the open content property (property) from all 3 data structures. Add the property to the unset map. We restore this OC property in undoChanges

Parameters:
property -

isSetInternal

public boolean isSetInternal(commonj.sdo.Property property)
INTERNAL: Return whether the property (open-content or declared) is set?

Parameters:
property -
Returns:
true if set, false otherwise

_getSdoRef

public java.lang.String _getSdoRef()
INTERNAL: Return the sdoref attribute value during unmarshaling

Returns:

_setOpenContentPropertiesAttributes

public void _setOpenContentPropertiesAttributes(java.util.List openContentPropertiesAttributes)

_getOpenContentPropertiesAttributes

public java.util.List _getOpenContentPropertiesAttributes()

getSettings

public java.util.List<Setting> getSettings()
Specified by:
getSettings in interface SequencedObject

_setSdoRef

public void _setSdoRef(java.lang.String newRef)

EclipseLink1.0 - 20080707 API Reference