Commit f09e1dfc authored by Jeremy Hylton's avatar Jeremy Hylton

add words about copies of objects and about DB.open()

revise words about registering with transactions.
parent 61827b92
......@@ -13,7 +13,7 @@
##############################################################################
"""Database connection support
$Id: Connection.py,v 1.121 2004/02/24 21:38:38 jeremy Exp $"""
$Id: Connection.py,v 1.122 2004/02/24 22:07:46 jeremy Exp $"""
import logging
import sys
......@@ -55,10 +55,10 @@ class Connection(ExportImport, object):
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.
Connection that loaded them. When a transaction commits, it uses
the Connection to store modified objects.
The typical use of ZODB is for each thread should have its own
The typical use of ZODB is for each thread to 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
......@@ -68,6 +68,14 @@ class Connection(ExportImport, object):
created. By default, a Connection is not associated with a
version; it uses non-version data.
Each Connection provides an isolated, consistent view of the
database, by managing independent copies of objects in the
database. At transaction boundaries, these copies are updated to
reflect the current state of the database.
You should not instantiate this class directly; instead call the
open() method of a DB instance.
Synchronization
A Connection instance is not thread-safe. It is designed to
......@@ -79,7 +87,7 @@ class Connection(ExportImport, object):
XXX We should document an intended API for using a Connection via
multiple threads.
$Id: Connection.py,v 1.121 2004/02/24 21:38:38 jeremy Exp $
$Id: Connection.py,v 1.122 2004/02/24 22:07:46 jeremy Exp $
"""
_tmp = None
......
Markdown is supported
0%
or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment