Oracle Fusion Middleware Java API Reference for Oracle ADF Model
11g Release 1 (11.1.1.4.0)

E10653-05

oracle.adf.model.bean
Class DCDataRow

java.lang.Object
  extended by oracle.jbo.server.RowImpl
      extended by oracle.jbo.server.ViewRowImpl
          extended by oracle.adf.model.bean.DCDataRow
All Implemented Interfaces:
AttributeList, XmlSerializable, JIReservedVarNames, ExprValueSupplier, JboReservedVarNames, Row, VariableManagerOwnerBase, XMLInterface

public class DCDataRow
extends ViewRowImpl


Field Summary
 
Fields inherited from class oracle.jbo.server.ViewRowImpl
CURRENT_VERSION, ORIGINAL_VERSION, XML_POSTSTATE_REMOVE, XML_POSTSTATE_TAG
 
Fields inherited from interface oracle.jbo.JboReservedVarNames
RESERVED_VAR_AGG_AVG, RESERVED_VAR_AGG_COUNT, RESERVED_VAR_AGG_MAX, RESERVED_VAR_AGG_MIN, RESERVED_VAR_AGG_SUM, RESERVED_VAR_AGGVAL_PREFIX, RESERVED_VAR_STRUCTURE_DEF
 
Fields inherited from interface oracle.jbo.expr.JIReservedVarNames
RESERVED_VAR_VALUE
 
Fields inherited from interface oracle.jbo.Row
EFFDT_DELETE_FUTURE_CHANGE_MODE, EFFDT_DELETE_MODE, EFFDT_DELETE_NEXT_CHANGE_MODE, EFFDT_DELETE_THIS_CHANGE_MODE, EFFDT_DELETE_ZAP_MODE, EFFDT_EXPERT_MODE, EFFDT_NONE_MODE, EFFDT_UPDATE_CHANGE_INSERT_MODE, EFFDT_UPDATE_CORRECTION, EFFDT_UPDATE_MODE, EFFDT_UPDATE_NEW_EARLIEST_CHANGE_MODE, EFFDT_UPDATE_OVERRIDE_MODE, REFRESH_CONTAINEES, REFRESH_FORGET_NEW_ROWS, REFRESH_REMOVE_NEW_ROWS, REFRESH_UNDO_CHANGES, REFRESH_WITH_DB_FORGET_CHANGES, REFRESH_WITH_DB_ONLY_IF_UNCHANGED, STATUS_INITIALIZED
 
Fields inherited from interface oracle.jbo.XMLInterface
XML_IGNORE_DEPTH_COUNT, XML_OPT_ALL_ROWS, XML_OPT_ASSOC_CONSISTENT, XML_OPT_CHANGES_ONLY, XML_OPT_LIMIT_RANGE, XML_PASSIVATION_USE
 
Constructor Summary
DCDataRow()
           
 
Method Summary
protected  void addListBindingsForAttribute(java.util.List lbs, java.util.List attrNames, java.lang.String attrName, java.util.ArrayList derivedNames, java.util.ArrayList al)
          Internal: Applications should not use this method.
protected  void copyFrom(ViewRowImpl other)
          For subclasses to implement copy of transient members in the subclass This method is invoked when a new row is created with attributes copied from the other row for move into a new collection in makeRowCopy.
protected  void create(AttributeList nvp)
          Initialization method to be over-ridden in generated code for custom defaulting.
protected  RowSet createViewAccessorRS(ViewAccessorDef va)
          Internal: Applications should not use this method.
protected  ViewRowAttrHintsImpl createViewRowAttrHints(AttributeDefImpl attrDef)
          Create a map to store attribute hints for this row.
 void dump()
           
 boolean equals(java.lang.Object other)
          Tests if the specified value is equal to this ViewRowImpl object.
protected  java.lang.String findListBindingName(java.lang.String attrName, java.lang.String lbName)
          Internal: Applications should not use this method.
