[CalendarServer-changes] [8159] CalendarServer/branches/users/glyph/shared-pool-take2/twext/ enterprise/ienterprise.py

[source_changes at macosforge.org]

Revision: 8159
          http://trac.macosforge.org/projects/calendarserver/changeset/8159
Author:   glyph at apple.com
Date:     2011-10-10 08:02:40 -0700 (Mon, 10 Oct 2011)
Log Message:
-----------
add a note about pickleability

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:02:32 UTC (rev 8158)
+++ CalendarServer/branches/users/glyph/shared-pool-take2/twext/enterprise/ienterprise.py	2011-10-10 15:02:40 UTC (rev 8159)
@@ -186,6 +186,11 @@
     C{args} argument to L{IAsyncTransaction.execSQL}, it will have its
     C{prequery} and C{postquery} methods invoked on it before and after
     executing the SQL query in question, respectively.
+
+    @note: L{IDerivedParameter} providers must also always be I{pickleable},
+        because in some cases the actual database cursor objects will be on the
+        other end of a network connection.  For an explanation of why this
+        might be, see L{twext.enterprise.adbapi2.ConnectionPoolConnection}.
     """
 
     def preQuery(cursor):
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.macosforge.org/pipermail/calendarserver-changes/attachments/20111010/086ddbab/attachment-0001.html>