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

E10653-05

oracle.adf.model.adapter.bean
Class UpdatableBeanDataControl

java.lang.Object
  extended by oracle.adf.model.adapter.AbstractImpl
      extended by oracle.adf.model.adapter.bean.UpdatableBeanDataControl
All Implemented Interfaces:
DataControl, UpdateableDataControl
Direct Known Subclasses:
BeanFilterableDataControl, DefaultUpdateableBeanDataControl

public class UpdatableBeanDataControl
extends AbstractImpl
implements UpdateableDataControl

Since:
11.1.1.0

Field Summary
protected  oracle.adf.share.logging.ADFLogger _logger
           
 
Fields inherited from class oracle.adf.model.adapter.AbstractImpl
METHOD_CREATE, METHOD_EXECUTE, mName, SORT_CRITERIA
 
Constructor Summary
UpdatableBeanDataControl()
           
 
Method Summary
 java.lang.Object createRowData(RowContext ctx)
          Creates the object described by RowContext, adds it to the underlying provider Collection, registers it in the given transaction, and returns the newly created object.
 java.lang.Object getDataProvider()
          Returns the data provider for this data control.
protected  java.lang.Object getDCHandler(java.lang.String dcHandler)
          Find DC handler instance
 java.lang.String getName()
          Returns the name of this Data Control.
 boolean invokeOperation(java.util.Map bindingContext, OperationBinding action)
          All OperationBindings should first delegate to the DataControl associated with the binding to perform the action.
 java.lang.Object registerDataProvider(RowContext ctx)
          This method is called by the data binding facility before the row in the RowContext object is modified or marked as removed, so the row can be marked dirty by the data control.
 void release()
          Releases the DataControl.
 boolean removeRowData(RowContext ctx)
          Return true if the row at the given index is removed from the the RSI associated with the given iterator-binding.
 void resetAccessors()
          ADVANCED: Resets all Accessors defined on this data control to their initial empty state.
 boolean setAttributeValue(AttributeContext ctx, java.lang.Object value)
          This method is called by the data binding framework when a new value is to be set on an attribute in a bean.
 void validate()
          Validates transaction if dirty.
 
Methods inherited from class oracle.adf.model.adapter.AbstractImpl
addParameter, createAndAddNewRow, createEmptyDataSet, getAdapterContext, getDefinition, getParameterNames, getParameterValue, getSortCriteria, getStructureDef, getStructureDef, processResult, setDefinition, setName, setParameterValue, setStructureDef, shouldReexecuteOperation
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Field Detail

_logger

protected oracle.adf.share.logging.ADFLogger _logger
Constructor Detail

UpdatableBeanDataControl

public UpdatableBeanDataControl()
Method Detail

setAttributeValue

public boolean setAttributeValue(AttributeContext ctx,
                                 java.lang.Object value)
Description copied from interface: UpdateableDataControl
This method is called by the data binding framework when a new value is to be set on an attribute in a bean. The attribute and bean are provided in the attribute context along with other framework context information.

Return true if the base framework should skip any further processing of this attribute set. Otherwise return false so that framework can perform a set or put of the attribute value based on introspection.

Specified by:
setAttributeValue in interface UpdateableDataControl

createRowData

public java.lang.Object createRowData(RowContext ctx)
Creates the object described by RowContext, adds it to the underlying provider Collection, registers it in the given transaction, and returns the newly created object.

Specified by:
createRowData in interface UpdateableDataControl
Parameters:
ctx - - description of the Row to create
Returns:
A data object for the new row.

registerDataProvider

public java.lang.Object registerDataProvider(RowContext ctx)
Description copied from interface: UpdateableDataControl
This method is called by the data binding facility before the row in the RowContext object is modified or marked as removed, so the row can be marked dirty by the data control.

Specified by:
registerDataProvider in interface UpdateableDataControl
Parameters:
ctx - Context of the row to be modified or removed.
Returns:
The data object that the row represents.

removeRowData

public boolean removeRowData(RowContext ctx)
Return true if the row at the given index is removed from the the RSI associated with the given iterator-binding. In addition, this method goes into the provider underlying collection removes the object contained in the Row, and marks the object to be deleted in the given transaction.

Specified by:
removeRowData in interface UpdateableDataControl
Parameters:
ctx - Context of the row to be removed.
Returns:
true if the operation is sucessful, false otherwise.

validate

public void validate()
Description copied from interface: UpdateableDataControl
Validates transaction if dirty.

Specified by:
validate in interface UpdateableDataControl

getDataProvider

public java.lang.Object getDataProvider()
Returns the data provider for this data control.

Specified by:
getDataProvider in interface DataControl
Returns:
The underlying business service object.

getName

public java.lang.String getName()
Returns the name of this Data Control.

Specified by:
getName in interface DataControl

resetAccessors

public void resetAccessors()
ADVANCED: Resets all Accessors defined on this data control to their initial empty state.


invokeOperation

public boolean invokeOperation(java.util.Map bindingContext,
                               OperationBinding action)
Description copied from interface: DataControl
All OperationBindings should first delegate to the DataControl associated with the binding to perform the action. DataControls may choose to interpret a given action differently based on the data/collection that action is bound to.

Specified by:
invokeOperation in interface DataControl
Returns:
true if this datacontrol has handled this action, false if the action should be interpreted in the bindings framework or in the caller.

release

public void release()
Description copied from interface: DataControl
Releases the DataControl. The DataControl should be in a collectable state after release() has been invokd.

This should close all open DataControl resources.

Specified by:
release in interface DataControl

getDCHandler

protected java.lang.Object getDCHandler(java.lang.String dcHandler)
Find DC handler instance

Parameters:
dcHandler - String handler className
Returns:
instance of DC handler

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.