org.bonitasoft.engine.scheduler.impl

Class SchedulerServiceImpl

java.lang.Object

org.bonitasoft.engine.scheduler.impl.SchedulerServiceImpl

All Implemented Interfaces:

org.bonitasoft.engine.commons.LifecycleService, org.bonitasoft.engine.commons.PlatformLifecycleService, SchedulerService

public class SchedulerServiceImpl
extends Object
implements SchedulerService

Author:

Matthieu Chaffotte, Baptiste Mesta, Elias Ricken de Medeiros, Yanyan Liu, Celine Souchet

Field Summary

Fields inherited from interface org.bonitasoft.engine.scheduler.SchedulerService

JOB_DESCRIPTOR, JOB_FAILED, JOB_PARAMETER, SCHEDULER_STARTED, SCHEDULER_STOPPED

Constructor Summary

Constructors

Constructor and Description
SchedulerServiceImpl(SchedulerExecutor schedulerExecutor, JobService jobService, TechnicalLoggerService logger, EventService eventService, TransactionService transactionService, SessionAccessor sessionAccessor, org.bonitasoft.engine.service.ServicesResolver servicesResolver, PersistenceService persistenceService) Create a new instance of scheduler service.
SchedulerServiceImpl(SchedulerExecutor schedulerExecutor, JobService jobService, TechnicalLoggerService logger, EventService eventService, TransactionService transactionService, SessionAccessor sessionAccessor, org.bonitasoft.engine.service.ServicesResolver servicesResolver, PersistenceService persistenceService, int batchSize)

Method Summary

Modifier and Type	Method and Description
void	addJobListener(List<AbstractBonitaPlatformJobListener> jobListeners) Add the given AbstractBonitaPlatformJobListeners to the Scheduler, and register it to receive events for all Jobs.
void	addJobListener(List<AbstractBonitaTenantJobListener> jobListeners, String groupName) Add the given AbstractBonitaTenantJobListeners to the Scheduler, and register it to receive events for Jobs that are matched by the group name.
boolean	delete(String jobName) Deletes a job according to its name.
void	deleteJobs() Deletes all jobs.
void	executeAgain(long jobDescriptorId)
void	executeAgain(long jobDescriptorId, List<SJobParameter> parameters) Schedules a job.
void	executeNow(SJobDescriptor jobDescriptor, List<SJobParameter> parameters) execute a job.
List<String>	getAllJobs() Get all jobs on all tenants \/!\Must be replaced by a platform scheduler/!\
List<String>	getJobs() Get all jobs on the current tenant
StatelessJob	getPersistedJob(JobIdentifier jobIdentifier) get the persisted job from the database It opens a transaction!
void	initializeScheduler() Initialize the scheduler if this method has not be previously called (after shutdown); otherwise, do nothing.
boolean	isExistingJob(String jobName) Check if a job exists.
boolean	isStarted() Checks whether the service is started.
boolean	isStillScheduled(SJobDescriptor jobDescriptor)
boolean	isStopped() Checks whether the service is shutdown.
void	pause()
void	pauseJobs(long tenantId) Pause all jobs running on the tenant
void	rescheduleErroneousTriggers()
Date	rescheduleJob(String triggerName, String groupName, Date triggerStartTime) Remove (delete) the Trigger with the given key, and store the new given one - which must be associated with the same job (the new trigger must have the job name & group specified) - however, the new trigger need not have the same name as the old trigger.
void	resume()
void	resumeJobs(long tenantId) Resume all jobs paused on the tenant
void	schedule(SJobDescriptor jobDescriptor, List<SJobParameter> parameters, Trigger trigger) Schedules a job.
void	schedule(SJobDescriptor jobDescriptor, Trigger trigger) Schedules a job.
void	start() Note that once a scheduler is shutdown, it cannot be restarted without being re-instantiated.
void	stop() Note that once a scheduler is shutdown, it cannot be restarted without being re-instantiated.

Methods inherited from class java.lang.Object

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

Constructor Detail

SchedulerServiceImpl

public SchedulerServiceImpl(SchedulerExecutor schedulerExecutor,
                            JobService jobService,
                            TechnicalLoggerService logger,
                            EventService eventService,
                            TransactionService transactionService,
                            SessionAccessor sessionAccessor,
                            org.bonitasoft.engine.service.ServicesResolver servicesResolver,
                            PersistenceService persistenceService)

