Package org.bonitasoft.engine.core.process.instance.api.event

Interface EventInstanceService

All Known Implementing Classes:

EventInstanceServiceImpl

public interface EventInstanceService

Author:

Elias Ricken de Medeiros, Matthieu Chaffotte, Celine Souchet

Method Summary

Modifier and Type	Method	Description
void	createEventInstance(SEventInstance eventInstance)
void	createMessageInstance(SMessageInstance messageInstance)
void	createTimerEventTriggerInstance(STimerEventTriggerInstance sEventTriggerInstance)	STimerEventTriggerInstance is used to keep track of currently running timers using ProcessRuntimeAPI.searchTimerEventTriggerInstances(long, SearchOptions)
void	createWaitingEvent(SWaitingEvent waitingEvent)
void	deleteEventTriggerInstance(STimerEventTriggerInstance eventTriggerInstance)
void	deleteEventTriggerInstanceOfFlowNode(long flowNodeInstanceId)
Integer	deleteMessageAndDataInstanceOlderThanCreationDate(long creationDate, QueryOptions queryOptions)
void	deleteMessageInstance(SMessageInstance messageInstance)
void	deleteWaitingEvent(SWaitingEvent waitingEvent)
void	deleteWaitingEvents(SFlowNodeInstance flowNodeInstance)
void	deleteWaitingEvents(SProcessInstance processInstance)
List<SBoundaryEventInstance>	getActivityBoundaryEventInstances(long activityInstanceId, int fromIndex, int maxResults)
SWaitingErrorEvent	getBoundaryWaitingErrorEvent(long relatedActivityInstanceId, String errorCode)
List<SEventInstance>	getEventInstances(long rootContainerId, int fromIndex, int maxResults, String fieldName, OrderByType orderByType)
<T extends STimerEventTriggerInstance> T	getEventTriggerInstance(Class<T> entityClass, long eventTriggerInstanceId)
List<SMessageEventCouple>	getMessageEventCouples(int fromIndex, int maxResults)
SMessageInstance	getMessageInstance(long messageInstanceId)
List<Long>	getMessageInstanceIdOlderThanCreationDate(long creationDate, QueryOptions queryOptions)
long	getNumberOfTimerEventTriggerInstances(long processInstanceId, QueryOptions searchOptions)	Get the number of STimerEventTriggerInstance on the specific process instance & corresponding to the criteria
long	getNumberOfWaitingEvents(Class<? extends SWaitingEvent> entityClass, QueryOptions countOptions)
List<SWaitingEvent>	getStartWaitingEventsOfProcessDefinition(long processDefinitionId)
Optional<STimerEventTriggerInstance>	getTimerEventTriggerInstanceOfFlowNode(long flowNodeInstanceId)
SWaitingMessageEvent	getWaitingMessage(long waitingMessageId)
SWaitingSignalEvent	getWaitingSignalEvent(long id)
List<SWaitingSignalEvent>	getWaitingSignalEvents(String signalName, int fromIndex, int maxResults)
int	resetInProgressWaitingEvents()	Resets all Waiting Message Events marked as 'in progress", so that they are eligible to match Message Instances again.
int	resetProgressMessageInstances()	Resets all Message Instances marked as handled, so that they are eligible to match Waiting Events again.
List<STimerEventTriggerInstance>	searchTimerEventTriggerInstances(long processInstanceId, QueryOptions searchOptions)	Search the list of STimerEventTriggerInstance on the specific process instance & corresponding to the criteria
<T extends SWaitingEvent> List<T>	searchWaitingEvents(Class<T> entityClass, QueryOptions searchOptions)
void	updateEventTriggerInstance(STimerEventTriggerInstance sTimerEventTriggerInstance, EntityUpdateDescriptor descriptor)	Update an event trigger instance.
void	updateMessageInstance(SMessageInstance messageInstance, EntityUpdateDescriptor descriptor)
void	updateWaitingMessage(SWaitingMessageEvent waitingMessageEvent, EntityUpdateDescriptor descriptor)

Method Details

createEventInstance

void createEventInstance(SEventInstance eventInstance)
                  throws SEventInstanceCreationException

Throws:

SEventInstanceCreationException

createTimerEventTriggerInstance

void createTimerEventTriggerInstance(STimerEventTriggerInstance sEventTriggerInstance)
                              throws SEventTriggerInstanceCreationException

