oracle.adf.model.adapter.bean

Class BeanDCHandler

java.lang.Object

oracle.adf.model.adapter.bean.BeanDCInvocationHandler

oracle.adf.model.adapter.bean.BeanDCHandler

All Implemented Interfaces:

java.lang.reflect.InvocationHandler, DataControl, ManagedDataControl, TransactionalDataControl, UpdateableDataControl

Direct Known Subclasses:

DataFilterHandler

public class BeanDCHandler
extends BeanDCInvocationHandler
implements TransactionalDataControl, UpdateableDataControl, ManagedDataControl

Since:

12.1.1

Field Summary

Fields

Modifier and Type	Field and Description
protected DataControl	_dc BeanDC Data Control instance
static java.lang.String	beginRequest
static java.lang.String	commitTransaction
static java.lang.String	createRowData
static java.lang.String	createSnapshot
static java.lang.String	endRequest
static java.lang.String	getDataProvider
static java.lang.String	getName Proxy DC methods
static java.lang.String	invokeOperation
static java.lang.String	isTransactionDirty
static java.lang.String	registerDataProvider
static java.lang.String	release
static java.lang.String	removeRowData
static java.lang.String	removeSnapshot
static java.lang.String	resetState
static java.lang.String	restoreSnapshot
static java.lang.String	rollbackTransaction
static java.lang.String	setAttributeValue
static java.lang.String	validate

Constructor Summary

Constructors

Constructor and Description
BeanDCHandler(DataControl dc)

Method Summary

Modifier and Type	Method and Description
void	beginRequest(java.util.HashMap requestCtx) Invoked in some contexts to signal the beginning of a model request.
void	commitTransaction() Commits the current transaction to save all changes to the data source.
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.io.Serializable	createSnapshot() Creates a snapshot of the state of the DataControl.
void	endRequest(java.util.HashMap requestCtx) Invoked in some contexts to signal the end of a model request.
java.lang.Object	getDataProvider() Returns the Business Service Object that this datacontrol is associated with.
java.lang.String	getName() Returns name to identify this datacontrol inside a BindingContext.
boolean	invokeOperation(java.util.Map bindingContext, OperationBinding action) Invokes an operation identified by the given method info and with ordered arguments in the params list.
boolean	isTransactionDirty() Returns true if this transaction has been dirtied by this application, as a result of data updates, deletes or inserts.
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	removeSnapshot(java.io.Serializable handle) Removes the snapshot associated with the snapshot handle.
boolean	resetState() Resets the DataControl.
void	restoreSnapshot(java.io.Serializable handle) Restore the state of the DataControl with the snapshot state that is referenced by the handle.
void	rollbackTransaction() Rolls back the current transaction.
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.bean.BeanDCInvocationHandler

findMethod, findMethods, getInstance, invoke, invoke, invokeMethod

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

_dc

protected DataControl _dc

BeanDC Data Control instance

getName

public static final java.lang.String getName

Proxy DC methods

See Also:

Constant Field Values

release

public static final java.lang.String release

See Also:

Constant Field Values

getDataProvider

public static final java.lang.String getDataProvider

See Also:

Constant Field Values

invokeOperation

public static final java.lang.String invokeOperation

See Also:

Constant Field Values

isTransactionDirty

public static final java.lang.String isTransactionDirty

See Also:

Constant Field Values

rollbackTransaction

public static final java.lang.String rollbackTransaction

See Also:

Constant Field Values

commitTransaction

public static final java.lang.String commitTransaction

See Also:

Constant Field Values

setAttributeValue

public static final java.lang.String setAttributeValue

See Also:

Constant Field Values

createRowData

public static final java.lang.String createRowData

See Also:

Constant Field Values

registerDataProvider

public static final java.lang.String registerDataProvider

See Also:

Constant Field Values

removeRowData

public static final java.lang.String removeRowData

See Also:

Constant Field Values

validate

public static final java.lang.String validate

See Also:

Constant Field Values

beginRequest

public static final java.lang.String beginRequest

See Also:

Constant Field Values

endRequest

public static final java.lang.String endRequest

See Also:

Constant Field Values

resetState

public static final java.lang.String resetState

See Also:

Constant Field Values

createSnapshot

public static final java.lang.String createSnapshot

See Also:

Constant Field Values

restoreSnapshot

public static final java.lang.String restoreSnapshot

See Also:

Constant Field Values

removeSnapshot

public static final java.lang.String removeSnapshot

See Also:

Constant Field Values

Constructor Detail

BeanDCHandler

public BeanDCHandler(DataControl dc)

Method Detail

getName

public java.lang.String getName()

Returns name to identify this datacontrol inside a BindingContext.

Specified by:

getName in interface DataControl

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

getDataProvider

public java.lang.Object getDataProvider()

Returns the Business Service Object that this datacontrol is associated with.

Specified by:

getDataProvider in interface DataControl

Returns:

The underlying business service object.

invokeOperation

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

Invokes an operation identified by the given method info and with ordered arguments in the params list. To be renamed to invokeOperation

Specified by:

invokeOperation in interface DataControl

Parameters:

bindingContext - A binding context that provide access to all binding related objects.

action - OperationBinding

Returns:

the method return value.

isTransactionDirty

public boolean isTransactionDirty()

Returns true if this transaction has been dirtied by this application, as a result of data updates, deletes or inserts.

Specified by:

isTransactionDirty in interface TransactionalDataControl

Returns:

true if transaction is dirty, false otherwise.

rollbackTransaction

public void rollbackTransaction()

Rolls back the current transaction.

Specified by:

rollbackTransaction in interface TransactionalDataControl

commitTransaction

public void commitTransaction()

Commits the current transaction to save all changes to the data source.

Specified by:

commitTransaction in interface TransactionalDataControl

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.

Specified by:

createRowData in interface UpdateableDataControl

Parameters:

ctx - Context of the new row.

Returns:

A data object for the new row.

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.

Specified by:

removeRowData in interface UpdateableDataControl

Parameters:

ctx - Context of the rowDefinitionProviderDataControl 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

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().

beginRequest

public void beginRequest(java.util.HashMap requestCtx)

Description copied from interface: ManagedDataControl

Invoked in some contexts to signal the beginning of a model request. For example, if the DataControl is referenced in a web application then this method will be invoked by the Binding Facilities before control is forwarded to the first Servlet defined by the request.

Datacontrols may implement this method to perform request level initialization.

This method is to be called only once per request. For example, in web applications, page forwards should not result in multiple invocations of this method.

Specified by:

beginRequest in interface ManagedDataControl

Parameters:

requestCtx - a HashMap representing request context.

endRequest

public void endRequest(java.util.HashMap requestCtx)

Description copied from interface: ManagedDataControl

Invoked in some contexts to signal the end of a model request. For example, if the DataControl is referenced in a web application then this method will be invoked by the Binding Facilities after control is returned from the last Servlet defined by the request page flow.

Datacontrols may implement this method to perform request level cleanup.

This method is to be called only once per request. For example, in web applications, page forwards should not result in multiple invocations of this method.

Specified by:

endRequest in interface ManagedDataControl

Parameters:

requestCtx - a HashMap representing request context.

resetState

public boolean resetState()

Description copied from interface: ManagedDataControl

Resets the DataControl. DataControl implementation can reset any model session state that maay have been managed by this data control in this method.

For example, an EJB DataControl provider may extend resetState to close the DataControl EJB SessionBean

Please note that resetState may not occur immediately. If beginRequest has been invoked on the DataControl then resetState processing will be deferred until endRequest processing.

Specified by:

resetState in interface ManagedDataControl

Returns:

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