Module org.eclipse.jetty.util

Package org.eclipse.jetty.util.component

Class AbstractLifeCycle

java.lang.Object

org.eclipse.jetty.util.component.AbstractLifeCycle

All Implemented Interfaces:

LifeCycle

Direct Known Subclasses:

AbstractLeakPreventer, CompressionPool, ContainerLifeCycle, LeakDetector, PathWatcher, ReservedThreadExecutor, ScheduledExecutorScheduler, SslContextFactory, StopLifeCycle, Sweeper, TimerScheduler

@ManagedObject("Abstract Implementation of LifeCycle")
public abstract class AbstractLifeCycle
extends java.lang.Object
implements LifeCycle

Basic implementation of the life cycle interface for components.

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static class	AbstractLifeCycle.AbstractLifeCycleListener	Deprecated. this class is redundant now that LifeCycle.Listener has default methods.
class	AbstractLifeCycle.StopException	An exception, which if thrown by doStart will immediately stop the component

Nested classes/interfaces inherited from interface org.eclipse.jetty.util.component.LifeCycle

LifeCycle.Listener

Field Summary

Fields

Modifier and Type	Field	Description
static java.lang.String	FAILED
static java.lang.String	STARTED
static java.lang.String	STARTING
static java.lang.String	STOPPED
static java.lang.String	STOPPING

Constructor Summary

Constructors

Constructor	Description
AbstractLifeCycle()

Method Summary

Modifier and Type	Method	Description
boolean	addEventListener(java.util.EventListener listener)
protected void	doStart()	Method to override to start the lifecycle
protected void	doStop()	Method to override to stop the lifecycle
java.util.List<java.util.EventListener>	getEventListeners()
java.lang.String	getState()
static java.lang.String	getState(LifeCycle lc)
boolean	isFailed()
boolean	isRunning()
boolean	isStarted()
boolean	isStarting()
boolean	isStopped()
boolean	isStopping()
boolean	removeEventListener(java.util.EventListener listener)
void	setEventListeners(java.util.Collection<java.util.EventListener> eventListeners)
void	start()	Starts the component.
void	stop()	Stops the component.
java.lang.String	toString()

Methods inherited from class java.lang.Object

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

Field Detail

STOPPED

public static final java.lang.String STOPPED

FAILED

public static final java.lang.String FAILED

STARTING

public static final java.lang.String STARTING

STARTED

public static final java.lang.String STARTED

STOPPING

public static final java.lang.String STOPPING

Constructor Detail

AbstractLifeCycle

public AbstractLifeCycle()

Method Detail

doStart

protected void doStart()
                throws java.lang.Exception

Method to override to start the lifecycle

Throws:

AbstractLifeCycle.StopException - If thrown, the lifecycle will immediately be stopped.

java.lang.Exception - If there was a problem starting. Will cause a transition to FAILED state

doStop

protected void doStop()
               throws java.lang.Exception

Method to override to stop the lifecycle

Throws:

java.lang.Exception - If there was a problem stopping. Will cause a transition to FAILED state

start

public final void start()
                 throws java.lang.Exception

Description copied from interface: LifeCycle

Starts the component.

Specified by:

start in interface LifeCycle

Throws:

java.lang.Exception - If the component fails to start

See Also:

LifeCycle.isStarted(), LifeCycle.stop(), LifeCycle.isFailed()

stop

public final void stop()
                throws java.lang.Exception

Description copied from interface: LifeCycle

Stops the component. The component may wait for current activities to complete normally, but it can be interrupted.

Specified by:

stop in interface LifeCycle

Throws:

java.lang.Exception - If the component fails to stop

See Also:

LifeCycle.isStopped(), LifeCycle.start(), LifeCycle.isFailed()

isRunning

public boolean isRunning()

Specified by:

isRunning in interface LifeCycle

Returns:

true if the component is starting or has been started.

isStarted

public boolean isStarted()

Specified by:

isStarted in interface LifeCycle

Returns:

true if the component has been started.

See Also:

LifeCycle.start(), LifeCycle.isStarting()

isStarting

public boolean isStarting()

Specified by:

isStarting in interface LifeCycle

Returns:

true if the component is starting.

See Also:

LifeCycle.isStarted()

isStopping

public boolean isStopping()

Specified by:

isStopping in interface LifeCycle

Returns:

true if the component is stopping.

See Also:

LifeCycle.isStopped()

isStopped

public boolean isStopped()

Specified by:

isStopped in interface LifeCycle

Returns:

true if the component has been stopped.

See Also:

LifeCycle.stop(), LifeCycle.isStopping()

isFailed

public boolean isFailed()

Specified by:

isFailed in interface LifeCycle

Returns:

true if the component has failed to start or has failed to stop.

getEventListeners

public java.util.List<java.util.EventListener> getEventListeners()

setEventListeners

public void setEventListeners(java.util.Collection<java.util.EventListener> eventListeners)

addEventListener

public boolean addEventListener(java.util.EventListener listener)

Specified by:

addEventListener in interface LifeCycle

removeEventListener

public boolean removeEventListener(java.util.EventListener listener)

Specified by:

removeEventListener in interface LifeCycle

getState

@ManagedAttribute(value="Lifecycle State for this instance",
                  readonly=true)
public java.lang.String getState()

getState

public static java.lang.String getState(LifeCycle lc)

toString

public java.lang.String toString()

Overrides:

toString in class java.lang.Object