STimerEventTriggerInstance is used to keep track of currently running timers using ProcessRuntimeAPI.searchTimerEventTriggerInstances(long, SearchOptions)

Throws:

SEventTriggerInstanceCreationException

createMessageInstance

void createMessageInstance(SMessageInstance messageInstance)
                    throws SMessageInstanceCreationException

Throws:

SMessageInstanceCreationException

createWaitingEvent

void createWaitingEvent(SWaitingEvent waitingEvent)
                 throws SWaitingEventCreationException

Throws:

SWaitingEventCreationException

getBoundaryWaitingErrorEvent

SWaitingErrorEvent getBoundaryWaitingErrorEvent(long relatedActivityInstanceId,
 String errorCode)
                                         throws SWaitingEventReadException

Throws:

SWaitingEventReadException

getEventInstances

List<SEventInstance> getEventInstances(long rootContainerId,
 int fromIndex,
 int maxResults,
 String fieldName,
 OrderByType orderByType)
                                throws SEventInstanceReadException

Throws:

SEventInstanceReadException

deleteWaitingEvents

void deleteWaitingEvents(SProcessInstance processInstance)
                  throws SWaitingEventModificationException,
SEventTriggerInstanceReadException

Throws:

SWaitingEventModificationException

SEventTriggerInstanceReadException

getActivityBoundaryEventInstances

List<SBoundaryEventInstance> getActivityBoundaryEventInstances(long activityInstanceId,
 int fromIndex,
 int maxResults)
                                                        throws SEventInstanceReadException

Parameters:

activityInstanceId -

fromIndex -

maxResults -

Returns:

List of SBoundaryEventInstance, ordered by identifier ascending

Throws:

SEventInstanceReadException

Since:

6.2

getEventTriggerInstance

<T extends STimerEventTriggerInstance> T getEventTriggerInstance(Class<T> entityClass,
 long eventTriggerInstanceId)
                                                          throws SEventTriggerInstanceReadException

Parameters:

entityClass -

eventTriggerInstanceId -

Returns:

Throws:

SEventTriggerInstanceReadException

Since:

6.4.0

deleteMessageInstance

void deleteMessageInstance(SMessageInstance messageInstance)
                    throws SMessageModificationException

Throws:

SMessageModificationException

deleteWaitingEvent

void deleteWaitingEvent(SWaitingEvent waitingEvent)
                 throws SWaitingEventModificationException

Throws:

SWaitingEventModificationException

getWaitingSignalEvents

List<SWaitingSignalEvent> getWaitingSignalEvents(String signalName,
 int fromIndex,
 int maxResults)
                                          throws SEventTriggerInstanceReadException

Parameters:

signalName -

fromIndex -

maxResults -

Returns:

Throws:

SEventTriggerInstanceReadException

Since:

6.3

getStartWaitingEventsOfProcessDefinition

List<SWaitingEvent> getStartWaitingEventsOfProcessDefinition(long processDefinitionId)
                                                      throws SBonitaReadException

Parameters:

processDefinitionId -

Returns:

Throws:

SBonitaReadException

Since:

6.3

getMessageEventCouples

List<SMessageEventCouple> getMessageEventCouples(int fromIndex,
 int maxResults)
                                          throws SEventTriggerInstanceReadException

Throws:

SEventTriggerInstanceReadException

getWaitingMessage

SWaitingMessageEvent getWaitingMessage(long waitingMessageId)
                                throws SWaitingEventReadException

Throws:

SWaitingEventReadException

getMessageInstance

SMessageInstance getMessageInstance(long messageInstanceId)
                             throws SMessageInstanceReadException

Throws:

SMessageInstanceReadException

updateWaitingMessage

void updateWaitingMessage(SWaitingMessageEvent waitingMessageEvent,
 EntityUpdateDescriptor descriptor)
                   throws SWaitingEventModificationException

Throws:

SWaitingEventModificationException

updateMessageInstance

void updateMessageInstance(SMessageInstance messageInstance,
 EntityUpdateDescriptor descriptor)
                    throws SMessageModificationException

Throws:

SMessageModificationException

searchWaitingEvents

<T extends SWaitingEvent> List<T> searchWaitingEvents(Class<T> entityClass,
 QueryOptions searchOptions)
                                               throws SBonitaReadException

Throws:

SBonitaReadException

getNumberOfWaitingEvents

long getNumberOfWaitingEvents(Class<? extends SWaitingEvent> entityClass,
 QueryOptions countOptions)
                       throws SBonitaReadException