Create a new instance of scheduler service.

SchedulerServiceImpl

public SchedulerServiceImpl(SchedulerExecutor schedulerExecutor,
                            JobService jobService,
                            TechnicalLoggerService logger,
                            EventService eventService,
                            TransactionService transactionService,
                            SessionAccessor sessionAccessor,
                            org.bonitasoft.engine.service.ServicesResolver servicesResolver,
                            PersistenceService persistenceService,
                            int batchSize)

Method Detail

schedule

public void schedule(SJobDescriptor jobDescriptor,
                     Trigger trigger)
              throws SSchedulerException

Description copied from interface: SchedulerService

Schedules a job.

Specified by:

schedule in interface SchedulerService

Throws:

SSchedulerException - if an exception occurs.

schedule

public void schedule(SJobDescriptor jobDescriptor,
                     List<SJobParameter> parameters,
                     Trigger trigger)
              throws SSchedulerException

Description copied from interface: SchedulerService

Schedules a job.

Specified by:

schedule in interface SchedulerService

Throws:

SSchedulerException - if an exception occurs.

executeAgain

public void executeAgain(long jobDescriptorId)
                  throws SSchedulerException

Specified by:

executeAgain in interface SchedulerService

Throws:

SSchedulerException

executeAgain

public void executeAgain(long jobDescriptorId,
                         List<SJobParameter> parameters)
                  throws SSchedulerException

Description copied from interface: SchedulerService

Schedules a job.

Specified by:

executeAgain in interface SchedulerService

Throws:

SSchedulerException - if an exception occurs.

executeNow

public void executeNow(SJobDescriptor jobDescriptor,
                       List<SJobParameter> parameters)
                throws SSchedulerException

Description copied from interface: SchedulerService

execute a job.

Specified by:

executeNow in interface SchedulerService

Throws:

SSchedulerException - if an exception occurs.

isStarted

public boolean isStarted()
                  throws SSchedulerException

Description copied from interface: SchedulerService

Checks whether the service is started.

Specified by:

isStarted in interface SchedulerService

Returns:

true if the service is started; false otherwise.

Throws:

SSchedulerException - if an exception occurs.

isStopped

public boolean isStopped()
                  throws SSchedulerException

Description copied from interface: SchedulerService

Checks whether the service is shutdown.

Specified by:

isStopped in interface SchedulerService

Returns:

true if the service is shutdown; false otherwise.

Throws:

SSchedulerException

start

public void start()
           throws SSchedulerException,
                  SFireEventException

Description copied from interface: SchedulerService

Note that once a scheduler is shutdown, it cannot be restarted without being re-instantiated.

Specified by:

start in interface org.bonitasoft.engine.commons.LifecycleService

Specified by:

start in interface SchedulerService

Throws:

SSchedulerException

SFireEventException

See Also:

#initializeScheduler()}

stop

public void stop()
          throws SSchedulerException,
                 SFireEventException

Description copied from interface: SchedulerService

Note that once a scheduler is shutdown, it cannot be restarted without being re-instantiated.

Specified by:

stop in interface org.bonitasoft.engine.commons.LifecycleService

Specified by:

stop in interface SchedulerService

Throws:

SSchedulerException

SFireEventException

See Also:

#initializeScheduler()}

pauseJobs

public void pauseJobs(long tenantId)
               throws SSchedulerException

Description copied from interface: SchedulerService

Pause all jobs running on the tenant

Specified by:

pauseJobs in interface SchedulerService

Throws:

SSchedulerException

resumeJobs

public void resumeJobs(long tenantId)
                throws SSchedulerException

Description copied from interface: SchedulerService

Resume all jobs paused on the tenant

Specified by:

resumeJobs in interface SchedulerService

Throws:

SSchedulerException

delete

public boolean delete(String jobName)
               throws SSchedulerException

Description copied from interface: SchedulerService

Deletes a job according to its name.

Specified by:

delete in interface SchedulerService

Parameters:

jobName - the job name

Returns:

true if delete a job, otherwise return false.

Throws:

SSchedulerException - if an exception occurs.

deleteJobs

public void deleteJobs()
                throws SSchedulerException

Description copied from interface: SchedulerService

Deletes all jobs.

