Package org.evolvis.tartools.backgroundjobs

Class WeightedBackgroundJob<T>

java.lang.Object

org.evolvis.tartools.backgroundjobs.WeightedBackgroundJob<T>

All Implemented Interfaces:

BackgroundJob<T>

public class WeightedBackgroundJob<T>
extends Object
implements BackgroundJob<T>

Constructor Summary

Constructors

Constructor	Description
WeightedBackgroundJob(BackgroundJob<T> decoratedJob, int weight)

Method Summary

Modifier and Type	Method	Description
String	getDescription()	Describe the job.
int	getWeight()
T	work(BackgroundJobMonitor monitor)	Execute the Job.

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.evolvis.tartools.backgroundjobs.BackgroundJob

isCancellationSupported, isVisible

Constructor Detail

WeightedBackgroundJob

public WeightedBackgroundJob(BackgroundJob<T> decoratedJob,
                             int weight)

Method Detail

work

public T work(BackgroundJobMonitor monitor)
       throws Exception

Description copied from interface: BackgroundJob

Execute the Job. This method is typically called by some sort of scheduler. This method should never be called twice on the same instance! While executing, implementations should use the BackgroundJobMonitor to communicate with the scheduler:

• Progress should be reported to the BackgroundJobMonitor through the BackgroundJobMonitor.announceTotal(int), BackgroundJobMonitor.reportProgressAbsolute(int) and BackgroundJobMonitor.reportProgressIncrement(int) methods.
• All logging should use the BackgroundJobMonitor.log(org.evolvis.tartools.backgroundjobs.BackgroundJobMonitor.Severity, Object) Method.
• Long-running operations should periodically poll the state of the BackgroundJobMonitor.isAborting() property, to check whether a cancellation was requested. If this is the case, this method should return as quickly as possible.
• Implementations can obtain a unique identifier for the current execution of this job using the BackgroundJobMonitor.getScheduledJobId() Method.

Specified by:

work in interface BackgroundJob<T>

Parameters:

monitor - The job monitor that should be used to communicate with the scheduler.

Returns:

the result produced by this job. Schedulers should ignore the returned value if the job has been aborted before finishing normally.

Throws:

Exception - The scheduler should be prepared to deal with any kind of exception by marking the job as failed.

getDescription

public String getDescription()

Description copied from interface: BackgroundJob

Describe the job.

Specified by:

getDescription in interface BackgroundJob<T>

Returns:

a human-readable Description of the job.

getWeight

public int getWeight()