oracle.adf.model.adapter.bean
Class BeanDataControl

java.lang.Object
  oracle.adf.model.adapter.AbstractImpl
      oracle.adf.model.adapter.bean.UpdatableBeanDataControl
          oracle.adf.model.adapter.bean.BeanFilterableDataControl
              oracle.adf.model.adapter.bean.JavaBeanDataControl
                  oracle.adf.model.adapter.bean.BeanDataControl

All Implemented Interfaces:

DataControl, FilterableDataControl, ManagedDataControl, TransactionalDataControl, UpdateableDataControl

Direct Known Subclasses:

BeanDCDefinitionDataControl

public class BeanDataControl
extends JavaBeanDataControl
implements ManagedDataControl

Since:

11.1.1.0

Field Summary

Fields inherited from class oracle.adf.model.adapter.bean.UpdatableBeanDataControl

_logger

Fields inherited from class oracle.adf.model.adapter.AbstractImpl

METHOD_CREATE, METHOD_EXECUTE, mName, SORT_CRITERIA

Constructor Summary

BeanDataControl(BeanDefinition beanDefinition)
Create bean data control provider

Method Summary

void	beginRequest(java.util.HashMap requestCtx) Implemented per the ManagedDataControl contract.
java.io.Serializable	createSnapshot() Creates a snapshot of the state of the DataControl.
void	endRequest(java.util.HashMap requestCtx) Implemented per the ManagedDataControl contract.
java.lang.Object	getDataControlHandler() Returns DataControlHandler
java.lang.Object	getDataProvider() Returns the data provider for this data control
java.lang.String	getName() Returns name to identify this datacontrol inside a BindingContext.
protected void	initDCProperties(java.lang.Object instance) Initialize Data Control properties
boolean	invokeOperation(java.util.Map bindingContext, OperationBinding action) All OperationBindings should first delegate to the DataControl associated with the binding to perform the action.
void	release() Releases the DataControl.
void	release(int flags) Handles releasing transactional resources when the data control is release from the binding container.
void	removeSnapshot(java.io.Serializable handle) Removes the snapshot associated with the snapshot handle.
boolean	resetState() Resets the state of the BeanDataControl to it's initial state upon entering the application: a new UnitOfWork is acquired and all RSIs associated with this DataControl are reset to their initial state.
void	restoreSnapshot(java.io.Serializable handle) Restore the state of the DataControl with the snapshot state that is referenced by the handle.
void	setDataControlHandler(java.lang.Object dcHandler) set DataControlHandler

Methods inherited from class oracle.adf.model.adapter.bean.JavaBeanDataControl

commitTransaction, findAccessorDefinition, findAccessorPropertyName, getDefinition, isTransactionDirty, rollbackTransaction

Methods inherited from class oracle.adf.model.adapter.bean.BeanFilterableDataControl

invokeAccessor, invokeOperation

Methods inherited from class oracle.adf.model.adapter.bean.UpdatableBeanDataControl

createRowData, getAddMethodName, getDCHandler, getRemoveMethodName, registerDataProvider, removeRowData, resetAccessors, setAttributeValue, validate

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

Constructor Detail

BeanDataControl

public BeanDataControl(BeanDefinition beanDefinition)

Create bean data control provider

Parameters:

beanDefinition -

Method Detail

getDataControlHandler

public java.lang.Object getDataControlHandler()

Returns DataControlHandler

setDataControlHandler

public void setDataControlHandler(java.lang.Object dcHandler)

set DataControlHandler

initDCProperties

protected void initDCProperties(java.lang.Object instance)

Initialize Data Control properties

Overrides:

initDCProperties in class JavaBeanDataControl

Parameters:

instance -

getName

public java.lang.String getName()

Returns name to identify this datacontrol inside a BindingContext.

Specified by:

getName in interface DataControl

Overrides:

getName in class UpdatableBeanDataControl

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

Overrides:

release in class UpdatableBeanDataControl

getDataProvider

public java.lang.Object getDataProvider()

Returns the data provider for this data control

Specified by:

getDataProvider in interface DataControl

Overrides:

getDataProvider in class UpdatableBeanDataControl

Returns:

The underlying business service object.

invokeOperation

public boolean invokeOperation(java.util.Map bindingContext,
                               OperationBinding action)

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

Overrides:

invokeOperation in class UpdatableBeanDataControl

Returns:

true if this datacontrol has handled this action, false if the action should be interpreted in the bindings framework or in the caller.

beginRequest

public void beginRequest(java.util.HashMap requestCtx)

Implemented per the ManagedDataControl contract. Tracks when this data control begins an application request.

Specified by:

beginRequest in interface ManagedDataControl

Parameters:

requestCtx - a HashMap representing request context.

endRequest

public void endRequest(java.util.HashMap requestCtx)

Implemented per the ManagedDataControl contract. Tracks when this data control has ended an application request.

Specified by:

endRequest in interface ManagedDataControl

Parameters:

requestCtx - a HashMap representing request context.

resetState

public boolean resetState()

Resets the state of the BeanDataControl to it's initial state upon entering the application: a new UnitOfWork is acquired and all RSIs associated with this DataControl are reset to their initial state.

Specified by:

resetState in interface ManagedDataControl

Returns:

true if resetState was processed immediately. false if resetState was deferred to endRequest processing.

createSnapshot

public java.io.Serializable createSnapshot()

Creates a snapshot of the state of the DataControl. A snapshot may be used to save the DataControl state so that it may be restored some time later. Returns a serializable handle to the snapshot.

Returns:

a snapshot handle

restoreSnapshot

public void restoreSnapshot(java.io.Serializable handle)

Restore the state of the DataControl with the snapshot state that is referenced by the handle.

Parameters:

handle - Serializable a snaphsot handle that was created with createSnapshot().

removeSnapshot

public void removeSnapshot(java.io.Serializable handle)

Removes the snapshot associated with the snapshot handle.

Parameters:

handle - Serializable a snapshot handle that was created with createSnapshot().

release

public void release(int flags)

Handles releasing transactional resources when the data control is release from the binding container.