Specified by:

deleteJobs in interface SchedulerService

Throws:

SSchedulerException - if an exception occurs.

getJobs

public List<String> getJobs()
                     throws SSchedulerException

Description copied from interface: SchedulerService

Get all jobs on the current tenant

Specified by:

getJobs in interface SchedulerService

Returns:

all jobs on the current tenant

Throws:

SSchedulerException - if an exception occurs.

getAllJobs

public List<String> getAllJobs()
                        throws SSchedulerException

Description copied from interface: SchedulerService

Get all jobs on all tenants \/!\Must be replaced by a platform scheduler/!\

Specified by:

getAllJobs in interface SchedulerService

Returns:

all jobs on the current tenant

Throws:

SSchedulerException - if an exception occurs.

getPersistedJob

public StatelessJob getPersistedJob(JobIdentifier jobIdentifier)
                             throws SSchedulerException

get the persisted job from the database It opens a transaction!

Parameters:

jobIdentifier -

Returns:

the job

Throws:

SSchedulerException

isStillScheduled

public boolean isStillScheduled(SJobDescriptor jobDescriptor)
                         throws SSchedulerException

Specified by:

isStillScheduled in interface SchedulerService

Throws:

SSchedulerException

pause

public void pause()
           throws org.bonitasoft.engine.commons.exceptions.SBonitaException

Specified by:

pause in interface org.bonitasoft.engine.commons.LifecycleService

Throws:

org.bonitasoft.engine.commons.exceptions.SBonitaException

resume

public void resume()
            throws org.bonitasoft.engine.commons.exceptions.SBonitaException

Specified by:

resume in interface org.bonitasoft.engine.commons.LifecycleService

Throws:

org.bonitasoft.engine.commons.exceptions.SBonitaException

rescheduleErroneousTriggers

public void rescheduleErroneousTriggers()
                                 throws SSchedulerException

Specified by:

rescheduleErroneousTriggers in interface SchedulerService

Throws:

SSchedulerException

rescheduleJob

public Date rescheduleJob(String triggerName,
                          String groupName,
                          Date triggerStartTime)
                   throws SSchedulerException

Description copied from interface: SchedulerService

Remove (delete) the Trigger with the given key, and store the new given one - which must be associated with the same job (the new trigger must have the job name & group specified) - however, the new trigger need not have the same name as the old trigger.

Specified by:

rescheduleJob in interface SchedulerService

Parameters:

triggerName - The name of the trigger to replace

groupName - The group name of the trigger to replace

triggerStartTime - The start date of the new trigger

Returns:

null if a Trigger with the given name & group was not found and removed from the store (and the new trigger is therefore not stored), otherwise the first fire time of the newly scheduled trigger is returned.

Throws:

SSchedulerException

addJobListener

public void addJobListener(List<AbstractBonitaTenantJobListener> jobListeners,
                           String groupName)
                    throws SSchedulerException

Description copied from interface: SchedulerService

Add the given AbstractBonitaTenantJobListeners to the Scheduler, and register it to receive events for Jobs that are matched by the group name.

Specified by:

addJobListener in interface SchedulerService

Parameters:

jobListeners - The job listeners to add to the scheduler

groupName - The group name to filter

Throws:

SSchedulerException

addJobListener

public void addJobListener(List<AbstractBonitaPlatformJobListener> jobListeners)
                    throws SSchedulerException

Description copied from interface: SchedulerService

Add the given AbstractBonitaPlatformJobListeners to the Scheduler, and register it to receive events for all Jobs.

Specified by:

addJobListener in interface SchedulerService

Parameters:

jobListeners - The job listeners to add to the scheduler

Throws:

SSchedulerException

initializeScheduler

public void initializeScheduler()
                         throws SSchedulerException

Description copied from interface: SchedulerService

Initialize the scheduler if this method has not be previously called (after shutdown); otherwise, do nothing.

Specified by:

initializeScheduler in interface SchedulerService

Throws:

SSchedulerException

isExistingJob

public boolean isExistingJob(String jobName)
                      throws SSchedulerException

Description copied from interface: SchedulerService

Check if a job exists.

Specified by:

isExistingJob in interface SchedulerService

Parameters:

jobName - The name of the job

Returns:

True if the job exists, else False.

Throws:

SSchedulerException