org.bonitasoft.engine.core.process.instance.impl

Class FlowNodeInstancesServiceImpl

java.lang.Object

org.bonitasoft.engine.core.process.instance.impl.FlowNodeInstancesServiceImpl

All Implemented Interfaces:

FlowNodeInstanceService

Direct Known Subclasses:

ActivityInstanceServiceImpl

public abstract class FlowNodeInstancesServiceImpl
extends java.lang.Object
implements FlowNodeInstanceService

Author:

Elias Ricken de Medeiros, Frederic Bouquet, Celine Souchet

Field Summary

Fields inherited from interface org.bonitasoft.engine.core.process.instance.api.FlowNodeInstanceService

ACTIVITY_INSTANCE_TOKEN_COUNT, ACTIVITYINSTANCE_DISPLAY_DESCRIPTION, ACTIVITYINSTANCE_DISPLAY_NAME, ACTIVITYINSTANCE_STATE, EXECUTED_BY_MODIFIED, EXECUTED_BY_SUBSTITUTE_MODIFIED, EXPECTED_END_DATE_MODIFIED, FLOWNODE_INSTANCE, LOOPINSTANCE_LOOPMAX_MODIFIED, MULTIINSTANCE_LOOPCARDINALITY_MODIFIED, MULTIINSTANCE_NUMBEROFINSTANCE_MODIFIED, STATE_CATEGORY

Constructor Summary

Constructors

Constructor and Description
FlowNodeInstancesServiceImpl(Recorder recorder, PersistenceService persistenceService, EventService eventService, TechnicalLoggerService logger, ArchiveService archiveService)

Method Summary

Modifier and Type	Method and Description
void	deleteArchivedFlowNodeInstances(java.util.List<java.lang.Long> sourceObjectIds)
void	deleteFlowNodeInstance(SFlowNodeInstance sFlowNodeInstance)
SAFlowNodeInstance	getArchivedFlowNodeInstance(long archivedFlowNodeInstanceId)
java.util.List<SAFlowNodeInstance>	getArchivedFlowNodeInstances(long rootContainerId, int fromIndex, int maxResults)
ArchiveService	getArchiveService()
protected EventService	getEventService()
SFlowNodeInstance	getFlowNodeInstance(long flowNodeInstanceId)
java.util.List<java.lang.Long>	getFlowNodeInstanceIdsToRestart(QueryOptions queryOptions) retrieve ids of elements that need to be restarted Called on start node to set the flag to tell the engine to restart these flow nodes Should not be called when the engine is started!
java.util.List<SFlowNodeInstance>	getFlowNodeInstancesOfActivity(long parentActivityInstanceId, int fromIndex, int maxResults) get the flow node instances directly contained in the given activity instance
java.util.List<SFlowNodeInstance>	getFlowNodeInstancesOfProcess(long parentProcessInstanceId, int fromIndex, int maxResults) get the flow node instances directly contained in the given process instance
<T extends SAFlowNodeInstance> T	getLastArchivedFlowNodeInstance(java.lang.Class<T> entityClass, long sourceObjectFlowNodeInstanceId)
protected TechnicalLoggerService	getLogger()
long	getNumberOfArchivedFlowNodeInstances(java.lang.Class<? extends SAFlowNodeInstance> entityClass, QueryOptions countOptions) Retrieve the total number of the archived flow nodes matching the given search criteria.
long	getNumberOfArchivedFlowNodeInstancesSupervisedBy(long supervisorId, java.lang.Class<? extends SAFlowNodeInstance> entityClass, QueryOptions queryOptions) Retrieve the total number of the archived flow nodes matching the given search criteria, for a specific supervisor.
java.util.List<SFlowNodeInstanceStateCounter>	getNumberOfArchivedFlownodesInAllStates(long parentProcessInstanceId) Counts the number of archived flownode instances in a specific state.
long	getNumberOfFlowNodeInstances(java.lang.Class<? extends SFlowNodeInstance> entityClass, QueryOptions countOptions)
long	getNumberOfFlowNodeInstancesSupervisedBy(java.lang.Long supervisorId, java.lang.Class<? extends SFlowNodeInstance> entityClass, QueryOptions queryOptions)
int	getNumberOfFlowNodes(long parentProcessInstanceId) get the number of flow node is this root container
java.util.List<SFlowNodeInstanceStateCounter>	getNumberOfFlownodesInAllStates(long parentProcessInstanceId) Counts the number of flownode instances in all states.
protected PersistenceService	getPersistenceService()
protected Recorder	getRecorder()
java.util.Set<java.lang.Long>	getSourceObjectIdsOfArchivedFlowNodeInstances(java.util.List<java.lang.Long> sourceProcessInstanceIds) get all flow nodes contained in the list of root source process instance ids
protected <T> java.util.List<T>	getUnmodifiableList(java.util.List<T> selectList)
<T extends SAFlowNodeInstance> java.util.List<T>	searchArchivedFlowNodeInstances(java.lang.Class<T> entityClass, QueryOptions searchOptions) Retrieve the total number of the archived flow nodes matching the given search criteria.
<T extends SAFlowNodeInstance> java.util.List<T>	searchArchivedFlowNodeInstancesSupervisedBy(long supervisorId, java.lang.Class<T> entityClass, QueryOptions queryOptions) Retrieve the total number of the archived flow nodes matching the given search criteria, for a specific supervisor.
<T extends SFlowNodeInstance> java.util.List<T>	searchFlowNodeInstances(java.lang.Class<T> entityClass, QueryOptions searchOptions)
<T extends SFlowNodeInstance> java.util.List<T>	searchFlowNodeInstancesSupervisedBy(java.lang.Long supervisorId, java.lang.Class<T> entityClass, QueryOptions queryOptions)
void	setExecutedBy(SFlowNodeInstance flowNodeInstance, long userId) Set execute by for the specific flow node instance
void	setExecutedBySubstitute(SFlowNodeInstance flowNodeInstance, long executerSubstituteId) Set execute by delegate for the specific flow node instance
void	setExecuting(SFlowNodeInstance flowNodeInstance)
void	setExpectedEndDate(SFlowNodeInstance flowNodeInstance, java.lang.Long dueDate)
void	setState(SFlowNodeInstance flowNodeInstance, FlowNodeState state)
void	setStateCategory(SFlowNodeInstance flowElementInstance, SStateCategory stateCategory)
void	setTaskPriority(SFlowNodeInstance flowNodeInstance, STaskPriority priority)
void	updateDisplayDescription(SFlowNodeInstance flowNodeInstance, java.lang.String displayDescription)
void	updateDisplayName(SFlowNodeInstance flowNodeInstance, java.lang.String displayName)
protected void	updateFlowNode(SFlowNodeInstance flowNodeInstance, java.lang.String eventName, EntityUpdateDescriptor descriptor)

Methods inherited from class java.lang.Object

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

Constructor Detail

FlowNodeInstancesServiceImpl

public FlowNodeInstancesServiceImpl(Recorder recorder,
                                    PersistenceService persistenceService,
                                    EventService eventService,
                                    TechnicalLoggerService logger,
                                    ArchiveService archiveService)

Method Detail

getArchiveService

public ArchiveService getArchiveService()

setState

public void setState(SFlowNodeInstance flowNodeInstance,
                     FlowNodeState state)
              throws SFlowNodeModificationException

Specified by:

setState in interface FlowNodeInstanceService

Throws:

SFlowNodeModificationException

setExecuting

public void setExecuting(SFlowNodeInstance flowNodeInstance)
                  throws SFlowNodeModificationException

Specified by:

setExecuting in interface FlowNodeInstanceService

Throws:

SFlowNodeModificationException

updateDisplayName

public void updateDisplayName(SFlowNodeInstance flowNodeInstance,
                              java.lang.String displayName)
                       throws SFlowNodeModificationException

Specified by:

updateDisplayName in interface FlowNodeInstanceService

Throws:

SFlowNodeModificationException

updateDisplayDescription

public void updateDisplayDescription(SFlowNodeInstance flowNodeInstance,
                                     java.lang.String displayDescription)
                              throws SFlowNodeModificationException

Specified by:

updateDisplayDescription in interface FlowNodeInstanceService

Throws:

SFlowNodeModificationException

setTaskPriority

public void setTaskPriority(SFlowNodeInstance flowNodeInstance,
                            STaskPriority priority)
                     throws SFlowNodeModificationException

Specified by:

setTaskPriority in interface FlowNodeInstanceService

Throws:

SFlowNodeModificationException

getFlowNodeInstance

public SFlowNodeInstance getFlowNodeInstance(long flowNodeInstanceId)
                                      throws SFlowNodeNotFoundException,
                                             SFlowNodeReadException

Specified by:

getFlowNodeInstance in interface FlowNodeInstanceService

Returns:

Throws:

SFlowNodeNotFoundException

SFlowNodeReadException

getFlowNodeInstancesOfProcess

public java.util.List<SFlowNodeInstance> getFlowNodeInstancesOfProcess(long parentProcessInstanceId,
                                                                       int fromIndex,
                                                                       int maxResults)
                                                                throws SBonitaReadException

Description copied from interface: FlowNodeInstanceService

get the flow node instances directly contained in the given process instance

Specified by:

getFlowNodeInstancesOfProcess in interface FlowNodeInstanceService

Parameters:

parentProcessInstanceId - the parent process isntance

Returns:

Throws:

SBonitaReadException

getFlowNodeInstancesOfActivity

public java.util.List<SFlowNodeInstance> getFlowNodeInstancesOfActivity(long parentActivityInstanceId,
                                                                        int fromIndex,
                                                                        int maxResults)
                                                                 throws SBonitaReadException

Description copied from interface: FlowNodeInstanceService

get the flow node instances directly contained in the given activity instance

Specified by:

getFlowNodeInstancesOfActivity in interface FlowNodeInstanceService

Parameters:

parentActivityInstanceId - the parent process instance

Returns:

Throws:

SBonitaReadException

getArchivedFlowNodeInstances

public java.util.List<SAFlowNodeInstance> getArchivedFlowNodeInstances(long rootContainerId,
                                                                       int fromIndex,
                                                                       int maxResults)
                                                                throws SFlowNodeReadException

Specified by:

getArchivedFlowNodeInstances in interface FlowNodeInstanceService

Returns:

Throws:

SFlowNodeReadException

getSourceObjectIdsOfArchivedFlowNodeInstances

public java.util.Set<java.lang.Long> getSourceObjectIdsOfArchivedFlowNodeInstances(java.util.List<java.lang.Long> sourceProcessInstanceIds)
                                                                            throws SBonitaReadException

Description copied from interface: FlowNodeInstanceService

get all flow nodes contained in the list of root source process instance ids

Specified by:

getSourceObjectIdsOfArchivedFlowNodeInstances in interface FlowNodeInstanceService

Parameters:

sourceProcessInstanceIds - root source process instance ids

Returns:

list of root source process instance ids

Throws:

SBonitaReadException

deleteArchivedFlowNodeInstances

public void deleteArchivedFlowNodeInstances(java.util.List<java.lang.Long> sourceObjectIds)
                                     throws SBonitaException

Specified by:

deleteArchivedFlowNodeInstances in interface FlowNodeInstanceService

Throws:

SBonitaException

getArchivedFlowNodeInstance

public SAFlowNodeInstance getArchivedFlowNodeInstance(long archivedFlowNodeInstanceId)
                                               throws SFlowNodeReadException,
                                                      SFlowNodeNotFoundException

Specified by:

getArchivedFlowNodeInstance in interface FlowNodeInstanceService

Returns:

Throws:

SFlowNodeReadException

SFlowNodeNotFoundException

getLastArchivedFlowNodeInstance

public <T extends SAFlowNodeInstance> T getLastArchivedFlowNodeInstance(java.lang.Class<T> entityClass,
                                                                        long sourceObjectFlowNodeInstanceId)
                                                                 throws SBonitaReadException

Specified by:

getLastArchivedFlowNodeInstance in interface FlowNodeInstanceService

sourceObjectFlowNodeInstanceId - The source identifier of the flow node instance

Returns:

The last archived flow node

Throws:

SBonitaReadException

setStateCategory

public void setStateCategory(SFlowNodeInstance flowElementInstance,
                             SStateCategory stateCategory)
                      throws SFlowNodeModificationException

Specified by:

setStateCategory in interface FlowNodeInstanceService

Throws:

SFlowNodeModificationException

setExecutedBy

public void setExecutedBy(SFlowNodeInstance flowNodeInstance,
                          long userId)
                   throws SFlowNodeModificationException

Description copied from interface: FlowNodeInstanceService

Set execute by for the specific flow node instance

Specified by:

setExecutedBy in interface FlowNodeInstanceService

Parameters:

flowNodeInstance - the flowNodeInstance will be updated

userId - value for executedBy

Throws:

SFlowNodeModificationException

setExecutedBySubstitute

public void setExecutedBySubstitute(SFlowNodeInstance flowNodeInstance,
                                    long executerSubstituteId)
                             throws SFlowNodeModificationException

