Package de.xima.fc.interfaces.workflow.analysis

Interface ICreateFlowGraphContext<TElement extends IWorkflowNodeTypeProviding>

Type Parameters:

TElement - The type of the node elements on which the analysis is performed. This type may be different depending on whether the analysis is performed on the backend data model WorkflowNode or the frontend view model.

public interface ICreateFlowGraphContext<TElement extends IWorkflowNodeTypeProviding>

Context provided to the node handlers during a call to createFlowGraph. Handlers may use this context to recursively analyze their children as well.

Since:

7.0.0

Author:

XIMA MEDIA GmbH

Method Summary

Modifier and Type	Method	Description
void	connect(com.google.common.collect.ImmutableSet<NodeKey> from, NodeKey to)	For each source in from, adds an edge (source, to) to the flow graph.
void	connect(com.google.common.collect.ImmutableSet<NodeKey> from, TElement toParent, int toChildIndex)	Finds the child at the given index in the toParent and adds an edge (from, child) to the flow graph.
void	connect(NodeKey from, NodeKey to)	Adds an edge (from, to) to the flow graph.
void	connect(TElement from, TElement to)	Adds an edge (from, to) to the flow graph.
void	connectParentToChild(TElement parent, int childIndex)	Finds the child at the given index in the toParent and adds an edge (parent, child) to the flow graph.
IFlowGraphEndPoints	createFlowGraph(TElement node)	Creates the flow graph for the given node and return its end points.
IFlowGraphEndPoints	createFlowGraphForChild(TElement parent, int childIndex)	Creates the flow graph for the given node and return its end points.
NodeKey	createNodeKey(TElement element)	Creates the element key that needs to be entered in the list of potentially reachable nodes.
IFlowGraphEndPoints	endPoints(com.google.common.collect.ImmutableSet<NodeKey> normalEndPoints, com.google.common.collect.ImmutableSet<NodeKey> throwingEndPoints)
IFlowGraphEndPoints	endPointsAlwaysReturning()
IFlowGraphEndPoints	endPointsNeverNormal(com.google.common.collect.ImmutableSet<NodeKey> throwingEndPoints)
IFlowGraphEndPoints	endPointsNeverThrowing(com.google.common.collect.ImmutableSet<NodeKey> normalEndPoints)
IFlowGraphEndPoints	endPointsSameNormalAndThrowing(com.google.common.collect.ImmutableSet<NodeKey> endPoints)
boolean	isHasChild(TElement node, int childIndex)
com.google.common.collect.ImmutableSet<NodeKey>	union(com.google.common.collect.ImmutableSet<NodeKey>... sets)	Helper method that computes the union of all given sets.
com.google.common.collect.ImmutableSet<NodeKey>	union(com.google.common.collect.ImmutableSet<NodeKey> set1, com.google.common.collect.ImmutableSet<NodeKey> set2)	Helper method that computes the union of all given sets.

Method Detail

connect

void connect(com.google.common.collect.ImmutableSet<NodeKey> from,
             NodeKey to)

For each source in from, adds an edge (source, to) to the flow graph.

Parameters:

from - Source node.

to - Target node.

connect

void connect(com.google.common.collect.ImmutableSet<NodeKey> from,
             TElement toParent,
             int toChildIndex)

Finds the child at the given index in the toParent and adds an edge (from, child) to the flow graph.

Parameters:

from - Source node.

toParent - Parent with the target node.

toChildIndex - Index of the target node in the parent node.

connect

void connect(NodeKey from,
             NodeKey to)

Adds an edge (from, to) to the flow graph.

Parameters:

from - Source node.

to - Target node.

connect

void connect(TElement from,
             TElement to)

Adds an edge (from, to) to the flow graph.

Parameters:

from - Source node.

to - Target node.

connectParentToChild

void connectParentToChild(TElement parent,
                          int childIndex)

Finds the child at the given index in the toParent and adds an edge (parent, child) to the flow graph.

Parameters:

parent -

childIndex -

createFlowGraph

IFlowGraphEndPoints createFlowGraph(TElement node)
                             throws WorkflowAnalysisException

Creates the flow graph for the given node and return its end points.

Parameters:

node - Child to analyze.

Returns:

The end points of the given node.

Throws:

WorkflowAnalysisException - When the analysis could not be completed, usually because a child threw an exception.

createFlowGraphForChild

IFlowGraphEndPoints createFlowGraphForChild(TElement parent,
                                            int childIndex)
                                     throws WorkflowAnalysisException

Creates the flow graph for the given node and return its end points.

Parameters:

parent - Parent node with a child to analyze.

childIndex - Index of the child to analyze.

Returns:

The end points of the given node.

Throws:

WorkflowAnalysisException - When the analysis could not be completed, usually because a child threw an exception.

createNodeKey

NodeKey createNodeKey(TElement element)

Creates the element key that needs to be entered in the list of potentially reachable nodes.

Parameters:

element - Element for which to create the key.

Returns:

The key of the element.

endPoints

IFlowGraphEndPoints endPoints(com.google.common.collect.ImmutableSet<NodeKey> normalEndPoints,
                              com.google.common.collect.ImmutableSet<NodeKey> throwingEndPoints)

Parameters:

normalEndPoints - The value for IFlowGraphEndPoints.getNormalEndPoints()

throwingEndPoints - The value for IFlowGraphEndPoints.getThrowingEndPoints().

Returns:

A new POJO with the given data.

endPointsAlwaysReturning

IFlowGraphEndPoints endPointsAlwaysReturning()

Returns:

A new POJO with no normal and no throwing end points.

endPointsNeverNormal

IFlowGraphEndPoints endPointsNeverNormal(com.google.common.collect.ImmutableSet<NodeKey> throwingEndPoints)

Parameters:

throwingEndPoints - The value for both IFlowGraphEndPoints.getThrowingEndPoints().

Returns:

A new POJO with the given data and IFlowGraphEndPoints.getNormalEndPoints() set to an empty set.

endPointsNeverThrowing

IFlowGraphEndPoints endPointsNeverThrowing(com.google.common.collect.ImmutableSet<NodeKey> normalEndPoints)

Parameters:

normalEndPoints - The value for both IFlowGraphEndPoints.getNormalEndPoints().

Returns:

A new POJO with the given data and IFlowGraphEndPoints.getThrowingEndPoints() set to an empty set.

endPointsSameNormalAndThrowing

IFlowGraphEndPoints endPointsSameNormalAndThrowing(com.google.common.collect.ImmutableSet<NodeKey> endPoints)

Parameters:

endPoints - The value for both IFlowGraphEndPoints.getNormalEndPoints() and IFlowGraphEndPoints.getThrowingEndPoints().

Returns:

A new POJO with the given data.

isHasChild

boolean isHasChild(TElement node,
                   int childIndex)

Parameters:

node - Node to check.

childIndex - Index to check.

Returns:

true when the node has a child at the give index, false otherwise.

union

com.google.common.collect.ImmutableSet<NodeKey> union(com.google.common.collect.ImmutableSet<NodeKey>... sets)

Helper method that computes the union of all given sets.

Parameters:

sets - More sets to unite.

Returns:

A set representing the union of all input sets.

union

com.google.common.collect.ImmutableSet<NodeKey> union(com.google.common.collect.ImmutableSet<NodeKey> set1,
                                                      com.google.common.collect.ImmutableSet<NodeKey> set2)

Helper method that computes the union of all given sets.

Parameters:

set1 - One set to combined.

set2 - Another set to combined.

Returns:

A set representing the union of all input sets.