oracle.adfinternal.model.adapter.bean

Class AbstractBeanDefinition

java.lang.Object

oracle.adf.model.adapter.AbstractDefinition

oracle.adfinternal.model.adapter.bean.AbstractBeanDefinition

All Implemented Interfaces:

DataControlDefinition, Definition, NamedDefinition

Direct Known Subclasses:

BeanDefinition, EjbDefinition

public abstract class AbstractBeanDefinition
extends AbstractDefinition

This abstract implementation of AbstractDefinition provides structure definition and associated meta data creation behavior via the DataControlStructure framework. There are three cases when an AbstractDefinition will be created in ADF: 1) Runtime: The AbstractDefinition will be created via a zero arg constructor and will be provided the data control name, meta data, and parameters. It is then expected to know how to create the rt data control. 2) Designtime via the AbstractAdapter: In this case, the AbstractDefinition is created with a non zero arg contructor. It is expected to provide the StructureDefinition, dc name, and meta data. 3) Designtime via the Adapter framework: The AbstractDefinition is created via a zero arg constructor. It is expected to provide the StructureDefinition. The meta data and and dc name are provided by the Adapter framework. This class provides facilities for handling these cases in a uniform fashion without introducing direct designtime dependencies in the concrete AbstractDefinition implementation. Case 1: Follow the AbstractAdapter pattern for handling meta data loading and data control creation. Case 2: In the BeanAbstractAdapter implementation return the concrete implementation of this class in the getDefinition(DataControlStructure) method initialized with the DataControlStructure constructor. Case 3: The abstract implementation will load the required DataControlStructure when needed from the DataControlStructureProvider registered with the DCStructureProviderFactory for the definition type. Implementors of this class must indicate the provider type via the getProviderType() method.

Since:

11.1.2

See Also:

AbstractDefinition, DataControlStructure, oracle.adfinternal.model.adapter.generic.DataControlStructureProvider, oracle.adfinternal.model.adapter.bean.AbstractBeanAdapter

Field Summary

Fields

Modifier and Type	Field and Description
static java.lang.String	ACCESS_MODE AcessMode (PagingType) - {scrollable, rangePaging}
static java.lang.String	DATA_CONTROL_HANDLER DataControl Handler - 11.1.2
static java.lang.String	EAGER_PERSIST
protected Node	metaData
protected java.util.Map	parameters
static java.lang.String	RANGE_PAGING
static java.lang.String	SCROLLABLE

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

CACHE_TO_SOURCEPATH, DONT_CACHE, mDCConfiguration, mFullName, mName, mRootDefName

Fields inherited from interface oracle.binding.meta.Definition

TYPE_ACCESSOR, TYPE_ATTRIBUTE, TYPE_CRITERIA, TYPE_CRITERIA_ITEM, TYPE_CRITERIA_OPERATOR, TYPE_CRITERIA_ROW, TYPE_DATACONTROL, TYPE_DEFINITION, TYPE_DEFINITIONCONTEXT, TYPE_NAMED, TYPE_OPERATION, TYPE_OPERATIONRETURN, TYPE_PARAMETER, TYPE_STRUCTURE, TYPE_VARIABLE

Constructor Summary

Constructors

Constructor and Description
AbstractBeanDefinition() Called by the framework.
AbstractBeanDefinition(DataControlStructure dcStructure) Called by AbstractBeanAdapter to create an initialized AbstractDefinition.

Method Summary

Methods

Modifier and Type	Method and Description
protected DCHandler	getBeanDCHandler(java.lang.String dcHandler) BeanDC DataControlHandler
protected java.lang.String	getDCName() Returns the name of the data control.
java.lang.String	getFactoryClassName() Advanced internal placeholder method.
Node	getMetadata() Returns the element that defines the metadata for the data control.
java.lang.String	getNodeValue(Node attr) Convenience method for getNodeValue(Node)
protected abstract java.lang.String	getProviderType() Indicates the type of DataControlStructureProvider to use during initialization.
protected Node	getRuntimeMetaData() Accessor that returns the DC meta data passed in by the loadFromMetadata() method.
protected java.util.Map	getRuntimeParameters() Accessor that returns the DC parameters passed in by the loadFromMetadata() method.
StructureDefinition	getStructure() Gets the structure definition of the output data.
protected void	initDefinition() Option to override rt bean-definition
boolean	isStructureDirty(boolean refresh) Indicates to the Adapter framework to always recreate the DC on refresh.
boolean	isSupported(java.lang.String operation) Indicate whether or not support operations ...
void	loadFromMetadata(Node metaData, java.util.Map parameters) Loads the definition from a metadata Node.
void	setProperty(java.lang.String propName, Node attr) Convenience method for setProperty(Node)
boolean	usePersistedStructure() Indicates whether the definition delegates to the framework the task of deserializing its StructureDefinition (for example, from bean .xml files on disk).

