org.flowable.job.service.impl.asyncexecutor

Class DefaultJobManager

java.lang.Object

org.flowable.job.service.impl.asyncexecutor.DefaultJobManager

All Implemented Interfaces:

JobManager

public class DefaultJobManager
extends Object
implements JobManager

Field Summary

Fields

Modifier and Type	Field and Description
static String	ASYNC_JOB_TYPE
static String	CYCLE_TYPE
protected JobServiceConfiguration	jobServiceConfiguration

Constructor Summary

Constructors

Constructor and Description
DefaultJobManager()
DefaultJobManager(JobServiceConfiguration jobServiceConfiguration)

Method Summary

Modifier and Type	Method and Description
AbstractRuntimeJobEntity	activateSuspendedJob(SuspendedJobEntity job) Transforms a SuspendedJobEntity back to an AbstractRuntimeJobEntity (i.e.
protected HistoryJobEntity	copyHistoryJobInfo(HistoryJobEntity copyToJob, HistoryJobEntity copyFromJob)
protected AbstractRuntimeJobEntity	copyJobInfo(AbstractRuntimeJobEntity copyToJob, AbstractRuntimeJobEntity copyFromJob)
void	createAsyncJob(JobEntity jobEntity, boolean exclusive) Creates an async job so that it can be continued later in a background thread.
protected DeadLetterJobEntity	createDeadLetterJobFromOtherJob(AbstractRuntimeJobEntity otherJob)
protected JobEntity	createExecutableJobFromOtherJob(AbstractRuntimeJobEntity job)
protected SuspendedJobEntity	createSuspendedJobFromOtherJob(AbstractRuntimeJobEntity otherJob)
protected TimerJobEntity	createTimerJobFromOtherJob(AbstractRuntimeJobEntity otherJob)
void	execute(JobInfo job) Execute a job, which means that the logic (async logic, timer that fires, etc) is executed, typically by a background thread of an executor.
protected void	executeHistoryJob(HistoryJobEntity historyJobEntity)
protected void	executeHistoryJobHandler(HistoryJobEntity historyJobEntity)
protected void	executeJobHandler(JobEntity jobEntity)
protected void	executeMessageJob(JobEntity jobEntity)
protected void	executeTimerJob(JobEntity timerEntity)
protected void	fillDefaultAsyncJobInfo(JobEntity jobEntity, boolean exclusive)
protected AsyncExecutor	getAsyncExecutor()
String	getBusinessCalendarName(JobEntity timerEntity, org.flowable.variable.api.delegate.VariableScope variableScope) Get the business calendar name of the job configuration
protected String	getBusinessCalendarName(String calendarName, org.flowable.variable.api.delegate.VariableScope variableScope)
protected CommandContext	getCommandContext()
JobServiceConfiguration	getJobServiceConfiguration()
protected void	hintAsyncExecutor(JobEntity job)
protected void	internalCreateAsyncJob(JobEntity jobEntity, boolean exclusive)
protected void	internalCreateLockedAsyncJob(JobEntity jobEntity, boolean exclusive)
protected boolean	isAsyncExecutorActive()
protected boolean	isValidTime(JobEntity timerEntity, Date newTimerDate, org.flowable.variable.api.delegate.VariableScope variableScope)
JobEntity	moveDeadLetterJobToExecutableJob(DeadLetterJobEntity deadLetterJobEntity, int retries) Transforms a DeadLetterJobEntity to a JobEntity, thus making it executable again.
DeadLetterJobEntity	moveJobToDeadLetterJob(AbstractRuntimeJobEntity job) Transforms an AbstractRuntimeJobEntity to a DeadLetterJobEntity.
SuspendedJobEntity	moveJobToSuspendedJob(AbstractRuntimeJobEntity job) Moves an AbstractRuntimeJobEntity to become a SuspendedJobEntity, such that the AsyncExecutor won't pick it up anymore for execution.
TimerJobEntity	moveJobToTimerJob(AbstractRuntimeJobEntity job) Moves an AbstractRuntimeJobEntity to become a TimerJobEntity.
JobEntity	moveTimerJobToExecutableJob(TimerJobEntity timerJob) Moves a TimerJobEntity to become an async JobEntity.
void	scheduleAsyncJob(JobEntity jobEntity) Schedules and async job.
HistoryJobEntity	scheduleHistoryJob(HistoryJobEntity historyJobEntity) schedules a HistoryJobEntity, meaning it will be scheduled (inserted in the database/put on a queue/...) to be executed at a later point in time.
void	scheduleTimerJob(TimerJobEntity timerJob) Schedules a timer, meaning it will be inserted in the datastore.
void	setJobServiceConfiguration(JobServiceConfiguration jobServiceConfiguration) The ProcessEngineConfiguration instance will be passed when the ProcessEngine is built.
protected void	triggerExecutorIfNeeded(JobEntity jobEntity)
void	unacquire(JobInfo job) Unacquires a job, meaning that this job was previously locked, and it is now freed to be acquired by other executor nodes.
void	unacquireWithDecrementRetries(JobInfo job) Unacquires a job, meaning that this job was previously locked, and it is now freed to be acquired by other executor nodes.

Methods inherited from class java.lang.Object

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

Field Detail

ASYNC_JOB_TYPE

public static final String ASYNC_JOB_TYPE

See Also:

Constant Field Values

CYCLE_TYPE

public static final String CYCLE_TYPE

See Also:

Constant Field Values

jobServiceConfiguration

protected JobServiceConfiguration jobServiceConfiguration

Constructor Detail

DefaultJobManager

public DefaultJobManager()

DefaultJobManager

public DefaultJobManager(JobServiceConfiguration jobServiceConfiguration)

Method Detail

createAsyncJob

public void createAsyncJob(JobEntity jobEntity,
                           boolean exclusive)

Description copied from interface: JobManager

Creates an async job so that it can be continued later in a background thread.

Specified by:

createAsyncJob in interface JobManager

scheduleAsyncJob

public void scheduleAsyncJob(JobEntity jobEntity)

Description copied from interface: JobManager

Schedules and async job. If the AsyncExecutor is running, it can be executed immediately after the transaction. Otherwise it can be picked up by other executors.

Specified by:

scheduleAsyncJob in interface JobManager

triggerExecutorIfNeeded

protected void triggerExecutorIfNeeded(JobEntity jobEntity)

scheduleTimerJob

public void scheduleTimerJob(TimerJobEntity timerJob)

Description copied from interface: JobManager

Schedules a timer, meaning it will be inserted in the datastore.

Specified by:

scheduleTimerJob in interface JobManager

moveTimerJobToExecutableJob

public JobEntity moveTimerJobToExecutableJob(TimerJobEntity timerJob)

Description copied from interface: JobManager

Moves a TimerJobEntity to become an async JobEntity. This happens for example when the due date of a timer is reached, the timer entity then becomes a 'regular' async job that can be picked up by the AsyncExecutor.

Specified by:

moveTimerJobToExecutableJob in interface JobManager

moveJobToTimerJob

public TimerJobEntity moveJobToTimerJob(AbstractRuntimeJobEntity job)

Description copied from interface: JobManager

Moves an AbstractRuntimeJobEntity to become a TimerJobEntity. This happens for example when an async job is executed and fails. It then becomes a timer, as it needs to be retried later.

Specified by:

moveJobToTimerJob in interface JobManager

moveJobToSuspendedJob

public SuspendedJobEntity moveJobToSuspendedJob(AbstractRuntimeJobEntity job)

Description copied from interface: JobManager

Moves an AbstractRuntimeJobEntity to become a SuspendedJobEntity, such that the AsyncExecutor won't pick it up anymore for execution.

Specified by:

moveJobToSuspendedJob in interface JobManager

activateSuspendedJob

public AbstractRuntimeJobEntity activateSuspendedJob(SuspendedJobEntity job)

Description copied from interface: JobManager

Transforms a SuspendedJobEntity back to an AbstractRuntimeJobEntity (i.e. to what it was originally). The job will now again be able to picked up by the AsyncExecutor.

Specified by:

activateSuspendedJob in interface JobManager

moveJobToDeadLetterJob

public DeadLetterJobEntity moveJobToDeadLetterJob(AbstractRuntimeJobEntity job)

Description copied from interface: JobManager

Transforms an AbstractRuntimeJobEntity to a DeadLetterJobEntity. This means that the job has been tried a configurable amount of times, but kept failing.

Specified by:

moveJobToDeadLetterJob in interface JobManager

moveDeadLetterJobToExecutableJob

public JobEntity moveDeadLetterJobToExecutableJob(DeadLetterJobEntity deadLetterJobEntity,
                                                  int retries)

Description copied from interface: JobManager

Transforms a DeadLetterJobEntity to a JobEntity, thus making it executable again. Note that a 'retries' parameter needs to be passed, as the job got into the deadletter table because of it failed and retries became 0.

Specified by:

moveDeadLetterJobToExecutableJob in interface JobManager

execute

public void execute(JobInfo job)

Description copied from interface: JobManager

Execute a job, which means that the logic (async logic, timer that fires, etc) is executed, typically by a background thread of an executor.

Specified by:

execute in interface JobManager

unacquire

public void unacquire(JobInfo job)

Description copied from interface: JobManager

Unacquires a job, meaning that this job was previously locked, and it is now freed to be acquired by other executor nodes.

Specified by:

unacquire in interface JobManager

unacquireWithDecrementRetries

public void unacquireWithDecrementRetries(JobInfo job)

Description copied from interface: JobManager

Unacquires a job, meaning that this job was previously locked, and it is now freed to be acquired by other executor nodes.

Specified by:

unacquireWithDecrementRetries in interface JobManager

executeMessageJob

protected void executeMessageJob(JobEntity jobEntity)

executeHistoryJob

protected void executeHistoryJob(HistoryJobEntity historyJobEntity)

executeTimerJob

protected void executeTimerJob(JobEntity timerEntity)

executeJobHandler

protected void executeJobHandler(JobEntity jobEntity)

executeHistoryJobHandler

protected void executeHistoryJobHandler(HistoryJobEntity historyJobEntity)

isValidTime

protected boolean isValidTime(JobEntity timerEntity,
                              Date newTimerDate,
                              org.flowable.variable.api.delegate.VariableScope variableScope)

hintAsyncExecutor

protected void hintAsyncExecutor(JobEntity job)

getBusinessCalendarName

public String getBusinessCalendarName(JobEntity timerEntity,
                                      org.flowable.variable.api.delegate.VariableScope variableScope)

Description copied from interface: JobManager

Get the business calendar name of the job configuration

Specified by:

getBusinessCalendarName in interface JobManager

getBusinessCalendarName

protected String getBusinessCalendarName(String calendarName,
                                         org.flowable.variable.api.delegate.VariableScope variableScope)

scheduleHistoryJob

public HistoryJobEntity scheduleHistoryJob(HistoryJobEntity historyJobEntity)

Description copied from interface: JobManager

schedules a HistoryJobEntity, meaning it will be scheduled (inserted in the database/put on a queue/...) to be executed at a later point in time.

Specified by:

scheduleHistoryJob in interface JobManager

internalCreateAsyncJob

protected void internalCreateAsyncJob(JobEntity jobEntity,
                                      boolean exclusive)

internalCreateLockedAsyncJob

protected void internalCreateLockedAsyncJob(JobEntity jobEntity,
                                            boolean exclusive)

fillDefaultAsyncJobInfo

protected void fillDefaultAsyncJobInfo(JobEntity jobEntity,
                                       boolean exclusive)

createExecutableJobFromOtherJob

protected JobEntity createExecutableJobFromOtherJob(AbstractRuntimeJobEntity job)

createTimerJobFromOtherJob

protected TimerJobEntity createTimerJobFromOtherJob(AbstractRuntimeJobEntity otherJob)

createSuspendedJobFromOtherJob

protected SuspendedJobEntity createSuspendedJobFromOtherJob(AbstractRuntimeJobEntity otherJob)

createDeadLetterJobFromOtherJob

protected DeadLetterJobEntity createDeadLetterJobFromOtherJob(AbstractRuntimeJobEntity otherJob)

copyJobInfo

protected AbstractRuntimeJobEntity copyJobInfo(AbstractRuntimeJobEntity copyToJob,
                                               AbstractRuntimeJobEntity copyFromJob)

copyHistoryJobInfo

protected HistoryJobEntity copyHistoryJobInfo(HistoryJobEntity copyToJob,
                                              HistoryJobEntity copyFromJob)

getJobServiceConfiguration

public JobServiceConfiguration getJobServiceConfiguration()

setJobServiceConfiguration

public void setJobServiceConfiguration(JobServiceConfiguration jobServiceConfiguration)

Description copied from interface: JobManager

The ProcessEngineConfiguration instance will be passed when the ProcessEngine is built.

Specified by:

setJobServiceConfiguration in interface JobManager

isAsyncExecutorActive

protected boolean isAsyncExecutorActive()

getCommandContext

protected CommandContext getCommandContext()

getAsyncExecutor

protected AsyncExecutor getAsyncExecutor()