protected  RowSetIterator findListBindingRSI(java.lang.String attrName, java.lang.String lbName, java.lang.String prefCrName)
          Internal: Applications should not use this method.
 ViewAccessorDef findViewAccessorDef(java.lang.String name)
          This method returns ViewAccessorDef with the specified name.
protected  ApplicationModule getApplicationModuleForViewAccessor()
          Internal: Applications should not use this method.
protected  java.lang.Object getAttributeInternal(int index)
          Gets the value of the attribute by index.
 java.lang.Object getDataProvider()
           
 java.lang.Object getExprVarVal(java.lang.String varName)
           
 Key getKey()
          Returns the identifier object for this row.
protected  RowSetIterator getListBindingRSI(ListBindingDef def)
          Internal: Applications should not use this method.
protected  int getViewAccessorResultIndex(ViewAccessorDef va)
          Return the index at which the view accessor rowset needs to be stored.
protected  boolean isRefreshRequired(ViewAccessorDef va, java.lang.String[] attrNames, java.lang.Object[] attrValues, RowSet rs)
           
 void lock()
          Locks the referenced Entity Rows.
 AttributeDef lookupAttributeDef(java.lang.String attrName)
          final void setViewDef(ViewDefImpl vDef) { try { useInner(); mInner.setViewDef(vDef); } finally { releaseInner(); } }
protected  void populateAttribute(int index, java.lang.Object val)
          Populates the attribute at the given index with the given attribute value.
 void remove()
          Deletes the row.
 void removeAndRetain()
          Removes the row from the collection and then retain it for insertion into another location.
 void removeFromCollection()
          Removes the row from the collection.
 void setAttribute(int index, java.lang.Object val)
          Sets an attribute.
protected  void setAttributeInternal(int index, java.lang.Object val)
          This is an "inner" accessor for an attribute and does not call out to the getXXX() method.
 void setExprVarVal(java.lang.String varName, java.lang.Object val)
           
 void setNewRowState(byte state)
          void setIterator(ViewRowSetIteratorImpl rsi) { mRSI = rsi; } public ViewRowSetIteratorImpl getIterator() { return mRSI; }
 void setTransientAttributeValue(ViewAttributeDefImpl vad, java.lang.Object val)
          Deprecated.  
protected  boolean shouldAddViewAccessorRSToRow()
          Internal: Applications should not use this method.
 
Methods inherited from class oracle.jbo.server.ViewRowImpl
_internal_dbg_debug_data, appendXMLElementNodes, appendXMLElementNodes, checkForOuterJoins, clearAttributeException, clearAttributeException, createEntities, createListBinding, createMissingEntitiesFromViewDef, createViewAccessorRS, doAllowsOperation, doAutoClearAttribute, entityCacheAdd, findAssociatedObjects, findAttributeDef, findOrCreateLocalViewObject, findOrCreateViewAccessorRS, findOrCreateViewAccessorRS, findRowSetForRow, getApplicationModule, getAttribute, getAttribute, getAttributeCount, getAttributeHints, getAttributeHints, getAttributeIndexOf, getAttributeInternal, getAttributeNames, getAttributeValues, getAttrInvokeAccessor, getCtrlHints, getDBTransaction, getEffectiveDate, getElementTagName, getEntities, getEntity, getEntityAttrForAttribute, getEntityCount, getEntityForAttribute, getEntityForListBinding, getHandle, getListBindingCount, getListBindings, getLookupDescription, getNewRowState, getParentVariableManager, getPreferredListBindingRSI, getQueryCollection, getRowSet, getRowStorageInternal, getStructureDef, getViewDef, getViewLogicGroupDef, getViewObject, getXMLElementTag, handleListBindingMismatch, hasAttributeException, hasDeferredExceptions, hasExtendedViewDef, hashCode, hasListBindings, initDefaults, isAttributeChanged, isAttributeUpdateable, isDead, isSubclassRow, isViewAccessorAttribute, markViewAccessorsDirty, populate, populateAttributeAsChanged, readAttributeFromXMLElement, readXML, refresh, refreshViewAccessor, registerAttributeException, renderAttributeInXMLElement, renderAttributeInXMLElement, revert, setAttribute, setAttributeValues, setAttrInvokeAccessor, setEffectiveDateMode, setEffectiveDateOnEntities, setEntities, setEntity, setStateOnEntity, throwOnListBindingMismatch, toString, validate, writeAsXml, writeAsXml, writeXML
 
