Package org.evolvis.tartools.backgroundjobs

Interface BackgroundJobInfo

All Known Subinterfaces:

BackgroundJobStatus<T>

All Known Implementing Classes:

BackgroundJobStatusDecorator

public interface BackgroundJobInfo

Information about a scheduled BackgroundJob.

This interface provides runtime information on a scheduled Job.

Author:

lukas

Nested Class Summary

Nested Classes

Modifier and Type	Interface	Description
static class	BackgroundJobInfo.State

Method Summary

Modifier and Type	Method	Description
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.

Method Detail

getState

BackgroundJobInfo.State getState()

Returns:

the current BackgroundJobInfo.State of the job.

getWorkDone

int getWorkDone()

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 getWorkTotal() to put this into relation.

Returns:

number of completed "units of work"

getWorkTotal

int getWorkTotal()

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.

Returns:

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

getId

String getId()

The unique identifier assigned to this job by the scheduler.

Returns:

the id.

getDescription

String getDescription()

The human-readable description for this job.

Returns:

the description.

getJobClass

Class<?> getJobClass()

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

Returns:

the implementation of the job.

getLastModified

long getLastModified()

Returns:

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

getStartTime

long getStartTime()