__init__(self, anAdaptorContext)
(Constructor)

__unimplemented__(self)

adaptorContext(self)

addStoredProceduresNamed(self, storedProcedureNames, aModel)

attributesToFetch(self)

cancelFetch(self)

closeChannel(self)

delegate(self)

deleteRowDescribedByQualifier(self, aQualifier, anEntity)

Calls 'deleteRowsDescribedByQualifier()' on itself and make sure that one and only one row was deleted. If the returned value from 'deleteRowsDescribedByQualifier()' is not one, it raises GeneralAdaptorException.

Subclasses should not override this method.

Parameters: see deleteRowsDescribedByQualifier()

deleteRowsDescribedByQualifier(self, aQualifier, anEntity)

Implemented by subclasses to delete the rows identified by the parameters.

This method returns the number of rows deleted.

Parameters:

aQualifier -- a Qualifier object describing the rows to delete

anEntity -- the Entity corresponding to the type of the objects

to-be-deleted (hence, identifies the database table from which rows should be deleted)

See also: deleteRowDescribedByQualifier(), performAdaptorOperation()

describeModelWithTableNames(self, tableNames)

describeResults(self)

describeStoredProcedureNames(self)

describeTableNames(self)

dictionaryWithObjectsForAttributes(self, objects, attributes)

evaluateExpression(self, anSQLexpression)

Extract the SQL statement from 'anSQLexpression' and sends it to the database for execution.

If its AdaptorContext did not have an opened transaction when this method is called, it should automatically start a new transaction which is ended before the method returns.

Parameter:

anSQLexpression -- the SQLExpression object to execute

See also: SQLExpression.statement(), AdaptorContext.hasOpenTransaction()

executeStoredProcedure(self, aStoredProcedure, values)

fetchRow(self)

insertRow(self, row, anEntity)

isFetchInProgress(self)

isOpen(self)

lockRowComparingAttributes(self, atts, anEntity, aQualifier, snapshot)

openChannel(self)

performAdaptorOperation(self, anAdaptorOperation)

Examines 'anAdaptorOperation' and executes the corresponding method.

Given that 'operator' is anAdaptorOperation.operator(), and that constants used below (such as 'ADAPTOR_INSERT_OPERATOR') are defined in class DatabaseOperation, this is how things work:

• if 'operator' is 'ADAPTOR_INSERT_OPERATOR', we call insertRow()
• if 'operator' is 'ADAPTOR_DELETE_OPERATOR', we call deleteRowDescribedByQualifier()
• 'operator' is 'ADAPTOR_UPDATE_OPERATOR', we call updateValuesInRowDescribedByQualifier()

Subclasses should not override this method.

Raises GeneralAdaptorException in case of failure

Parameter:

adaptorOperation -- the AdaptorOperation to execute

See also: performAdaptorOperations(), DatabaseOperation

performAdaptorOperations(self, adaptorOperations)

Iterates on each item in 'adaptorOperations' and calls 'performAdaptorOperation()' with that item as a parameter.

Subclasses should not override this method.

Parameter:

adaptorOperations -- a sequence of AdaptorOperation objects

primaryKeysForNewRowsWithEntity(self, count, anEntity)

returnValuesForLastStoredProcedureInvocation(self)

rowCountForSelectAttributes(self, attributes, aFetchSpecification, shouldLock, anEntity)

Implemented by concrete adaptors to return the number of rows that would be fetched if selectAttributes() is called with the same arguments.

Parameters: see selectAttributes()

See also: SQLExpression.prepareSelectCountExpressionWithAttributes()

selectAttributes(self, attributes, aFetchSpecification, shouldLock, anEntity)

setAttributesToFetch(self, attributes)

setDelegate(self, aDelegate)

updateValuesInRowDescribedByQualifier(self, row, aQualifier, anEntity)

Calls 'updateValuesInRowsDescribedByQualifier' on itself and make sure that one and only one row was updated. If the returned value from 'updateValuesInRowsDescribedByQualifier' is not exactly one, it raises GeneralAdaptorException.

Subclasses should not override this method.

Parameters: see updateValuesInRowsDescribedByQualifier

updateValuesInRowsDescribedByQualifier(self, row, aQualifier, anEntity)

Implemented by subclasses to update the rows identified by the parameters.

This method returns the number of updated rows.

Parameters:

row --

aQualifier -- a Qualifier object describing the rows to update

anEntity -- the Entity corresponding to the type of the objects to be

updated (hence, identifies the database table from which rows should be updated)

See also: updateValuesInRowDescribedByQualifier(),

performAdaptorOperation()

Returns: the number of updated rows