ee.telekom.workflow.graph.node.gateway

Class OrFork

java.lang.Object

ee.telekom.workflow.graph.node.AbstractNode

ee.telekom.workflow.graph.node.gateway.AbstractGateway

ee.telekom.workflow.graph.node.gateway.AbstractConditionalGateway

ee.telekom.workflow.graph.node.gateway.OrFork

All Implemented Interfaces:

Node

public class OrFork
extends AbstractConditionalGateway

Gateway, that implements the "multiple choice" workflow pattern. That means, based on the incoming token, it generates a new child token per subsequent branch with a runtime condition that evaluates to true and initiates the execution of the child tokens. At the same time, the incoming token remains at this gateway.

The underlying token model implies restraints on the subsequent branches. The following figure illustrates the two types of valid usages.
One valid pattern is the balanced fork-join block which is built of a fork and a join. It synchronises (re-joins) all branches leaving the fork in the paired join. As a join, either an AndJoin or a CancellingDiscriminator may be used but not an XorJoin.
The other valid pattern leaves all subsequent branches independently and never synchronises (re-joins) those back. In that case, every subsequent branch is ended implicitly by a node without outgoing transitions.

         +-(condition1)-[3]--+
 [1]--[OR]                   [AND/CD]--[6]
         +-(condition2)-[4]--+
          
         +-(condition1)-[3]
 [1]--[OR]
         +-(condition2)-[4]
 

Note that while an AndFork executes all subsequent branches, this kind of gateway selects 0 to all subsequent branches depending on the transition conditions. If no subsequent branches is selected, the incoming token is terminated.

Constructor Summary

Constructors

Constructor and Description
OrFork(int id)
OrFork(int id, String name)

Method Summary

Modifier and Type	Method and Description
void	cancel(GraphEngine engine, Token token) Called when the GraphEngine cancels the execution of a Token, that is currently pointing to this node and is in a wait state.
void	execute(GraphEngine engine, Token token) Performs node specific logic.

Methods inherited from class ee.telekom.workflow.graph.node.gateway.AbstractConditionalGateway

addCondition, getConditions

Methods inherited from class ee.telekom.workflow.graph.node.gateway.AbstractGateway

store

Methods inherited from class ee.telekom.workflow.graph.node.AbstractNode

getId, getName, toString

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Constructor Detail

OrFork

public OrFork(int id)

OrFork

public OrFork(int id,
              String name)

Method Detail

execute

public void execute(GraphEngine engine,
                    Token token)

Description copied from interface: Node

Performs node specific logic. Either from the execute method, or later from the outside, the GraphEngineFacade#complete(WorkItem) method must be called to continue executing the GraphInstance.

Parameters:

engine - the GraphEngine which is performing the execution

token - the Token which is currently executing in this node

cancel

public void cancel(GraphEngine engine,
                   Token token)

Description copied from interface: Node

Called when the GraphEngine cancels the execution of a Token, that is currently pointing to this node and is in a wait state.

Parameters:

engine - the GraphEngine which is performing the execution

token - the Token pointing to this node