Methods inherited from class oracle.jbo.server.RowImpl
clearAllExceptions, clearRowExceptions, createXMLDefinition, ensureVariableManager, findAttrAndGetIndex, forceFilterListExecute, getAllExceptions, getAttributeInternal, getAttributeSecurityHints, getAttributeSecurityHints, getCombinedAttrNames, getEffectiveDateMode, getExprMethodVal, getHints, getMessageBundleClass, getMethodKind, getResourceBundleDef, getRowExceptions, getSecurityHints, getVariableManager, hasAttributeException, hasVariables, isRefreshRequired, isRefreshRequired, lookupListBinding, printXMLDefinition, readXML, refreshViewAccessor, refreshViewAccessor, registerRowException, setAttributeInternal, setInMultiSetter, skipFilterListOnKeyAttributes, variablesAdded, writeXML, writeXML, writeXML
 
Methods inherited from class java.lang.Object
clone, finalize, getClass, notify, notifyAll, wait, wait, wait
 

Constructor Detail

DCDataRow

public DCDataRow()
Method Detail

getDataProvider

public java.lang.Object getDataProvider()

dump

public void dump()
For internal use only. Application developers should not use this
*** For internal framework use only ***

populateAttribute

protected void populateAttribute(int index,
                                 java.lang.Object val)
Description copied from class: RowImpl
Populates the attribute at the given index with the given attribute value.

Overrides:
populateAttribute in class ViewRowImpl
Parameters:
index - an attribute position.
val - the value to be assigned to the attribute.

getKey

public Key getKey()
Description copied from class: ViewRowImpl
Returns the identifier object for this row.

Specified by:
getKey in interface Row
Overrides:
getKey in class ViewRowImpl
Returns:
the key of the row.

setAttribute

public void setAttribute(int index,
                         java.lang.Object val)
Description copied from class: ViewRowImpl
Sets an attribute.

This method performs a type-check on the value, so that it matches the Java type of the attribute.

Specified by:
setAttribute in interface AttributeList
Overrides:
setAttribute in class ViewRowImpl
Parameters:
index - the index of the attribute.
val - the new value.

findListBindingName

protected java.lang.String findListBindingName(java.lang.String attrName,
                                               java.lang.String lbName)
Description copied from class: RowImpl
Internal: Applications should not use this method.

Overrides:
findListBindingName in class ViewRowImpl

setAttributeInternal

protected void setAttributeInternal(int index,
                                    java.lang.Object val)
Description copied from class: ViewRowImpl
This is an "inner" accessor for an attribute and does not call out to the getXXX() method. This method sets the value to the mapping entity attribute or stores the value in ViewRow cache for the given attribute.

This method also does not perform any type-check for the value's java type and assumes that the value-type is same as the java-type for this attribute.

Overrides:
setAttributeInternal in class ViewRowImpl
Parameters:
index - The index of the attribute.
val - The value.

setTransientAttributeValue

public void setTransientAttributeValue(ViewAttributeDefImpl vad,
                                       java.lang.Object val)
Deprecated. 

Overrides:
setTransientAttributeValue in class ViewRowImpl
For internal use only. Application developers should not use this
*** For internal framework use only ***

remove

public void remove()
Description copied from class: ViewRowImpl
Deletes the row. This method will invoke remove on the updateable Entity Rows that are referenced by this View Object Row. After the referenced, updateable entity rows have been removed this method will remove the View Object Row from the View Object's RowSet.