Description copied from interface: FlowNodeInstanceService

Set execute by delegate for the specific flow node instance

Specified by:

setExecutedBySubstitute in interface FlowNodeInstanceService

Parameters:

flowNodeInstance - the flowNodeInstance will be updated

executerSubstituteId - value for executedBySubstitute

Throws:

SFlowNodeModificationException

setExpectedEndDate

public void setExpectedEndDate(SFlowNodeInstance flowNodeInstance,
                               java.lang.Long dueDate)
                        throws SFlowNodeModificationException

Specified by:

setExpectedEndDate in interface FlowNodeInstanceService

Throws:

SFlowNodeModificationException

updateFlowNode

protected void updateFlowNode(SFlowNodeInstance flowNodeInstance,
                              java.lang.String eventName,
                              EntityUpdateDescriptor descriptor)
                       throws SFlowNodeModificationException

Throws:

SFlowNodeModificationException

getUnmodifiableList

protected <T> java.util.List<T> getUnmodifiableList(java.util.List<T> selectList)

getNumberOfFlowNodeInstances

public long getNumberOfFlowNodeInstances(java.lang.Class<? extends SFlowNodeInstance> entityClass,
                                         QueryOptions countOptions)
                                  throws SBonitaReadException

Specified by:

getNumberOfFlowNodeInstances in interface FlowNodeInstanceService

Returns:

Throws:

SBonitaReadException

searchFlowNodeInstances

public <T extends SFlowNodeInstance> java.util.List<T> searchFlowNodeInstances(java.lang.Class<T> entityClass,
                                                                               QueryOptions searchOptions)
                                                                        throws SBonitaReadException

Specified by:

searchFlowNodeInstances in interface FlowNodeInstanceService

Returns:

Throws:

SBonitaReadException

getNumberOfFlowNodeInstancesSupervisedBy

public long getNumberOfFlowNodeInstancesSupervisedBy(java.lang.Long supervisorId,
                                                     java.lang.Class<? extends SFlowNodeInstance> entityClass,
                                                     QueryOptions queryOptions)
                                              throws SBonitaReadException

Specified by:

getNumberOfFlowNodeInstancesSupervisedBy in interface FlowNodeInstanceService

Returns:

Throws:

SBonitaReadException

searchFlowNodeInstancesSupervisedBy

public <T extends SFlowNodeInstance> java.util.List<T> searchFlowNodeInstancesSupervisedBy(java.lang.Long supervisorId,
                                                                                           java.lang.Class<T> entityClass,
                                                                                           QueryOptions queryOptions)
                                                                                    throws SBonitaReadException

Specified by:

searchFlowNodeInstancesSupervisedBy in interface FlowNodeInstanceService

Returns:

Throws:

SBonitaReadException

getNumberOfFlownodesInAllStates

public java.util.List<SFlowNodeInstanceStateCounter> getNumberOfFlownodesInAllStates(long parentProcessInstanceId)
                                                                              throws SBonitaReadException

Description copied from interface: FlowNodeInstanceService

Counts the number of flownode instances in all states. Only considers flownodes direcly contained in given process instance, not flownodes in sub-process instances. Results are counted per flownode name and per state.

Specified by:

getNumberOfFlownodesInAllStates in interface FlowNodeInstanceService

Parameters:

parentProcessInstanceId - the ID of the process instance to search flownodes for.

Returns:

a map of <flownodename, number of rows with that name>. If no results, returns an empty Map.

Throws:

SBonitaReadException - if a read exception occurs.

getNumberOfArchivedFlownodesInAllStates

public java.util.List<SFlowNodeInstanceStateCounter> getNumberOfArchivedFlownodesInAllStates(long parentProcessInstanceId)
                                                                                      throws SBonitaReadException

Description copied from interface: FlowNodeInstanceService

Counts the number of archived flownode instances in a specific state. Only considers archived flownodes direcly contained in given process instance, not flownodes in sub-process instances. Results are counted per flownode name and per state.

Specified by:

getNumberOfArchivedFlownodesInAllStates in interface FlowNodeInstanceService

Parameters:

parentProcessInstanceId - the ID of the process instance to search flownodes for. This is the ID of the process instance before it was archived (corresponding to the sourceObjectId in the archives)

Returns:

a map of <flownodename, number of rows with that name>. If no results, returns an empty Map.

Throws:

SBonitaReadException - if a read exception occurs.