Throws:

SBonitaReadException

getTimerEventTriggerInstanceOfFlowNode

Optional<STimerEventTriggerInstance> getTimerEventTriggerInstanceOfFlowNode(long flowNodeInstanceId)
                                                                     throws SBonitaReadException

Parameters:

flowNodeInstanceId - the flow node instance id

Returns:

the timer event trigger instance of this flow node if there is one

Throws:

SBonitaReadException

getWaitingSignalEvent

SWaitingSignalEvent getWaitingSignalEvent(long id)
                                   throws SEventTriggerInstanceReadException,
SEventTriggerInstanceNotFoundException

Throws:

SEventTriggerInstanceReadException

SEventTriggerInstanceNotFoundException

deleteEventTriggerInstance

void deleteEventTriggerInstance(STimerEventTriggerInstance eventTriggerInstance)
                         throws SEventTriggerInstanceDeletionException

Parameters:

eventTriggerInstance -

Throws:

SEventTriggerInstanceDeletionException

Since:

6.1

deleteEventTriggerInstanceOfFlowNode

void deleteEventTriggerInstanceOfFlowNode(long flowNodeInstanceId)
                                   throws SBonitaReadException,
SEventTriggerInstanceDeletionException

Throws:

SBonitaReadException

SEventTriggerInstanceDeletionException

deleteWaitingEvents

void deleteWaitingEvents(SFlowNodeInstance flowNodeInstance)
                  throws SWaitingEventModificationException,
SEventTriggerInstanceReadException

Parameters:

flowNodeInstance -

Throws:

SWaitingEventModificationException

SEventTriggerInstanceReadException

Since:

6.1

resetProgressMessageInstances

int resetProgressMessageInstances()
                           throws SMessageModificationException

Resets all Message Instances marked as handled, so that they are eligible to match Waiting Events again.

Throws:

SMessageModificationException - if an error occurs when resetting the 'handled' flag.

resetInProgressWaitingEvents

int resetInProgressWaitingEvents()
                          throws SWaitingEventModificationException

Resets all Waiting Message Events marked as 'in progress", so that they are eligible to match Message Instances again.

Returns:

the number of waiting events reset.

Throws:

SWaitingEventModificationException - if an error occurs when resetting the 'progress' flag.

getNumberOfTimerEventTriggerInstances

long getNumberOfTimerEventTriggerInstances(long processInstanceId,
 QueryOptions searchOptions)
                                    throws SBonitaReadException

Get the number of STimerEventTriggerInstance on the specific process instance & corresponding to the criteria

Parameters:

processInstanceId - The identifier of the process instance

searchOptions - Criteria of the search

Returns:

The number of STimerEventTriggerInstance on the specific process instance & corresponding to the criteria

Throws:

SBonitaReadException

Since:

6.4.0

searchTimerEventTriggerInstances

List<STimerEventTriggerInstance> searchTimerEventTriggerInstances(long processInstanceId,
 QueryOptions searchOptions)
                                                           throws SBonitaReadException

Search the list of STimerEventTriggerInstance on the specific process instance & corresponding to the criteria

Parameters:

processInstanceId - The identifier of the process instance

searchOptions - Criteria of the search

Returns:

The list of STimerEventTriggerInstance on the specific process instance & corresponding to the criteria

Throws:

SBonitaReadException

Since:

6.4.0

deleteMessageAndDataInstanceOlderThanCreationDate

Integer deleteMessageAndDataInstanceOlderThanCreationDate(long creationDate,
 QueryOptions queryOptions)
                                                   throws SMessageModificationException

Throws:

SMessageModificationException

getMessageInstanceIdOlderThanCreationDate

List<Long> getMessageInstanceIdOlderThanCreationDate(long creationDate,
 QueryOptions queryOptions)
                                              throws SEventTriggerInstanceReadException,
SMessageInstanceReadException

Throws:

SEventTriggerInstanceReadException

SMessageInstanceReadException

updateEventTriggerInstance

void updateEventTriggerInstance(STimerEventTriggerInstance sTimerEventTriggerInstance,
 EntityUpdateDescriptor descriptor)
                         throws SEventTriggerInstanceModificationException

Update an event trigger instance.

Parameters:

sTimerEventTriggerInstance - The event trigger instance to update

descriptor - The fields to update

Throws:

SEventTriggerInstanceModificationException

Since:

6.4.0