Specified by:
remove in interface Row
Overrides:
remove in class ViewRowImpl

create

protected void create(AttributeList nvp)
Description copied from class: ViewRowImpl
Initialization method to be over-ridden in generated code for custom defaulting.

This method invokes create(AttributeList) on each of the "new" entities that make up this View Row.

The attribute list nvp is simply passed to the new entity rows that make up this View Row.

Note: the names in the attribute list are not transformed into entity-relative names hoping that the caller has done so already. If not, the entity's create() method might fail.

Overrides:
create in class ViewRowImpl
Parameters:
nvp - the list of attributtes.

removeFromCollection

public void removeFromCollection()
Description copied from interface: Row
Removes the row from the collection.

This method differs from Row.remove() in that it just removes the row from the collection. It does not remove the underlying Entity row(s) or database row(s). However, once the row is removed, it cannot be used any more. If you want to remove the row from the collection and insert it elsewhere, call Row.removeAndRetain().

Specified by:
removeFromCollection in interface Row
Overrides:
removeFromCollection in class ViewRowImpl

removeAndRetain

public void removeAndRetain()
Description copied from interface: Row
Removes the row from the collection and then retain it for insertion into another location.

This method differs from Row.remove() in that it just removes the row from the collection. It does not remove the underlying Entity row(s) or database row(s).

This method also differs from Row.removeFromCollection() in that after the row is removed from the collection, it can be inserted back into the collection at another location.

Specified by:
removeAndRetain in interface Row
Overrides:
removeAndRetain in class ViewRowImpl

lock

public void lock()
Description copied from class: ViewRowImpl
Locks the referenced Entity Rows. This method uses the design-time View Object metadata to determine which of the Entity Rows that are referenced by the View Object are updateable and should consequently be locked.

Specified by:
lock in interface Row
Overrides:
lock in class ViewRowImpl

getAttributeInternal

protected java.lang.Object getAttributeInternal(int index)
Description copied from class: ViewRowImpl
Gets the value of the attribute by index. If the attribute is mapped to an entity-attribute, invoke that entity.getAttribute() with the mapped index. For all other attributes, return the value from the ViewRow's storage.

Note that this is an "inner" accessor for an attribute and does not callout to the generated getXXX() method on a subclass of a ViewRowImpl. getAttribute() methods are the "outer" methods that callout to a subclass's getXXX() method where XXX is the name of the attribute.

Overrides:
getAttributeInternal in class ViewRowImpl
Parameters:
index - the index of the attribute.
Returns:
the value of the column at the index.

copyFrom

protected void copyFrom(ViewRowImpl other)
Description copied from class: ViewRowImpl
For subclasses to implement copy of transient members in the subclass This method is invoked when a new row is created with attributes copied from the other row for move into a new collection in makeRowCopy.

Overrides:
copyFrom in class ViewRowImpl

setNewRowState

public void setNewRowState(byte state)
Description copied from class: ViewRowImpl
void setIterator(ViewRowSetIteratorImpl rsi) { mRSI = rsi; } public ViewRowSetIteratorImpl getIterator() { return mRSI; }

Specified by:
setNewRowState in interface Row
Overrides:
setNewRowState in class ViewRowImpl
Parameters:
state - This could be STATUS_NEW or STATUS_INITIALIZED.

equals

public boolean equals(java.lang.Object other)
Description copied from class: ViewRowImpl
Tests if the specified value is equal to this ViewRowImpl object.

Overrides:
equals in class ViewRowImpl
Parameters:
other - the object to which the ViewRowImpl should be compared.
Returns:
true if the specified object is equal to the this ViewRowImpl.

getExprVarVal

public java.lang.Object getExprVarVal(java.lang.String varName)
Specified by:
getExprVarVal in interface ExprValueSupplier
Overrides:
getExprVarVal in class ViewRowImpl
For internal use only. Application developers should not use this
*** For internal framework use only ***

