oracle.adf.model.adapter.bean
Class UpdatableBeanDataControl

java.lang.Object
  oracle.adf.model.adapter.AbstractImpl
      oracle.adf.model.adapter.bean.UpdatableBeanDataControl

All Implemented Interfaces:

DataControl, UpdateableDataControl

Direct Known Subclasses:

BeanFilterableDataControl, TopLinkDataControl

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) This method is called by the data binding framework when a new row is needed from the data control.
java.lang.String	getAddMethodName(java.lang.String className, java.lang.String accessorName)
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.
java.lang.String	getRemoveMethodName(java.lang.String className, java.lang.String accessorName)
boolean	invokeOperation(java.util.Map bindingContext, OperationBinding action) BeanDC invoke method-operations.
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) This method is called by the data binding facility when a row should be removed from the underlying data source.
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)

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)

This method is called by the data binding framework when a new row is needed from the data control. 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.

getAddMethodName

public java.lang.String getAddMethodName(java.lang.String className,
                                         java.lang.String accessorName)

Parameters:

className -

accessorName -

Returns:

addMethodName associated with the old beanModel.xml

getRemoveMethodName

public java.lang.String getRemoveMethodName(java.lang.String className,
                                            java.lang.String accessorName)

Parameters:

className -

accessorName -

Returns:

removeMethodName associated with the old beanModel.xml

registerDataProvider

public 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.

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)

This method is called by the data binding facility when a row should be removed from the underlying data source. 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()

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)

BeanDC invoke method-operations.

Specified by:

invokeOperation in interface DataControl

Parameters:

bindingContext -

action -

Returns:

false if the framework will handle

release

public void release()

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