Methods inherited from class oracle.adf.model.adapter.AbstractDefinition

assignDefaultPackage, createDataControl, createDuplicateDetailIterator, getAdapterContext, getAdapterType, getCachingMode, getConfiguration, getConfigurationFullName, getDefClassName, getDefinitionParent, getDefinitionType, getFullName, getJUDTDataControlName, getName, getParameters, getProperties, getProperty, getRootStructureName, setAdapterContext, setCachingMode, setCompileProjectOnCreate, setConfigurationFullName, setFullName, setName, setProperty, setRootStructureName, shouldCompileProjectOnCreate, useDefinitionProvider

Methods inherited from class java.lang.Object

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

Field Detail

DATA_CONTROL_HANDLER

public static final java.lang.String DATA_CONTROL_HANDLER

DataControl Handler - 11.1.2

See Also:

Constant Field Values

ACCESS_MODE

public static final java.lang.String ACCESS_MODE

AcessMode (PagingType) - {scrollable, rangePaging}

See Also:

Constant Field Values

SCROLLABLE

public static final java.lang.String SCROLLABLE

See Also:

Constant Field Values

RANGE_PAGING

public static final java.lang.String RANGE_PAGING

See Also:

Constant Field Values

EAGER_PERSIST

public static final java.lang.String EAGER_PERSIST

See Also:

Constant Field Values

metaData

protected Node metaData

parameters

protected java.util.Map parameters

Constructor Detail

AbstractBeanDefinition

public AbstractBeanDefinition()

Called by the framework.

AbstractBeanDefinition

public AbstractBeanDefinition(DataControlStructure dcStructure)

Called by AbstractBeanAdapter to create an initialized AbstractDefinition.

Method Detail

getRuntimeParameters

protected java.util.Map getRuntimeParameters()

Accessor that returns the DC parameters passed in by the loadFromMetadata() method.

Overrides:

getRuntimeParameters in class AbstractDefinition

getRuntimeMetaData

protected Node getRuntimeMetaData()

Accessor that returns the DC meta data passed in by the loadFromMetadata() method.

getProviderType

protected abstract java.lang.String getProviderType()

Indicates the type of DataControlStructureProvider to use during initialization.

getDCName

protected final java.lang.String getDCName()

Description copied from class: AbstractDefinition

Returns the name of the data control.

Specified by:

getDCName in class AbstractDefinition

getStructure

public final StructureDefinition getStructure()

Description copied from class: AbstractDefinition

Gets the structure definition of the output data.

Specified by:

getStructure in interface DataControlDefinition

Specified by:

getStructure in class AbstractDefinition

Returns:

Definition of the output data structure.

getMetadata

public final Node getMetadata()

Description copied from class: AbstractDefinition

Returns the element that defines the metadata for the data control.

Specified by:

getMetadata in class AbstractDefinition

Returns:

a Node that defines the metadata for this instance. This metadata will be used at the runtime to fetch data from the data source.

loadFromMetadata

public final void loadFromMetadata(Node metaData,
                    java.util.Map parameters)

Description copied from class: AbstractDefinition

Loads the definition from a metadata Node.

Specified by:

loadFromMetadata in class AbstractDefinition

Parameters:

metaData - the metadata node. It can be null if no metadata is defined.

parameters - context parameters.

initDefinition

protected void initDefinition()

Option to override rt bean-definition

usePersistedStructure

public boolean usePersistedStructure()

Indicates whether the definition delegates to the framework the task of deserializing its StructureDefinition (for example, from bean .xml files on disk). Overrides base method on AbstractDefinition.

Overrides:

usePersistedStructure in class AbstractDefinition

Returns:

by default true.

isStructureDirty

public boolean isStructureDirty(boolean refresh)

Indicates to the Adapter framework to always recreate the DC on refresh.

Overrides:

isStructureDirty in class AbstractDefinition

Parameters:

refresh - flag to indicate if the refresh is requested for the structure.

Returns:

true if the implementation decides that the structure of the data should be generated. The default implementation always returns false.

isSupported

public boolean isSupported(java.lang.String operation)

Indicate whether or not support operations ...

Overrides:

isSupported in class AbstractDefinition

Parameters:

operation -

Returns:

boolean

setProperty

public void setProperty(java.lang.String propName,
               Node attr)

Convenience method for setProperty(Node)

getNodeValue

public java.lang.String getNodeValue(Node attr)

Convenience method for getNodeValue(Node)

getBeanDCHandler

protected DCHandler getBeanDCHandler(java.lang.String dcHandler)

BeanDC DataControlHandler

Parameters:

dcHandler - DCHandler handler className

Returns:

instance of criteria handler

getFactoryClassName

public java.lang.String getFactoryClassName()

Description copied from class: AbstractDefinition

Advanced internal placeholder method.

Overrides:

getFactoryClassName in class AbstractDefinition

Returns:

beandc factory class