Package org.eclipse.jetty.servlet

Class ListenerHolder

java.lang.Object

org.eclipse.jetty.util.component.AbstractLifeCycle

org.eclipse.jetty.servlet.BaseHolder<EventListener>

org.eclipse.jetty.servlet.ListenerHolder

All Implemented Interfaces:

Dumpable, LifeCycle

public class ListenerHolder
extends BaseHolder<EventListener>

ListenerHolder Specialization of BaseHolder for servlet listeners. This allows us to record where the listener originated - web.xml, annotation, api etc.

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static interface	ListenerHolder.WrapFunction	Experimental Wrapper mechanism for Servlet EventListeners.
static class	ListenerHolder.Wrapper

Nested classes/interfaces inherited from class org.eclipse.jetty.util.component.AbstractLifeCycle

AbstractLifeCycle.AbstractLifeCycleListener, AbstractLifeCycle.StopException

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

Dumpable.DumpableContainer

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

LifeCycle.Listener

Field Summary

Fields inherited from class org.eclipse.jetty.util.component.AbstractLifeCycle

FAILED, STARTED, STARTING, STOPPED, STOPPING

Fields inherited from interface org.eclipse.jetty.util.component.Dumpable

KEY

Constructor Summary

Constructors

Constructor	Description
ListenerHolder()
ListenerHolder(Class<? extends EventListener> listenerClass)
ListenerHolder(Source source)

Method Summary

Modifier and Type	Method	Description
protected EventListener	createInstance()
void	doStart()	Method to override to start the lifecycle
void	doStop()	Method to override to stop the lifecycle
EventListener	getListener()
void	setListener(EventListener listener)	Set an explicit instance.
String	toString()

Methods inherited from class org.eclipse.jetty.servlet.BaseHolder

dump, dump, getClassName, getHeldClass, getInstance, getServletContext, getServletHandler, getSource, illegalStateIfContextStarted, initialize, isInstance, setClassName, setHeldClass, setInstance, setServletHandler, unwrap, wrap

Methods inherited from class org.eclipse.jetty.util.component.AbstractLifeCycle

addEventListener, getEventListeners, getState, getState, isFailed, isRunning, isStarted, isStarting, isStopped, isStopping, removeEventListener, setEventListeners, start, stop

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.eclipse.jetty.util.component.Dumpable

dumpSelf

Constructor Details

ListenerHolder

public ListenerHolder()

ListenerHolder

public ListenerHolder(Source source)

ListenerHolder

public ListenerHolder(Class<? extends EventListener> listenerClass)

Method Details

getListener

public EventListener getListener()

setListener

public void setListener(EventListener listener)

Set an explicit instance. In this case, just like ServletHolder and FilterHolder, the listener will not be introspected for annotations like Resource etc.

Parameters:

listener - The listener instance

doStart

public void doStart()
             throws Exception

Description copied from class: AbstractLifeCycle

Method to override to start the lifecycle

Overrides:

doStart in class BaseHolder<EventListener>

Throws:

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

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

createInstance

protected EventListener createInstance()
                                throws Exception

Overrides:

createInstance in class BaseHolder<EventListener>

Throws:

Exception

doStop

public void doStop()
            throws Exception

Description copied from class: AbstractLifeCycle

Method to override to stop the lifecycle

Overrides:

doStop in class BaseHolder<EventListener>

Throws:

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

toString

public String toString()

Overrides:

toString in class AbstractLifeCycle