getNumberOfArchivedFlowNodeInstances

public long getNumberOfArchivedFlowNodeInstances(java.lang.Class<? extends SAFlowNodeInstance> entityClass,
                                                 QueryOptions countOptions)
                                          throws SBonitaReadException

Description copied from interface: FlowNodeInstanceService

Retrieve the total number of the archived flow nodes matching the given search criteria.

Specified by:

getNumberOfArchivedFlowNodeInstances in interface FlowNodeInstanceService

Parameters:

entityClass - The type of the archived flow node to search for

countOptions - The search options to filter the results

Returns:

The number found, 0 if none matching search criteria

Throws:

SBonitaReadException

searchArchivedFlowNodeInstances

public <T extends SAFlowNodeInstance> java.util.List<T> searchArchivedFlowNodeInstances(java.lang.Class<T> entityClass,
                                                                                        QueryOptions searchOptions)
                                                                                 throws SBonitaReadException

Description copied from interface: FlowNodeInstanceService

Retrieve the total number of the archived flow nodes matching the given search criteria.

Specified by:

searchArchivedFlowNodeInstances in interface FlowNodeInstanceService

Parameters:

entityClass - The type of the archived flow node to search for

searchOptions - The search options to filter the results

Returns:

The list of paginated results, according to the QueryOptions search criteria

Throws:

SBonitaReadException

getNumberOfArchivedFlowNodeInstancesSupervisedBy

public long getNumberOfArchivedFlowNodeInstancesSupervisedBy(long supervisorId,
                                                             java.lang.Class<? extends SAFlowNodeInstance> entityClass,
                                                             QueryOptions queryOptions)
                                                      throws SBonitaReadException

Description copied from interface: FlowNodeInstanceService

Retrieve the total number of the archived flow nodes matching the given search criteria, for a specific supervisor.

Specified by:

getNumberOfArchivedFlowNodeInstancesSupervisedBy in interface FlowNodeInstanceService

Parameters:

supervisorId - The identifier of the supervisor

entityClass - The type of the archived flow node to search for

queryOptions - The search options to filter the results

Returns:

The number found, 0 if no matching search criteria

Throws:

SBonitaReadException

searchArchivedFlowNodeInstancesSupervisedBy

public <T extends SAFlowNodeInstance> java.util.List<T> searchArchivedFlowNodeInstancesSupervisedBy(long supervisorId,
                                                                                                    java.lang.Class<T> entityClass,
                                                                                                    QueryOptions queryOptions)
                                                                                             throws SBonitaReadException

Description copied from interface: FlowNodeInstanceService

Retrieve the total number of the archived flow nodes matching the given search criteria, for a specific supervisor.

Specified by:

searchArchivedFlowNodeInstancesSupervisedBy in interface FlowNodeInstanceService

Parameters:

supervisorId - The identifier of the supervisor

entityClass - The type of the archived flow node to search for

queryOptions - The search options to filter the results

Returns:

The list of paginated results, according to the QueryOptions search criteria

Throws:

SBonitaReadException

getEventService

protected EventService getEventService()

getRecorder

protected Recorder getRecorder()

getPersistenceService

protected PersistenceService getPersistenceService()

getLogger

protected TechnicalLoggerService getLogger()

deleteFlowNodeInstance

public void deleteFlowNodeInstance(SFlowNodeInstance sFlowNodeInstance)
                            throws SFlowNodeDeletionException

Specified by:

deleteFlowNodeInstance in interface FlowNodeInstanceService

Throws:

SFlowNodeDeletionException

getFlowNodeInstanceIdsToRestart

public java.util.List<java.lang.Long> getFlowNodeInstanceIdsToRestart(QueryOptions queryOptions)
                                                               throws SBonitaReadException

Description copied from interface: FlowNodeInstanceService

retrieve ids of elements that need to be restarted Called on start node to set the flag to tell the engine to restart these flow nodes Should not be called when the engine is started!

Specified by:

getFlowNodeInstanceIdsToRestart in interface FlowNodeInstanceService

Returns:

Throws:

SBonitaReadException

getNumberOfFlowNodes

public int getNumberOfFlowNodes(long parentProcessInstanceId)
                         throws SBonitaReadException

Description copied from interface: FlowNodeInstanceService

get the number of flow node is this root container

Specified by:

getNumberOfFlowNodes in interface FlowNodeInstanceService

Returns:

the number of flow node

Throws:

SBonitaReadException