ActiveObject.py 5.79 KB
Newer Older
Jean-Paul Smets's avatar
Jean-Paul Smets committed
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30
##############################################################################
#
# Copyright (c) 2002 Nexedi SARL and Contributors. All Rights Reserved.
#                    Jean-Paul Smets-Solanes <jp@nexedi.com>
#
# WARNING: This program as such is intended to be used by professional
# programmers who take the whole responsability of assessing all potential
# consequences resulting from its eventual inadequacies and bugs
# End users who are looking for a ready-to-use solution with commercial
# garantees and support are strongly adviced to contract a Free Software
# Service Company
#
# This program is Free Software; you can redistribute it and/or
# modify it under the terms of the GNU General Public License
# as published by the Free Software Foundation; either version 2
# of the License, or (at your option) any later version.
#
# This program is distributed in the hope that it will be useful,
# but WITHOUT ANY WARRANTY; without even the implied warranty of
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
# GNU General Public License for more details.
#
# You should have received a copy of the GNU General Public License
# along with this program; if not, write to the Free Software
# Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA  02111-1307, USA.
#
##############################################################################

import ExtensionClass
from AccessControl import ClassSecurityInfo
31
from Acquisition import aq_base
32
from ZODB.POSException import ConflictError
Jean-Paul Smets's avatar
Jean-Paul Smets committed
33

34 35 36 37 38
try:
  from Products.CMFCore import permissions
except ImportError:
  from Products.CMFCore import CMFCorePermissions as permissions

Jean-Paul Smets's avatar
Jean-Paul Smets committed
39 40 41 42
from zLOG import LOG

DEFAULT_ACTIVITY = 'SQLDict'

43 44 45 46 47 48
# Processing node are used to store processing state or processing node
DISTRIBUTABLE_STATE = -1
INVOKE_ERROR_STATE = -2
VALIDATE_ERROR_STATE = -3
STOP_STATE = -4
POSITIVE_NODE_STATE = 'Positive Node State' # Special state which allows to select positive nodes
Jean-Paul Smets's avatar
Jean-Paul Smets committed
49 50 51 52 53

class ActiveObject(ExtensionClass.Base):

  security = ClassSecurityInfo()

54
  def activate(self, activity=DEFAULT_ACTIVITY, active_process=None, passive_commit=0, **kw):
55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72
    """
      Reserved Optional parameters
      
      at_date           --  request execution date for this activate call
      
      after_method_id   --  never validate message if after_method_id
                            is in the list of methods which are
                            going to be executed
    
      after_message_uid --  never validate message if after_message_uid
                            is in the list of messages which are
                            going to be executed
    
      after_path        --  never validate message if after_path
                            is in the list of path which are
                            going to be executed                                                              
      
    """
73 74
    activity_tool = getattr(self, 'portal_activities', None)
    if activity_tool is None: return self # Do nothing if no portal_activities
Jean-Paul Smets's avatar
Jean-Paul Smets committed
75 76 77 78
    # activate returns an ActiveWrapper
    # a queue can be provided as well as extra parameters
    # which can be used for example to define deferred tasks
    try:
79 80 81 82
      # This volatile variable '_v_activate_kw' can be used to pass parameters
      # automatically to activate.
      if hasattr(self, '_v_activate_kw'):
        kw.update(self._v_activate_kw)
83
      return activity_tool.activate(self, activity, active_process, **kw)
84 85
    except ConflictError:
      raise
Jean-Paul Smets's avatar
Jean-Paul Smets committed
86 87 88 89
    except:
      LOG("WARNING CMFActivity:",0, 'could not create activity for %s' % self.getRelativeUrl())
      # If the portal_activities were not created
      # return a passive object
90
      if passive_commit: get_transaction().commit()
Jean-Paul Smets's avatar
Jean-Paul Smets committed
91 92
      return self

93
  security.declareProtected( permissions.ModifyPortalContent, 'flushActivity' )
Jean-Paul Smets's avatar
Jean-Paul Smets committed
94
  def flushActivity(self, invoke=0, **kw):
95 96
    activity_tool = getattr(self, 'portal_activities', None)
    if activity_tool is None: return # Do nothing if no portal_activities
Jean-Paul Smets's avatar
Jean-Paul Smets committed
97
    # flush all activities related to this object
98 99
    #try:
    if 1:
100
      activity_tool.flush(self, invoke=invoke, **kw)
101 102 103 104
    #except:
    #  # If the portal_activities were not created
    #  # nothing to do
    #  pass
Jean-Paul Smets's avatar
Jean-Paul Smets committed
105

106
  security.declareProtected( permissions.ModifyPortalContent, 'recursiveFlushActivity' )
107
  def recursiveFlushActivity(self, invoke=0, **kw):
Jean-Paul Smets's avatar
Jean-Paul Smets committed
108
    # flush all activities related to this object
109 110 111 112 113
    self.flushActivity(invoke=invoke, **kw)
    if hasattr(aq_base(self), 'objectValues'):
      for o in self.objectValues():
        if hasattr(aq_base(self), 'recursiveFlushActivity'):
          o.recursiveFlushActivity(invoke=invoke, **kw)
Jean-Paul Smets's avatar
Jean-Paul Smets committed
114

115
  security.declareProtected( permissions.View, 'hasActivity' )
Jean-Paul Smets's avatar
Jean-Paul Smets committed
116 117 118 119
  def hasActivity(self, **kw):
    """
      Tells if an object if active
    """
120 121
    activity_tool = getattr(self, 'portal_activities', None)
    if activity_tool is None: return 0 # Do nothing if no portal_activities
Jean-Paul Smets's avatar
Jean-Paul Smets committed
122
    try:
123
      return activity_tool.hasActivity(self, **kw)
124 125
    except ConflictError:
      raise
Jean-Paul Smets's avatar
Jean-Paul Smets committed
126 127 128 129
    except:
      # If the portal_activities were not created
      # there can not be any activity
      return 0
130

131
  security.declareProtected( permissions.View, 'hasErrorActivity' )
132 133 134 135 136 137
  def hasErrorActivity(self, **kw):
    """
      Tells if an object if active
    """
    return self.hasActivity(processing_node = INVOKE_ERROR_STATE)

138
  security.declareProtected( permissions.View, 'hasInvalidActivity' )
139 140 141 142 143 144
  def hasInvalidActivity(self, **kw):
    """
      Tells if an object if active
    """
    return self.hasActivity(processing_node = VALIDATE_ERROR_STATE)

145
  security.declareProtected( permissions.View, 'getActiveProcess' )
146
  def getActiveProcess(self):
147 148
    activity_tool = getattr(self, 'portal_activities', None)
    if activity_tool is None: return None # Do nothing if no portal_activities
149
    return self.portal_activities.getActiveProcess()