eZ Components trunk

Getting Started

Components

Archive (trunk)
Authentication (trunk)
AuthenticationDatabaseTiein (trunk)
Base (trunk)
Cache (trunk)
Configuration (trunk)
ConsoleTools (trunk)
Database (trunk)
DatabaseSchema (trunk)
Debug (trunk)
Document (trunk)
EventLog (trunk)
EventLogDatabaseTiein (trunk)
Execution (trunk)
Feed (trunk)
File (trunk)
Graph (trunk)
GraphDatabaseTiein (trunk)
ImageAnalysis (trunk)
ImageConversion (trunk)
Mail (trunk)
MvcTools (trunk)
MvcAuthenticationTiein (trunk)
MvcFeedTiein (trunk)
MvcMailTiein (trunk)
MvcTemplateTiein (trunk)
PersistentObject (trunk)
PersistentObjectDatabaseSchemaTiein (trunk)
PhpGenerator (trunk)
Search (trunk)
SignalSlot (trunk)
SystemInformation (trunk)
Template (trunk)
TemplateTranslationTiein (trunk)
Translation (trunk)
TranslationCacheTiein (trunk)
Tree (trunk)
TreeDatabaseTiein (trunk)
TreePersistentObjectTiein (trunk)
Url (trunk)
UserInput (trunk)
Webdav (trunk)
Workflow (trunk)
WorkflowDatabaseTiein (trunk)
WorkflowEventLogTiein (trunk)
WorkflowSignalSlotTiein (trunk)

Workflow: ezcWorkflowNode

[ Tutorial ] [ Theoretical background ] [ Class tree ] [ Element index ] [ ChangeLog ] [ Credits ]

Class: ezcWorkflowNode

Abstract base class for workflow nodes. [source]

Implemented Interfaces

ezcWorkflowVisitable

All workflow nodes must extend this class.

Descendents

Child Class	Description
ezcWorkflowNodeBranch	Base class for nodes that branch multiple threads of execution.
ezcWorkflowNodeMerge	Base class for nodes that merge multiple threads of execution.
ezcWorkflowNodeArithmeticBase	Base class for nodes that implement simple integer arithmetic.
ezcWorkflowNodeEnd	An object of the ezcWorkflowNodeEnd class represents an end node of a workflow.
ezcWorkflowNodeAction	An object of the ezcWorkflowNodeAction class represents an activity node holding business logic.
ezcWorkflowNodeVariableSet	An object of the ezcWorkflowNodeVariableSet class sets the specified workflow variable to a given value.
ezcWorkflowNodeInput	An object of the ezcWorkflowNodeInput class represents an input (from the application) node.
ezcWorkflowNodeVariableUnset	An object of the ezcWorkflowNodeVariableUnset class unset the specified workflow variable.
ezcWorkflowNodeStart	An object of the ezcWorkflowNodeStart class represents the one and only tart node of a workflow. The execution of the workflow starts here.
ezcWorkflowNodeSubWorkflow	An object of the ezcWorkflowNodeSubWorkflow class represents a sub-workflow.

Constants

`WAITING_FOR_ACTIVATION = 0`	The node is waiting to be activated.
`WAITING_FOR_EXECUTION = 1`	The node is activated and waiting to be executed.

Member Variables