setExprVarVal

public void setExprVarVal(java.lang.String varName,
                          java.lang.Object val)
Specified by:
setExprVarVal in interface ExprValueSupplier
Overrides:
setExprVarVal in class RowImpl
For internal use only. Application developers should not use this
*** For internal framework use only ***

getApplicationModuleForViewAccessor

protected ApplicationModule getApplicationModuleForViewAccessor()
Description copied from class: ViewRowImpl
Internal: Applications should not use this method.

Overrides:
getApplicationModuleForViewAccessor in class ViewRowImpl
For internal use only. Application developers should not use this
*** For internal framework use only ***

findViewAccessorDef

public ViewAccessorDef findViewAccessorDef(java.lang.String name)
This method returns ViewAccessorDef with the specified name.

Overrides:
findViewAccessorDef in class ViewRowImpl
Parameters:
name - The name of the ViewAccessorDef.
Returns:
The ViewAccessorDef

createViewAccessorRS

protected RowSet createViewAccessorRS(ViewAccessorDef va)
Internal: Applications should not use this method.

Overrides:
createViewAccessorRS in class ViewRowImpl

createViewRowAttrHints

protected ViewRowAttrHintsImpl createViewRowAttrHints(AttributeDefImpl attrDef)
Description copied from class: ViewRowImpl
Create a map to store attribute hints for this row.

Overrides:
createViewRowAttrHints in class ViewRowImpl
Parameters:
attrDef - The attribute defintion for which the hints need to be created.
Returns:
an instance of ViewRowAttrHintsImpl
For internal use only. Application developers should not use this
*** For internal framework use only ***

lookupAttributeDef

public AttributeDef lookupAttributeDef(java.lang.String attrName)
Description copied from class: ViewRowImpl
final void setViewDef(ViewDefImpl vDef) { try { useInner(); mInner.setViewDef(vDef); } finally { releaseInner(); } }

Overrides:
lookupAttributeDef in class ViewRowImpl

addListBindingsForAttribute

protected void addListBindingsForAttribute(java.util.List lbs,
                                           java.util.List attrNames,
                                           java.lang.String attrName,
                                           java.util.ArrayList derivedNames,
                                           java.util.ArrayList al)
Description copied from class: RowImpl
Internal: Applications should not use this method.

Overrides:
addListBindingsForAttribute in class RowImpl

shouldAddViewAccessorRSToRow

protected boolean shouldAddViewAccessorRSToRow()
Description copied from class: ViewRowImpl
Internal: Applications should not use this method.

Overrides:
shouldAddViewAccessorRSToRow in class ViewRowImpl

findListBindingRSI

protected RowSetIterator findListBindingRSI(java.lang.String attrName,
                                            java.lang.String lbName,
                                            java.lang.String prefCrName)
Description copied from class: ViewRowImpl
Internal: Applications should not use this method.

Overrides:
findListBindingRSI in class ViewRowImpl

getListBindingRSI

protected RowSetIterator getListBindingRSI(ListBindingDef def)
Description copied from class: ViewRowImpl
Internal: Applications should not use this method.

Overrides:
getListBindingRSI in class ViewRowImpl

isRefreshRequired

protected boolean isRefreshRequired(ViewAccessorDef va,
                                    java.lang.String[] attrNames,
                                    java.lang.Object[] attrValues,
                                    RowSet rs)
Overrides:
isRefreshRequired in class ViewRowImpl

getViewAccessorResultIndex

protected int getViewAccessorResultIndex(ViewAccessorDef va)
Description copied from class: RowImpl
Return the index at which the view accessor rowset needs to be stored.

Overrides:
getViewAccessorResultIndex in class RowImpl

Oracle Fusion Middleware Java API Reference for Oracle ADF Model
11g Release 1 (11.1.1.4.0)

E10653-05

Copyright © 1997, 2011, Oracle. All rights reserved.