oracle.adf.model

Interface DataControl

All Superinterfaces:

DataControl, java.util.Map

All Known Subinterfaces:

CustomDefDataControl, TransactionalDataControl

public interface DataControl
extends DataControl, java.util.Map

DataControl is a collection of DataControls accessed by their key This is only for internal purposes and implementing just this interface will not work in ADF 9.0.5.1. This interface exists for future api needs.

Nested Class Summary

Nested Classes

Modifier and Type	Interface and Description
static class	DataControl.DataChangeEventPolicy

Nested classes/interfaces inherited from interface java.util.Map

java.util.Map.Entry<K,V>

Field Summary

Fields

Modifier and Type	Field and Description
static java.lang.String	DATACHANGE_EVENT_POLLINGMODE
static int	REL_ALL_REFS Release all references held in the data control.
static int	REL_DATA_REFS Release only the data provider (Business Service) references
static int	REL_VIEW_REFS Hold on to the data references and release the View references if held on the datacontrol.
static int	REL_WEAK_DATA_REFS This is a weak data release.

Method Summary

Methods

Modifier and Type	Method and Description
java.lang.Object	getDataProvider() Return the Business Service Object that this datacontrol is associated with.
java.lang.String	getName() Returns name to identify this datacontrol.
void	release(int flags) Based on the value of the flags parameter, releases all references to the objects in the data provider layer Valid values for flags are: REL_ALL_REFS - if this data control should release all references to both the view and model objects.

Methods inherited from interface oracle.binding.DataControl

invokeOperation, release

Methods inherited from interface java.util.Map

clear, containsKey, containsValue, entrySet, equals, get, hashCode, isEmpty, keySet, put, putAll, remove, size, values

Field Detail

REL_ALL_REFS

static final int REL_ALL_REFS

Release all references held in the data control.

See Also:

Constant Field Values

REL_DATA_REFS

static final int REL_DATA_REFS

Release only the data provider (Business Service) references

See Also:

Constant Field Values

REL_VIEW_REFS

static final int REL_VIEW_REFS

Hold on to the data references and release the View references if held on the datacontrol. This should be internal to ADFm implementation and may not be exposed in the JSR.

See Also:

Constant Field Values

REL_WEAK_DATA_REFS

static final int REL_WEAK_DATA_REFS

This is a weak data release. This may be specified by a DataControl to release data refs that do not rely upon any session state like iterator currency. These references are typical cache references and may be rebuilt at any time using the DataControl. For example, BC4J uses this release flag to release JUCtrlListBinding references to BC4J rows. These rows are cached for performance but also may be re-fetched from the DataControl at any time.

See Also:

Constant Field Values

DATACHANGE_EVENT_POLLINGMODE

static final java.lang.String DATACHANGE_EVENT_POLLINGMODE

See Also:

Constant Field Values

For internal use only. Application developers should not use this

*** For internal framework use in ADS only ***

Method Detail

getName

java.lang.String getName()

Returns name to identify this datacontrol. - unused.

Specified by:

getName in interface DataControl

release

void release(int flags)

Based on the value of the flags parameter, releases all references to the objects in the data provider layer Valid values for flags are:

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

getDataProvider

java.lang.Object getDataProvider()

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

Specified by:

getDataProvider in interface DataControl

Returns:

The underlying business service object.