oracle.adf.model.adapter.bean.jpa

Class JPQLManagedDCHandler

java.lang.Object

oracle.adf.model.adapter.bean.BeanDCInvocationHandler

oracle.adf.model.adapter.bean.BeanDCHandler

oracle.adf.model.adapter.bean.DataFilterHandler

oracle.adf.model.adapter.bean.jpa.JPQLDataFilterHandler

oracle.adf.model.adapter.bean.jpa.JPQLManagedDCHandler

All Implemented Interfaces:

java.lang.reflect.InvocationHandler, DCCriteriaHandler, DCHandler, DataControl, FilterableDataControl, ManagedDataControl, TransactionalDataControl, UpdateableDataControl

public class JPQLManagedDCHandler
extends JPQLDataFilterHandler
implements ManagedDataControl

Since:

11.1.1.2

Field Summary

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

_beanDataProvider, _logger

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

_dc, beginRequest, commitTransaction, createRowData, createSnapshot, endRequest, getDataProvider, getName, invokeOperation, isTransactionDirty, registerDataProvider, release, removeRowData, removeSnapshot, resetState, restoreSnapshot, rollbackTransaction, setAttributeValue, validate

Constructor Summary

Constructors

Constructor and Description
JPQLManagedDCHandler(DataControl dataControl)

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.
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.
void	release() Releases the DataControl.
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.

Methods inherited from class oracle.adf.model.adapter.bean.jpa.JPQLDataFilterHandler

getHandlerMethodNames, invoke, invoke, invoke, supportsCriteria

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

getDataCollection, getDataControlHandler, initDataCollection, invokeAccessor, invokeOperation, supportsPaging, supportsPaging, supportsRangePaging, supportsRangePaging, supportsSorting

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

commitTransaction, createRowData, isTransactionDirty, registerDataProvider, removeRowData, rollbackTransaction, setAttributeValue, validate

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

findMethod, findMethods, getInstance, invoke, invokeMethod

Methods inherited from class java.lang.Object

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

Constructor Detail

JPQLManagedDCHandler

public JPQLManagedDCHandler(DataControl dataControl)

Method Detail

createSnapshot

public java.io.Serializable createSnapshot()

Description copied from class: BeanDCHandler

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.

Overrides:

createSnapshot in class BeanDCHandler

Returns:

a snapshot handle

restoreSnapshot

public void restoreSnapshot(java.io.Serializable handle)

Description copied from class: BeanDCHandler

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

Overrides:

restoreSnapshot in class BeanDCHandler

Parameters:

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

removeSnapshot

public void removeSnapshot(java.io.Serializable handle)

Description copied from class: BeanDCHandler

Removes the snapshot associated with the snapshot handle.

Overrides:

removeSnapshot in class BeanDCHandler

Parameters:

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

getName

public java.lang.String getName()

Description copied from class: BeanDCHandler

Returns name to identify this datacontrol inside a BindingContext.

Specified by:

getName in interface DataControl

Overrides:

getName in class BeanDCHandler

release

public void release()

Description copied from class: BeanDCHandler

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 BeanDCHandler

getDataProvider

public java.lang.Object getDataProvider()

Description copied from class: BeanDCHandler

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

Specified by:

getDataProvider in interface DataControl

Overrides:

getDataProvider in class BeanDCHandler

Returns:

The underlying business service object.

invokeOperation

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

Description copied from class: BeanDCHandler

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

Overrides:

invokeOperation in class DataFilterHandler

Parameters:

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

action - OperationBinding

Returns:

the method return value.

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

Overrides:

beginRequest in class BeanDCHandler

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

Overrides:

endRequest in class BeanDCHandler

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

Overrides:

resetState in class BeanDCHandler

Returns:

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