org.xwiki.job

Class AbstractJobStatus<R extends Request>

java.lang.Object

org.xwiki.job.AbstractJobStatus<R>

Type Parameters:

R - the request type associated to the job

All Implemented Interfaces:

JobStatus

Direct Known Subclasses:

DefaultJobStatus

public abstract class AbstractJobStatus<R extends Request>
extends Object
implements JobStatus

Base implementation of JobStatus.

Since:

7.4M1

Version:

$Id: 9c294e62171e8510a95c912cef5ae5dcd379c664 $

Nested Class Summary

Nested classes/interfaces inherited from interface org.xwiki.job.event.status.JobStatus

JobStatus.State

Constructor Summary

Constructors

Constructor and Description
AbstractJobStatus(R request, JobStatus parentJobStatus, org.xwiki.observation.ObservationManager observationManager, LoggerManager loggerManager)

Method Summary

Methods

Modifier and Type	Method and Description
void	answered() Indicate that the question has been answered.
void	ask(Object question)
Date	getEndDate()
LogQueue	getLog()
List<LogEvent>	getLog(LogLevel level) Deprecated.
JobStatus	getParentJobStatus()
JobProgress	getProgress()
Object	getQuestion()
R	getRequest()
Date	getStartDate()
JobStatus.State	getState()
boolean	isIsolated()
boolean	isSubJob()
void	setEndDate(Date endDate)
void	setIsolated(boolean isolated)
void	setStartDate(Date startDate)
void	setState(JobStatus.State state)
void	startListening() Start listening to events.
void	stopListening() Stop listening to events.

Methods inherited from class java.lang.Object

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

Constructor Detail

AbstractJobStatus

public AbstractJobStatus(R request,
                 JobStatus parentJobStatus,
                 org.xwiki.observation.ObservationManager observationManager,
                 LoggerManager loggerManager)

Parameters:

request - the request provided when started the job

parentJobStatus - the status of the parent job (i.e. the status of the job that started this one); pass null if this job hasn't been started by another job (i.e. if this is not a sub-job)

observationManager - the observation manager component

loggerManager - the logger manager component

Method Detail

startListening

public void startListening()

Start listening to events.

stopListening

public void stopListening()

Stop listening to events.

getState

public JobStatus.State getState()

Specified by:

getState in interface JobStatus

Returns:

the general state of the job

setState

public void setState(JobStatus.State state)

Parameters:

state - the general state of the job

getRequest

public R getRequest()

Specified by:

getRequest in interface JobStatus

Returns:

the job request provided when starting it

getLog

public LogQueue getLog()

Specified by:

getLog in interface JobStatus

Returns:

the log sent during job execution

getProgress

public JobProgress getProgress()

Specified by:

getProgress in interface JobStatus

Returns:

progress information about the job (percent, etc.)

ask

public void ask(Object question)
         throws InterruptedException

Specified by:

ask in interface JobStatus

Parameters:

question - the question to ask as a Java bean

Throws:

InterruptedException - if the current thread is interrupted

getQuestion

public Object getQuestion()

Specified by:

getQuestion in interface JobStatus

Returns:

the question

answered

public void answered()

Description copied from interface: JobStatus

Indicate that the question has been answered.

Specified by:

answered in interface JobStatus

getStartDate

public Date getStartDate()

Specified by:

getStartDate in interface JobStatus

Returns:

the date and time when the job has been started

setStartDate

public void setStartDate(Date startDate)

Parameters:

startDate - the date and time when the job has been started

getEndDate

public Date getEndDate()

Specified by:

getEndDate in interface JobStatus

Returns:

the date and time when the job finished

setEndDate

public void setEndDate(Date endDate)

Parameters:

endDate - the date and time when the job finished

isSubJob

public boolean isSubJob()

Returns:

true if the job is part of another job execution

isIsolated

public boolean isIsolated()

Returns:

true if the job log should be grabbed

setIsolated

public void setIsolated(boolean isolated)

Parameters:

isolated - true if the job log should be grabbed

getParentJobStatus

public JobStatus getParentJobStatus()

Returns:

the status of the parent job, i.e. the status of the job that started this one; returns null if the job has no parent, i.e. if the job hasn't been started by another job

getLog

@Deprecated
public List<LogEvent> getLog(LogLevel level)

Deprecated.

Specified by:

getLog in interface JobStatus

Parameters:

level - the level of the log

Returns:

the log sent with the provided level