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

Interface EventInstanceRepository

All Known Implementing Classes:

EventInstanceRepositoryImpl

public interface EventInstanceRepository

Author:

Pascal GARCIA

Field Summary

Fields

Modifier and Type	Field	Description
static final String	EVENT_INSTANCE
static final String	EVENT_TRIGGER_INSTANCE
static final int	IN_REQUEST_SIZE
static final String	MESSAGE_INSTANCE

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	deleteMessageInstance(SMessageInstance messageInstance)
void	deleteMessageInstanceByIds(List<Long> ids)
void	deleteWaitingEvent(SWaitingEvent waitingEvent)
List<SBoundaryEventInstance>	getActivityBoundaryEventInstances(long activityInstanceId, int fromIndex, int maxResults)
List<SWaitingEvent>	getAllWaitingEventsForProcessInstance(long processInstanceId, int fromIndex, int maxResults)	Return waiting events related to the process instance passed as parameter, including the ones at flow node level.
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 queryOptions)	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)	search start waiting events related to a process definition (not its event sub processes)
Optional<STimerEventTriggerInstance>	getTimerEventTriggerInstanceOfFlowNode(long flowNodeInstanceId)
List<SWaitingEvent>	getWaitingEventsForFlowNodeId(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 queryOptions)	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)

Field Details

EVENT_INSTANCE

static final String EVENT_INSTANCE

See Also:

• Constant Field Values

EVENT_TRIGGER_INSTANCE

static final String EVENT_TRIGGER_INSTANCE

See Also:

• Constant Field Values

MESSAGE_INSTANCE

static final String MESSAGE_INSTANCE

See Also:

• Constant Field Values

IN_REQUEST_SIZE

static final int IN_REQUEST_SIZE

See Also:

• Constant Field Values

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

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

search start waiting events related to a process definition (not its event sub processes)

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

deleteMessageInstanceByIds

void deleteMessageInstanceByIds(List<Long> ids)
                         throws SMessageModificationException

Throws:

SMessageModificationException

getMessageInstanceIdOlderThanCreationDate

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

Throws:

SEventTriggerInstanceReadException

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

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 queryOptions)
                                    throws SBonitaReadException

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

Parameters:

processInstanceId - The identifier of the process instance

queryOptions - 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 queryOptions)
                                                           throws SBonitaReadException

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

Parameters:

processInstanceId - The identifier of the process instance

queryOptions - Criteria of the search

Returns:

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

Throws:

SBonitaReadException

Since:

6.4.0

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

getWaitingEventsForFlowNodeId

List<SWaitingEvent> getWaitingEventsForFlowNodeId(long flowNodeInstanceId)
                                           throws SEventTriggerInstanceReadException

Throws:

SEventTriggerInstanceReadException

getAllWaitingEventsForProcessInstance

List<SWaitingEvent> getAllWaitingEventsForProcessInstance(long processInstanceId,
 int fromIndex,
 int maxResults)
                                                   throws SEventTriggerInstanceReadException

Return waiting events related to the process instance passed as parameter, including the ones at flow node level.

Throws:

SEventTriggerInstanceReadException