[Zope-Checkins] CVS: Products/Transience -
chrism at plope.com
Tue Sep 14 17:33:22 EDT 2004
Update of /cvs-repository/Products/Transience
In directory cvs.zope.org:/tmp/cvs-serv5208
Update docs mentioning optional OOB GC.
=== Products/Transience/HowTransienceWorks.stx 22.214.171.124 => 126.96.36.199.2.1 ===
--- Products/Transience/HowTransienceWorks.stx:188.8.131.52 Sun May 30 03:56:35 2004
+++ Products/Transience/HowTransienceWorks.stx Tue Sep 14 17:33:21 2004
@@ -42,6 +42,7 @@
inside of the "_data" structure. There is a concept of a
"current" bucket, which is the bucket that is contained within the
_data structured with a key equal to the "current" timeslice.
+ A current bucket must always exist (this is an invariant).
- A "max_timeslice" integer, which is equal to the "largest"
timeslice for which there exists a bucket in the _data structure.
@@ -74,10 +75,13 @@
The TOC performs "finalization", "garbage collection", and "bucket
- replentishing". It performs these tasks "in-band". This means that
- the TOC does not maintain a separate thread that wakes up every so
- often to do these housekeeping tasks. Instead, during the course of
- normal operations, the TOC opportunistically performs them.
+ replentishing". It typically performs these tasks "in-band"
+ (although it is possible to do the housekeeping tasks "out of band"
+ as well: see the methods of the Transient Object Container with
+ "housekeep" in their names). "In band" housekeeping implies that
+ the TOC does not maintain a separate thread or process that wakes up
+ every so often to clean up. Instead, during the course of normal
+ operations, the TOC opportunistically performs housekeeping functions.
Finalization is defined as optionally calling a function at bucket
expiration time against all transient objects contained within that
More information about the Zope-Checkins