[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