__init__(self, name)
(Constructor)

administrativeConnectionDictionaryForAdaptor(self, anAdaptor)

assertConnectionDictionaryIsValid(self)

assignExternalInfoForAttribute(self, anAttribute)

assignExternalInfoForEntireModel(self, aModel)

assignExternalInfoForEntity(self, anEntity)

assignExternalTypeForAttribute(self, anAttribute)

canServiceModel(self, aModel)

connectionDictionary(self)

Returns the connectionDictionary

See also: setConnectionDictionary()

contexts(self)

Returns all AdaptorContexts created and registered with this Adaptor

See also: createAdaptorContext()

createAdaptorContext(self)

Instanciates a new AdaptorContext, registers it in the list of contexts() then returns it.

abstract

Subclasses should override this method to add the appropriate AdaptorContext to the private attribute 'self._contexts' and return it, without calling this method.

createDatabaseWithAdministrativeConnectionDictionary(self, administrativeConnectionDictionary)

Connects to the database with the supplied connection dictionary and creates the database specified by the Adaptor's connectionDictionary()

Adaptor's implementation does nothing.

Subclasses should implement this method without calling this.

defaultExpressionClass(self)

Returns the default expression class to be used along with this adaptor. See 'expressionClass()' for an explanation on how the expression class is actually determined for an Adaptor.

Subclasses should override this method without calling Adaptor's.

delegate(self)

dropDatabaseWithAdministrativeConnectionDictionary(self, administrativeConnectionDictionary)

expressionClass(self)

Returns the expression class to be used with the Adaptor.

The mechanism used needs a little explanation. First, a concrete Adaptor
comes with (or reuse) a concrete expressionClass (SQLExpression) -- the
method 'defaultExpressionClass()' returns that concrete expression class.
This is also the default value returned by this method.

However, you may need to substitute that default expression class with one
of your own (for example, you may want to subclass that expr.class to
change part of its behaviour). This is what the static method
'setExpressionClassForAdaptor()' does: when called, it registers your
custom expression class for use with a given adaptor. Any subsequent call
to this method --'expressionClass()'-- then returns the registered
expr. class instead of the default one.

To summarize it:
- if 'expressionClassForAdaptor(self)' returns None, the method returns
  'self.defaultExpressionClass()'
- otherwise, it returns 'expressionClassForAdaptor(self)'

Subclasses should not override this method.

expressionFactory(self)

externalTypesWithModel(self, aModel)

fetchedValueForDataValue(self, value, anAttribute)

fetchedValueForDateValue(self, value, anAttribute)

fetchedValueForNumberValue(self, value, anAttribute)

Adaptor's implementation returns 'value', possibly modified if 'anAttribute' corresponds to a SQL 'NUMERIC' field with a scale lower than the number of digits in the fractional part.

For example, the float '4.675' will be converted to '4.68' if 'anAttribute' has a scale of 2.

fetchedValueForStringValue(self, value, anAttribute)

fetchedValueForValue(self, value, anAttribute)

This method examine 'anAttribute' and, according to its externalType, forwards the message to one of the methods fetchedValueForDataValue(), fetchedValueForDateValue(), fetchedValueForNumberValue() or fetchedValueForStringValue().

The purpose here is to return a value, derived from 'value', which reflects the value as it is actually stored by a database-backend. This is used by the snapshotting mechanisms in the framework (optimistic locking).

See these methods for a description of their actions.

handleDroppedConnection(self)

hasOpenChannels(self)

internalTypeForExternalType(self, extType, aModel)

isDroppedConnectionException(self, exception)

isValidQualifierType(self, typeName, aModel)

name(self)

Returns the name that was used when the concrete Adaptor was instanciated.

See also: adaptorWithName(), adaptorWithModel()

prototypeAttributes(self)

schemaGenerationFactory(self)

setConnectionDictionary(self, connectionDictionary)

Sets the connectionDictionary.

Raises ValueError if hasOpenChannels() returns true --in this case the connectionDictionary is not set.

setDelegate(self, aDelegate)

adaptorWithModel(aModel)

Returns the adaptor associated to the supplied model: it extracts the name of the adaptor to be used with the model then calls adaptorWithModel() Raises ValueError is parameter 'aModel' is None or if its adaptorName is empty.

Raises AdaptorImportError if the adaptor cannot be loaded.

adaptorWithName(aName)

Returns the adaptor.

Raises AdaptorImportError if the adaptor cannot be loaded.

defaultDelegate()

Returns the default delegate.

See also: setDefaultDelegate()

expressionClassForAdaptor(adaptor)

setDefaultDelegate(delegate)

setExpressionClassForAdaptor(sqlExpression, adaptor)