PATH |
EOAdaptorChannel.Delegate
(informal interface)
Package: com.webobjects.eoaccess
Interface Description
EOAdaptorChannel sends messages to its delegate for nearly every operation that would affect data in the database server. The delegate can use these methods to preempt these operations, modify their results, or simply track activity.
Instance Methods
adaptorChannelDidChangeResultSet
public abstract void adaptorChannelDidChangeResultSet(Object channel)
null
and there are still result sets left to fetch. The delegate can invoke setAttributesToFetch to prepare for fetching the new rows.
adaptorChannelDidEvaluateExpression
public abstract void adaptorChannelDidEvaluateExpression( Object channel, EOSQLExpression expression)
adaptorChannelDidExecuteStoredProcedure
public abstract void adaptorChannelDidExecuteStoredProcedure( Object channel, EOStoredProcedure procedure, NSDictionary values)
adaptorChannelDidFetchRow
public abstract void adaptorChannelDidFetchRow( Object channel, NSMutableDictionary row)
null
because there are no more rows in the current result set. The delegate may modify row, which will be returned from fetchRow.
adaptorChannelDidFinishFetching
public abstract void adaptorChannelDidFinishFetching(Object channel)
adaptorChannelDidPerformOperations
public abstract Throwable adaptorChannelDidPerformOperations( Object channel, NSArray operations, Throwable exception)
null
if no exception was raised while operations were performed. Otherwise, exception is the raised exception. The delegate can return the same or a different exception, which is re-raised by performAdaptorOperations, or it can return null
to prevent the adaptor channel from raising an exception.
adaptorChannelDidSelectAttributes
public abstract void adaptorChannelDidSelectAttributes( Object channel, NSArray attributes, com.webobjects.eocontrol.EOFetchSpecification fetchSpecification, boolean flag, EOEntity entity)
adaptorChannelShouldConstructStoredProcedureReturnValues
public abstract NSDictionary adaptorChannelShouldConstructStoredProcedureReturnValues(Object channel)
null
, that value will be returned immediately from returnValuesForLastStoredProcedureInvocation.
adaptorChannelShouldEvaluateExpression
public abstract boolean adaptorChannelShouldEvaluateExpression( Object channel, EOSQLExpression expression)
true
to permit the adaptor channel to send expression to the server. If the delegate returns false
, the adaptor channel does not send the expression and returns immediately. When the delegate returns false
, the adaptor channel expects that the implementor of the delegate has done the work that evaluateExpression would have done. The delegate can create a new EOSQLExpression and send the expression itself before returning false
.
adaptorChannelShouldExecuteStoredProcedure
public abstract NSDictionary adaptorChannelShouldExecuteStoredProcedure( Object channel, EOStoredProcedure procedure, NSDictionary values)
null
, that value is used as the arguments to the stored procedure instead of values.
adaptorChannelShouldReturnValuesForStoredProcedure
public abstract NSDictionary adaptorChannelShouldReturnValuesForStoredProcedure( Object channel, NSDictionary returnValues)
null
, that value is returned from returnValuesForLastStoredProcedureInvocation instead of returnValues.
adaptorChannelShouldSelectAttributes
public abstract boolean adaptorChannelShouldSelectAttributes( Object channel, NSArray attributes, com.webobjects.eocontrol.EOFetchSpecification fetchSpecification, boolean flag, EOEntity entity)
false
(indicating that the adaptor channel should not perform the select itself).
adaptorChannelWillFetchRow
public abstract void adaptorChannelWillFetchRow(Object channel)
adaptorChannelWillPerformOperations
public abstract NSArray adaptorChannelWillPerformOperations( Object channel, NSArray operations)
null
, the adaptor channel does not perform the operations and returns from the method immediately.
© 2001 Apple Computer, Inc. (Last Published April 13, 2001)