ZODB.Architecture.Storage Interface.store

Documentation

Store data for the object id, oid. Data is given as a string that may contain binary data. A Storage need not and often will not write data immediately. If data are written, then the storage should be prepared to undo the write if a transaction is aborted.

Parameters

Type	Name	Documentation
OID	oid
SerialNumber	serial	The serial number of the object version that was changed to create the data being stored. This is used as a check to make sure that another thread or process has not modified the object since the object was read. If the provided serial number does not match the currently stored serial number, then a ConflictError is raised.
PyString	data
VersionString	version
Transaction	transaction

Returns

The new serial number (time stamp) for the object.

PostConditions

There mist not be any session data records for the oid.

State-dependent

It is an error to call this method if the storage is not committing, or if the store transaction is not the transaction given in the most recent tpc_begin.

Version

If oid has been modified by an uncommitted version and the transaction�s version is not the version that modified oid, then a VersionLockError will be raised. Modifying an object in a version locks the object.