org.oddjob.jobs.job

Class StopJob

java.lang.Object

org.oddjob.framework.extend.BaseComponent

org.oddjob.framework.extend.BasePrimary

org.oddjob.framework.extend.SimpleJob

org.oddjob.framework.extend.SerializableJob

org.oddjob.jobs.job.StopJob

All Implemented Interfaces:

java.io.Serializable, java.lang.Runnable, ArooaContextAware, ArooaSessionAware, Forceable, PropertyChangeNotifier, Iconic, LogEnabled, Resettable, Stateful, Stoppable

public class StopJob
extends SerializableJob
implements Stoppable

Description

A job which stops another job.

Normally The stop job will not complete until the job it is stopping is in a stopped state, however if the stop job is attempting tos stop a parent of itself (and therefore itself) then this stop job will detect this and stop. It will therefore complete even if thing it is trying to stop hasn't fully stopped.

Example

Examples elsewhere.

• JMXClientJob has an example where the stop job is used to stop a client once the connection is no longer needed.

See Also:

Serialized Form

Author:

Rob Gordon

Field Summary

Fields

Modifier and Type	Field and Description
static int	RESULT_POLL_TIMEOUT Number of seconds to wait for a stop result.

Fields inherited from class org.oddjob.framework.extend.SimpleJob

stop

Constructor Summary

Constructors

Constructor and Description
StopJob()

Method Summary

Modifier and Type	Method and Description
protected int	execute() Execute this job.
Stoppable	getJob() Get the node to stop.
protected void	onStop() Allow sub classes to do something on stop.
void	setExecutorService(java.util.concurrent.ExecutorService executorService)
void	setJob(Stoppable node) Set the stop node directly.

Methods inherited from class org.oddjob.framework.extend.SimpleJob

fireDestroyedState, force, getStateChanger, hardReset, iconHelper, isStop, onDestroy, onReset, run, sleep, softReset, stateHandler, stop

Methods inherited from class org.oddjob.framework.extend.BasePrimary

configure, getName, logger, logger, loggerName, save, setName, toString

Methods inherited from class org.oddjob.framework.extend.BaseComponent

addIconListener, addPropertyChangeListener, addStateListener, configure, destroy, firePropertyChange, getArooaSession, iconForId, initialise, lastStateEvent, onConfigured, onInitialised, removeIconListener, removePropertyChangeListener, removeStateListener, save, setArooaContext, setArooaSession

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.oddjob.Stoppable

stop

Methods inherited from interface org.oddjob.Stateful

addStateListener, lastStateEvent, removeStateListener

Field Detail

RESULT_POLL_TIMEOUT

public static final int RESULT_POLL_TIMEOUT

Number of seconds to wait for a stop result.

See Also:

Constant Field Values

Constructor Detail

StopJob

public StopJob()

Method Detail

setExecutorService

@Inject
public void setExecutorService(java.util.concurrent.ExecutorService executorService)

setJob

public void setJob(Stoppable node)

Set the stop node directly.

Parameters:

node - The node to stop.

getJob

public Stoppable getJob()

Get the node to stop.

Returns:

The node.

execute

protected int execute()
               throws java.lang.Exception

Description copied from class: SimpleJob

Execute this job.

Specified by:

execute in class SimpleJob

Returns:

0 if the job is complete, anything else otherwise.

Throws:

java.lang.Exception - If the unexpected occurs.

onStop

protected void onStop()
               throws FailedToStopException

Description copied from class: SimpleJob

Allow sub classes to do something on stop.

Overrides:

onStop in class SimpleJob

Throws:

FailedToStopException