[Zope-Checkins] CVS: ZODB/src/ZODB - Connection.py:1.120
jeremy at zope.com
Tue Feb 24 16:31:04 EST 2004
Update of /cvs-repository/ZODB/src/ZODB
In directory cvs.zope.org:/tmp/cvs-serv11158
New Connection class docstring based on ZODB4 docstring.
=== ZODB/src/ZODB/Connection.py 1.119 => 1.120 ===
--- ZODB/src/ZODB/Connection.py:1.119 Mon Feb 23 03:23:46 2004
+++ ZODB/src/ZODB/Connection.py Tue Feb 24 16:31:03 2004
@@ -50,13 +50,35 @@
global_reset_counter += 1
class Connection(ExportImport, object):
- """Object managers for individual object space.
+ """Connection to ZODB for loading and storing objects.
- An object space is a version of collection of objects. In a
- multi-threaded application, each thread gets its own object space.
+ The Connection object serves as a data manager. The root() method
+ on a Connection returns the root object for the database. This
+ object and all objects reachable from it are associated with the
+ Connection that loaded them. When the objects are modified, the
+ Connection is registered with the current transaction.
+ ZODB is organized so that each thread should have its own
+ Connection and that no thread should have more than one Connection
+ to the same database. A thread is associated with a Connection by
+ loading objects from that Connection. Objects loaded by one
+ thread should not be used by another thread.
+ A Connection can be associated with a single version when it is
+ created. By default, a Connection is not associated with a
+ version; it uses non-version data.
+ A Connection instance is not thread-safe. It is designed to
+ support a thread model where each thread has its own transaction.
+ If an application has more than one thread that uses the
+ connection or the transaction the connection is registered with,
+ the application should provide locking.
- The Connection manages movement of objects in and out of object storage.
_tmp = None
_debug_info = ()
_opened = None
@@ -464,7 +486,7 @@
assert object._p_jar is self
# XXX Figure out why this assert causes test failures
- # assert object._p_oid is not None
+ assert object._p_oid is not None
More information about the Zope-Checkins