[CalendarServer-changes] [8157] CalendarServer/branches/users/glyph/shared-pool-take2/twext/ enterprise/ienterprise.py
source_changes at macosforge.org
source_changes at macosforge.org
Mon Oct 10 08:02:25 PDT 2011
Revision: 8157
http://trac.macosforge.org/projects/calendarserver/changeset/8157
Author: glyph at apple.com
Date: 2011-10-10 08:02:25 -0700 (Mon, 10 Oct 2011)
Log Message:
-----------
More on ICommandBlock
Modified Paths:
--------------
CalendarServer/branches/users/glyph/shared-pool-take2/twext/enterprise/ienterprise.py
Modified: CalendarServer/branches/users/glyph/shared-pool-take2/twext/enterprise/ienterprise.py
===================================================================
--- CalendarServer/branches/users/glyph/shared-pool-take2/twext/enterprise/ienterprise.py 2011-10-10 15:01:29 UTC (rev 8156)
+++ CalendarServer/branches/users/glyph/shared-pool-take2/twext/enterprise/ienterprise.py 2011-10-10 15:02:25 UTC (rev 8157)
@@ -153,10 +153,27 @@
class ICommandBlock(ISQLExecutor):
"""
This is a block of SQL commands that are grouped together.
+
+ @see: L{IAsyncTransaction.commandBlock}
"""
def end():
"""
+ End this command block, allowing other commands queued on the underlying
+ transaction to end.
+
+ @note: This is I{not} the same as either L{IAsyncTransaction.commit} or
+ L{IAsyncTransaction.abort}, since it does not denote success or
+ failure; merely that the command block has completed and other
+ statements may now be executed. Since sub-transactions are a
+ database-specific feature, they must be implemented at a
+ higher-level than this facility provides (although this facility may
+ be useful in their implementation). Also note that, unlike either
+ of those methods, this does I{not} return a Deferred: if you want to
+ know when the block has completed, simply add a callback to the last
+ L{ICommandBlock.execSQL} call executed on this L{ICommandBlock}.
+ (This may be changed in a future version for the sake of
+ convenience, however.)
"""
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.macosforge.org/pipermail/calendarserver-changes/attachments/20111010/4d49158c/attachment.html>
More information about the calendarserver-changes
mailing list