|
Oracle ADF Model and Business Components API Reference 10.1.2 B14022-01 | ||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
INTERNAL USE ONLY. This interface should not be implemented directly by any applications.
An interface for DataControl management events.
This interface is implemented by both the DCDataControl and the DCDataControlReference classes. It allows both to be notified of DataControl management events.
Method Summary | |
void |
beginRequest(java.util.HashMap requestCtx)
Invoked in some contexts to signal the beginning of a model request. |
void |
endRequest(java.util.HashMap requestCtx)
Invoked in some contexts to signal the end of a model request. |
void |
release()
|
void |
release(int flags)
Based on the value of the flags parameter, releases all references to the objects in the data provider layer (BC4J or other data-provider objects). |
boolean |
resetState()
Resets the DataControl. |
Method Detail |
public void beginRequest(java.util.HashMap requestCtx)
Subclassing datacontrols may extend this method to perform request level initialization of the DataControl.
This method is guaranteed to be called only once per browser request. Page forwards should not result in multiple invocations.
requestCtx
- a HashMap representing request context. Web
applications which require request context may use the
BindingContext.HTTP_REQUEST and
BindingContext.HTTP_RESPONSE keys to acquire a reference
from from the BindingContext.public void endRequest(java.util.HashMap requestCtx)
Subclassing datacontrols may extend this method to perform request level cleanup of the DataControl.
This method is guaranteed to be called only once per browser request. Page forwards should not result in multiple invocations.
requestCtx
- a HashMap representing request context. Web
applications which require request context may use the
BindingContext.HTTP_REQUEST and
BindingContext.HTTP_RESPONSE keys to acquire a reference
from from the BindingContext.public void release(int flags)
REL_ALL_REFS
- if this data control
should release all references to both the view and model
objects.
REL_DATA_REFS
- if this data control
should release all references to data provider objects. The
likely usage would be when say an Application Module is to
be checked into a pool and this data-control may be given
that or another checked out AM to work with subsequently.
REL_VIEW_REFS
- if this data control
should release all references to the UI/View layer objects.
public void release()
public boolean resetState()
The ADF/BC DataControl has extended resetState to release the DataControl ApplicationModule to the ApplicationPool in unmanaged release mode.
An EJB DataControl provider may extend resetState to close the DataControl EJB SessionBean
A Toplink DataControl provider may extend resetState to close the DataControl UnitOfWork or ClientSession.
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.
Extending DataControl providers should invoke release(REL_DATA_REFS) after performing and DataControl specific resetState handling.
|
Oracle ADF Model and Business Components API Reference 10.1.2 B14022-01 | ||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
Copyright © 1997, 2004, Oracle. All rights reserved.