org.evolvis.tartools.backgroundjobs

Class BackgroundJobStatusDecorator<T>

java.lang.Object

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

All Implemented Interfaces:

BackgroundJobInfo, BackgroundJobStatus<T>

public abstract class BackgroundJobStatusDecorator<T>
extends Object
implements BackgroundJobStatus<T>

Nested Class Summary

Nested classes/interfaces inherited from interface org.evolvis.tartools.backgroundjobs.BackgroundJobInfo

BackgroundJobInfo.State

Field Summary

Fields

Modifier and Type	Field and Description
protected BackgroundJobStatus<T>	delegatee

Constructor Summary

Constructors

Constructor and Description
BackgroundJobStatusDecorator(BackgroundJobStatus<T> delegatee)

Method Summary

Modifier and Type	Method and Description
void	abort() Request the cancellation of a job.
void	addJobListener(JobListener l)
protected BackgroundJobStatus<T>	getDelegatee()
String	getDescription() The human-readable description for this job.
String	getId() The unique identifier assigned to this job by the scheduler.
Class<?>	getJobClass() The class implementing the actual work.
long	getLastModified()
long	getStartTime()
BackgroundJobInfo.State	getState()
int	getWorkDone() Get the amount of work that is already done.
int	getWorkTotal() Get the total amount of work.
void	join(long timeout) Join the thread executing the job.
void	removeJobListener(JobListener l)
T	result() Obtain the result produced by the job, waiting for its completion if necessary.

Methods inherited from class java.lang.Object

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

Field Detail

delegatee

protected final BackgroundJobStatus<T> delegatee

Constructor Detail

BackgroundJobStatusDecorator

public BackgroundJobStatusDecorator(BackgroundJobStatus<T> delegatee)

Method Detail

getState

public BackgroundJobInfo.State getState()

Specified by:

getState in interface BackgroundJobInfo

Returns:

the current BackgroundJobInfo.State of the job.

getWorkDone

public int getWorkDone()

Description copied from interface: BackgroundJobInfo

Get the amount of work that is already done. Returns the number of "units of work" that have been completed by the job so far. Use BackgroundJobInfo.getWorkTotal() to put this into relation.

Specified by:

getWorkDone in interface BackgroundJobInfo

Returns:

number of completed "units of work"

getWorkTotal

public int getWorkTotal()

Description copied from interface: BackgroundJobInfo

Get the total amount of work.

Returns the total number of "units of work" comprising this job, including the part that is already done. BackgroundJob -implementations will typically provide a value in an early stage of processing. They are however not obliged to do so, so the expected total amount may not be known yet. In particular, BackgroundJob are allowed to to update this value if new information about the total amount of work to be done becomes available.

Specified by:

getWorkTotal in interface BackgroundJobInfo

Returns:

the expected total amount of work in "units of work".

abort

public void abort()

Description copied from interface: BackgroundJobStatus

Request the cancellation of a job.

This will try to interrupt the thread executing the job and it will make BackgroundJobMonitor.isAborting() return false. Nevertheless it may take some time until the job actually stops whatever it is doing.

Specified by:

abort in interface BackgroundJobStatus<T>

getId

public String getId()

Description copied from interface: BackgroundJobInfo

The unique identifier assigned to this job by the scheduler.

Specified by:

getId in interface BackgroundJobInfo

Returns:

the id.

join

public void join(long timeout)
          throws InterruptedException

Description copied from interface: BackgroundJobStatus

Join the thread executing the job.

Specified by:

join in interface BackgroundJobStatus<T>

Parameters:

timeout - the maximum number of milliseconds to wait for the job.

Throws:

InterruptedException

getDescription

public String getDescription()

Description copied from interface: BackgroundJobInfo

The human-readable description for this job.

Specified by:

getDescription in interface BackgroundJobInfo

Returns:

the description.

result

public T result()
         throws InterruptedException,
                ExecutionException

Description copied from interface: BackgroundJobStatus

Obtain the result produced by the job, waiting for its completion if necessary.

Specified by:

result in interface BackgroundJobStatus<T>

Returns:

the result.

Throws:

InterruptedException

ExecutionException

getJobClass

public Class<?> getJobClass()

Description copied from interface: BackgroundJobInfo

The class implementing the actual work. This will typically be an Implementation of BackgroundJob, but Schedulers may choose a different approach.

Specified by:

getJobClass in interface BackgroundJobInfo

Returns:

the implementation of the job.

addJobListener

public void addJobListener(JobListener l)

Specified by:

addJobListener in interface BackgroundJobStatus<T>

removeJobListener

public void removeJobListener(JobListener l)

Specified by:

removeJobListener in interface BackgroundJobStatus<T>

getLastModified

public long getLastModified()

Specified by:

getLastModified in interface BackgroundJobInfo

Returns:

the last time at which progress info or state where updated. (Milliseconds since epoch.)

getStartTime

public long getStartTime()

Specified by:

getStartTime in interface BackgroundJobInfo

getDelegatee

protected BackgroundJobStatus<T> getDelegatee()