oracle.binding
Interface UpdateableDataControl

All Superinterfaces:

DataControl

All Known Subinterfaces:

TransactionalDataControl

All Known Implementing Classes:

BeanDataControl, BeanDataControl, BeanFilterableDataControl, DefaultUpdateableBeanDataControl, EjbDataControl, JavaBeanDataControl, TopLinkDataControl, UpdatableBeanDataControl, WSDataControl, XMLDataControl

public interface UpdateableDataControl
extends DataControl

This interface is to be implemented by DataControls that support an updateable or mutable business service.

Method Summary

java.lang.Object	createRowData(RowContext ctx) This method is called by the data binding framework when a new row is needed from the data control.
java.lang.Object	registerDataProvider(RowContext ctx) This method is called by the data binding facility before the row in the RowContext object is modified or marked as removed, so the row can be marked dirty by the data control.
boolean	removeRowData(RowContext ctx) This method is called by the data binding facility when a row should be removed from the underlying data source.
boolean	setAttributeValue(AttributeContext ctx, java.lang.Object value) This method is called by the data binding framework when a new value is to be set on an attribute in a bean.
void	validate() Validates transaction if dirty.

Methods inherited from interface oracle.binding.DataControl

getDataProvider, getName, invokeOperation, release

Method Detail

setAttributeValue

boolean setAttributeValue(AttributeContext ctx,
                          java.lang.Object value)

This method is called by the data binding framework when a new value is to be set on an attribute in a bean. The attribute and bean are provided in the attribute context along with other framework context information.

Return true if the base framework should skip any further processing of this attribute set. Otherwise return false so that framework can perform a set or put of the attribute value based on introspection.

createRowData

java.lang.Object createRowData(RowContext ctx)

This method is called by the data binding framework when a new row is needed from the data control.

Parameters:

ctx - Context of the new row.

Returns:

A data object for the new row.

registerDataProvider

java.lang.Object registerDataProvider(RowContext ctx)

This method is called by the data binding facility before the row in the RowContext object is modified or marked as removed, so the row can be marked dirty by the data control.

Parameters:

ctx - Context of the row to be modified or removed.

Returns:

The data object that the row represents.

removeRowData

boolean removeRowData(RowContext ctx)

This method is called by the data binding facility when a row should be removed from the underlying data source.

Parameters:

ctx - Context of the row to be removed.

Returns:

true if the operation is sucessful, false otherwise.

validate

void validate()

Validates transaction if dirty.