com.whitestein.lsps.engine.state.xml

Class Token

java.lang.Object

com.whitestein.lsps.engine.state.xml.Token

All Implemented Interfaces:

Collectible, ElementInProcess, EntityWithId, ModelIdentifiable, ModelInstanceAware

public class Token
extends Object
implements Collectible, ModelInstanceAware, EntityWithId, ModelIdentifiable, ElementInProcess

This entity represents a token in a BPMN process.

Author:

rba

Constructor Summary

Constructors

Constructor and Description
Token(long id, ProcessInstance processInstance, String modelId) Creates new instance.
Token(ProcessInstance processInstance, String modelId) Creates new instance.
Token(SToken source, ProcessInstance processInstance, ModelInstance modelInstance) Creates a new instance from the serialized companion.

Method Summary

Modifier and Type	Method and Description
void	addProcessInstance(ProcessInstance processInstance) Adds a process instance.
void	addTimeout(String flowId, Long timeout) Sets the timeout.
void	cleanTimeouts() Cleans timeouts.
void	collect() Removes itself from the process.
Token	createCopy(ModelInstance targetModelInstance) Creates a copy without references to other objects.
void	finish() Finishes this token execution.
void	finishCopy(com.whitestein.lsps.engine.state.xml.Copiable source, CopyHelper helper) Copy references.
com.whitestein.lsps.model.FlowElement	getElement(ModelProvider modelProvider) Returns the model element.
String	getElementId() Returns the model element id.
String	getElementId(ModelProvider modelProvider) Returns the model element id.
Long	getExecutionId() Returns the execution id.
com.whitestein.lsps.model.Flow	getFlow(ModelProvider modelProvider) Returns the flow.
String	getFlowId() Returns the flow model id.
HandledBoundaryEvent	getHandledBoundaryEvent(String elementId) Returns handled boundary event with id.
List<HandledBoundaryEvent>	getHandledBoundaryEvents() Returns list of already handled boundary events.
long	getId() Returns the id.
ModelInstance	getModelInstance() Returns the model instance.
ProcessInstance	getProcessInstance() Returns the process instance.
int	getProcessInstanceCount() Returns the process instance count.
List<ProcessInstance>	getProcessInstances() Returns all the process instances.
Collection<Collectible>	getReferences() Returns collection of all referenced collectible objects.
Task	getTask() Returns the task.
Date	getTimeout(String flowId) Returns the timeout.add
List<TimeoutFlow>	getTimeouts() Returns an unmodifiable list of timeouts.
void	interrupt(TerminationReason terminationReason) Interrupts this token execution.
boolean	isPersistent() Returns true if this object cannot be collected.
boolean	isStarted() Returns true if interpretation of the corresponding model element is started by the engine.
void	move(String elementId) Move the token to the new element.
void	move(String elementId, String flowId) Move the token to the new element by the flow.
void	rebind(ModelInstance modelInstance) Re-bind to the provided model instance.
void	removeAllProcessInstances() Removes all process instances.
void	removeProcessInstance(ProcessInstance processInstance) addXmlEntity Removes a process instance.
void	setExecutionId(Long executionId) Sets the execution id.
void	setTask(Task task) Sets the task.
void	start() Starts this token execution.
SToken	toSerializable(SModelInstance smi, MarshallerConfig config) Creates a serializable object.

Methods inherited from class java.lang.Object

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

Constructor Detail

Token

public Token(ProcessInstance processInstance,
             String modelId)

Creates new instance.

Parameters:

processInstance -

modelId -

Throws:

NullPointerException - if processInstance is null

Token

public Token(long id,
             ProcessInstance processInstance,
             String modelId)

Creates new instance.

Parameters:

id -

processInstance -

modelId -

Throws:

NullPointerException - if processInstance is null

Token

public Token(SToken source,
             ProcessInstance processInstance,
             ModelInstance modelInstance)

Creates a new instance from the serialized companion.

Parameters:

source -

processInstance -

modelInstance -

Method Detail

toSerializable

public SToken toSerializable(SModelInstance smi,
                             MarshallerConfig config)

Creates a serializable object.

Parameters:

smi -

config -

Returns:

the created serializable object

getId

public long getId()

Description copied from interface: EntityWithId

Returns the id.

Specified by:

getId in interface EntityWithId

Returns:

the id

getElementId

public String getElementId()

Returns the model element id.

Returns:

the model element id

getElementId

public String getElementId(ModelProvider modelProvider)

Description copied from interface: ModelIdentifiable

Returns the model element id.

Specified by:

getElementId in interface ModelIdentifiable

Returns:

the model element id

getElement

public com.whitestein.lsps.model.FlowElement getElement(ModelProvider modelProvider)

