oracle.binding

Interface DataControl

All Known Subinterfaces:

CustomDefDataControl, DataChangeManager, DataControl, ManagedDataControl, ManagedDataControl, TransactionalDataControl, TransactionalDataControl, UpdateableDataControl

All Known Implementing Classes:

AdapterDCService, BeanDataControl, BeanDCDefinitionDataControl, BeanDCHandler, BeanFilterableDataControl, CSVDataControl, DataFilterHandler, DCBeanDataControl, DCDataControl, DCGenericDataControl, DCJboDataControl, DCPlaceholderDataControl, EjbDataControl, EjbDCDefinitionDataControl, JavaBeanDataControl, JPQLDataFilterHandler, JPQLManagedDCHandler, JUApplication, RestDataControl, RestURLDataControl, UpdatableBeanDataControl, URLDataControl, WSDataControl, XMLDataControl

public interface DataControl

An interface through which the Data Binding Facility interacts with a Service. An implementation of DataControl interface provides generic adaptation for a Service and Model technology. For example, a generic SessionBean DataControl can be written to handle interaction with any EJB session beans.
The DataControl is to be implemented by someone who is familiar with the service whose values and operations will be exposed to the view layer.
The DataControl is to be used exclusively by Tooling and the Data Binding facility to adapt different Services. It is not to be used directly by the View or Controller to access Services and Model.

Method Summary

Methods

Modifier and Type	Method and Description
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) All OperationBindings should first delegate to the DataControl associated with the binding to perform the action.
void	release() Releases the DataControl.

Method Detail

getName

java.lang.String getName()

Returns name to identify this datacontrol inside a BindingContext.

release

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.

getDataProvider

java.lang.Object getDataProvider()

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

Returns:

The underlying business service object.

invokeOperation

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

All OperationBindings should first delegate to the DataControl associated with the binding to perform the action. DataControls may choose to interpret a given action differently based on the data/collection that action is bound to.

Returns:

true if this datacontrol has handled this action, false if the action should be interpreted in the bindings framework or in the caller.