protected ezcWorkflowNode[]	`$activatedFrom = array()` The node(s) that activated this node.
protected integer	`$activationState` The state of this node.
protected array(	`$configuration` The configuration of this node. The configuration is a structured (hash) array with the various options of the implemented node. This functionality is implemented as an array to make it possible to have the storage engines unaware of the node classes.
protected integer	`$id = false` Unique ID of this node. Only available when the workflow this node belongs to has been loaded from or saved to the data storage.
protected array(	`$inNodes = array()` The incoming nodes of this node.
protected boolean	`$internalCall = false` Flag that indicates whether an addNode() or removeNode() call is internal. This is necessary to avoid unlimited loops.
protected integer	`$maxInNodes = 1` Constraint: The maximum number of incoming nodes this node has to have to be valid. Set to false to disable this constraint.
protected integer	`$maxOutNodes = 1` Constraint: The maximum number of outgoing nodes this node has to have to be valid. Set to false to disable this constraint.
protected integer	`$minInNodes = 1` Constraint: The minimum number of incoming nodes this node has to have to be valid. Set to false to disable this constraint.
protected integer	`$minOutNodes = 1` Constraint: The minimum number of outgoing nodes this node has to have to be valid. Set to false to disable this constraint.
protected integer	`$numInNodes = 0` The number of incoming nodes.
protected integer	`$numOutNodes = 0` The number of outgoing nodes.
protected array(	`$outNodes = array()` The outgoing nodes of this node.
protected mixed	`$state = null` The state of this node.
protected integer	`$threadId = null` The id of the thread this node is executing in.

Method Summary

public ezcWorkflowNode	`__construct( [$configuration = null] )` Constructs a new node with the configuration $configuration.
public void	`accept( $visitor )` Reimplementation of accept() calls accept on all out nodes.
protected void	`activateNode( $execution, $node )` Convenience method for activating an (outgoing) node.
public ezcWorkflowNode	`addInNode( $node )` Adds a node to the incoming nodes of this node.
public ezcWorkflowNode	`addOutNode( $node )` Adds a node to the outgoing nodes of this node.
public mixed	`getConfiguration( )` Returns the configuration of this node.
public ezcWorkflowNode[]	`getInNodes( )` Returns the incoming nodes of this node.
public ezcWorkflowNode[]	`getOutNodes( )` Returns the outgoing nodes of this node.
public boolean	`removeInNode( $node )` Removes a node from the incoming nodes of this node.
public boolean	`removeOutNode( $node )` Removes a node from the outgoing nodes of this node.
public void	`verify( )` Checks this node's constraints.

Methods

__construct

ezcWorkflowNode __construct( [mixed $configuration = null] )

Constructs a new node with the configuration $configuration.

The configuration is a structured (hash) array. Implementations must pass their complete configuration on to this object. We have chosen to use structured arrays for the configuration since it simplifies the process of creating new node types and storing workflows.

Parameters

Name	Type	Description
`$configuration`	mixed

Redefined in descendants as

Method	Description
`ezcWorkflowNodeArithmeticBase::__construct()`	Constructs a new action node with the configuration $configuration.
`ezcWorkflowNodeAction::__construct()`	Constructs a new action node with the configuration $configuration.
`ezcWorkflowNodeVariableSet::__construct()`	Constructs a new variable set node with the configuration $configuration.
`ezcWorkflowNodeInput::__construct()`	Constructs a new input node.
`ezcWorkflowNodeVariableUnset::__construct()`	Constructs a new unset node.
`ezcWorkflowNodeSubWorkflow::__construct()`	Constructs a new sub workflow with the configuration $configuration.

accept

void accept( ezcWorkflowVisitor $visitor )

Reimplementation of accept() calls accept on all out nodes.

Parameters

Name	Type	Description
`$visitor`	ezcWorkflowVisitor

activateNode

void activateNode( ezcWorkflowExecution $execution, ezcWorkflowNode $node )

Convenience method for activating an (outgoing) node.

Parameters

Name	Type	Description
`$execution`	ezcWorkflowExecution
`$node`	ezcWorkflowNode

addInNode

ezcWorkflowNode addInNode( ezcWorkflowNode $node )

Adds a node to the incoming nodes of this node.

Automatically adds $node to the workflow and adds this node as an out node of $node.

Parameters

Name	Type	Description
`$node`	ezcWorkflowNode	The node that is to be added as incoming node.

Throws

Class	Description
`ezcWorkflowInvalidWorkflowException`	if the operation violates the constraints of the nodes involved.

addOutNode

ezcWorkflowNode addOutNode( ezcWorkflowNode $node )

Adds a node to the outgoing nodes of this node.

Automatically adds $node to the workflow and adds this node as an in node of $node.

Parameters

Name	Type	Description
`$node`	ezcWorkflowNode	The node that is to be added as outgoing node.

Throws

Class	Description
`ezcWorkflowInvalidWorkflowException`	if the operation violates the constraints of the nodes involved.

getConfiguration

mixed getConfiguration( )

Returns the configuration of this node.

getInNodes

ezcWorkflowNode[] getInNodes( )

Returns the incoming nodes of this node.

getOutNodes

ezcWorkflowNode[] getOutNodes( )

Returns the outgoing nodes of this node.

removeInNode

boolean removeInNode( ezcWorkflowNode $node )

Removes a node from the incoming nodes of this node.

Automatically removes $this as an out node of $node.

Parameters

Name	Type	Description
`$node`	ezcWorkflowNode	The node that is to be removed as incoming node.

Throws

Class	Description
`ezcWorkflowInvalidWorkflowException`	if the operation violates the constraints of the nodes involved.

removeOutNode

boolean removeOutNode( ezcWorkflowNode $node )

Removes a node from the outgoing nodes of this node.

Automatically removes $this as an in node of $node.

Parameters

Name	Type	Description
`$node`	ezcWorkflowNode	The node that is to be removed as outgoing node.

Throws

Class	Description
`ezcWorkflowInvalidWorkflowException`	if the operation violates the constraints of the nodes involved.

verify

void verify( )

Checks this node's constraints.

The constraints checked are the minimum in nodes maximum in nodes, minimum out nodes and maximum out nodes.

Throws

Class	Description
`ezcWorkflowInvalidWorkflowException`	if the constraints of this node are not met.

Redefined in descendants as

Method	Description
`ezcWorkflowNodeConditionalBranch::verify()`	Checks this node's constraints.

Last updated: Mon, 21 Dec 2009

eZ Components

User menu

Path

eZ Components trunk

Getting Started

Components

Workflow: ezcWorkflowNode

Class: ezcWorkflowNode

Implemented Interfaces

Descendents

Constants

Member Variables

Method Summary

Methods

__construct

Parameters

Redefined in descendants as

accept

Parameters

activateNode

Parameters

addInNode

Parameters

Throws

addOutNode

Parameters

Throws

getConfiguration

getInNodes

getOutNodes

removeInNode

Parameters

Throws

removeOutNode

Parameters

Throws

verify

Throws

Redefined in descendants as