Description copied from interface: ModelIdentifiable

Returns the model element.

Specified by:

getElement in interface ModelIdentifiable

Returns:

the model element

getFlowId

public String getFlowId()

Returns the flow model id.

Returns:

the flow model id

getFlow

public com.whitestein.lsps.model.Flow getFlow(ModelProvider modelProvider)

Returns the flow.

Parameters:

modelProvider - the model provider service

Returns:

the flow

getModelInstance

public ModelInstance getModelInstance()

Description copied from interface: ModelInstanceAware

Returns the model instance.

Specified by:

getModelInstance in interface ModelInstanceAware

Returns:

the model instance

rebind

public void rebind(ModelInstance modelInstance)

Description copied from interface: ModelInstanceAware

Re-bind to the provided model instance.

Specified by:

rebind in interface ModelInstanceAware

getProcessInstance

public ProcessInstance getProcessInstance()

Returns the process instance.

Specified by:

getProcessInstance in interface ElementInProcess

Returns:

the process instance

getExecutionId

public Long getExecutionId()

Returns the execution id.

Returns:

the execution id

setExecutionId

public void setExecutionId(Long executionId)

Sets the execution id.

Parameters:

executionId -

getTask

public Task getTask()

Returns the task.

Returns:

the task

setTask

public void setTask(Task task)

Sets the task.

Parameters:

task -

getTimeouts

public List<TimeoutFlow> getTimeouts()

Returns an unmodifiable list of timeouts.

Returns:

a list of timeouts

cleanTimeouts

public void cleanTimeouts()

Cleans timeouts.

getTimeout

public Date getTimeout(String flowId)

Returns the timeout.add

Parameters:

flowId -

Returns:

the timeout

addTimeout

public void addTimeout(String flowId,
                       Long timeout)

Sets the timeout.

Parameters:

flowId -

timeout -

getProcessInstances

public List<ProcessInstance> getProcessInstances()

Returns all the process instances.

Returns:

all the process instances

getProcessInstanceCount

public int getProcessInstanceCount()

Returns the process instance count.

Returns:

the process instance count

addProcessInstance

public void addProcessInstance(ProcessInstance processInstance)

Adds a process instance.

Parameters:

processInstance -

removeProcessInstance

public void removeProcessInstance(ProcessInstance processInstance)

addXmlEntity Removes a process instance.

Parameters:

processInstance -

removeAllProcessInstances

public void removeAllProcessInstances()

Removes all process instances.

isStarted

public boolean isStarted()

Returns true if interpretation of the corresponding model element is started by the engine. Token remains in the process instance during entire execution of the model element. Some model elements can be executed in more steps.

Returns:

true if the token is consumed by the engine.

start

public void start()

Starts this token execution.

finish

public void finish()

Finishes this token execution.

interrupt

public void interrupt(TerminationReason terminationReason)

Interrupts this token execution.

Parameters:

terminationReason -

isPersistent

public boolean isPersistent()

Description copied from interface: Collectible

Returns true if this object cannot be collected.

Specified by:

isPersistent in interface Collectible

Returns:

collected

getReferences

public Collection<Collectible> getReferences()

Description copied from interface: Collectible

Returns collection of all referenced collectible objects.

Specified by:

getReferences in interface Collectible

Returns:

collection of all referenced collectible objects

collect

public void collect()

Description copied from interface: Collectible

Removes itself from the process. This method is called only when the element is not persistence and is not referenced directly or indirectly from any other persistence element.

Specified by:

collect in interface Collectible

move

public void move(String elementId,
                 String flowId)

Move the token to the new element by the flow.

The movement of the token cause the following events to be fired in this order:

• TokenBeforeMovedChange
• TokenMovementChange
• TokenAfterMovedChange

The first two events are fired before the state of the token is changed. The last event is fired after the token was moved to the next element.

Parameters:

elementId - the target element ID

flowId - the flow ID

move

public void move(String elementId)

Move the token to the new element.

Parameters:

elementId -

getHandledBoundaryEvents

public List<HandledBoundaryEvent> getHandledBoundaryEvents()

Returns list of already handled boundary events.

Returns:

list of already handled boundary events

getHandledBoundaryEvent

public HandledBoundaryEvent getHandledBoundaryEvent(String elementId)

Returns handled boundary event with id.

Parameters:

elementId -

Returns:

handled boundary event with id

createCopy

public Token createCopy(ModelInstance targetModelInstance)

Creates a copy without references to other objects.

Returns:

creates a copy

finishCopy

public void finishCopy(com.whitestein.lsps.engine.state.xml.Copiable source,
                       CopyHelper helper)

Copy references.