oracle.binding
Interface TransactionalDataControl

All Superinterfaces:

DataControl

public interface TransactionalDataControl

extends DataControl

This interface is to be implementated by DataControls that supports transactions.

Field Summary

Fields inherited from interface oracle.binding.DataControl

REL_ALL_REFS, REL_DATA_REFS, REL_VIEW_REFS, REL_WEAK_DATA_REFS

Method Summary

void	commitTransaction() Commits the current transaction to save all changes to the data source.
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.
boolean	isTransactionDirty() Returns true if this transaction has been dirtied by this application, as a result of data updates, deletes or inserts.
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.
void	rollbackTransaction() Rolls back the current transaction.
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

isTransactionDirty

public boolean isTransactionDirty()

Returns true if this transaction has been dirtied by this application, as a result of data updates, deletes or inserts.

Returns:

true if transaction is dirty, false otherwise.

setAttributeValue

public 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

public 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

public 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

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

rollbackTransaction

public void rollbackTransaction()

Rolls back the current transaction.

commitTransaction

public void commitTransaction()

Commits the current transaction to save all changes to the data source.

validate

public void validate()

Validates transaction if dirty.