Module org.eclipse.jetty.servlet

Package org.eclipse.jetty.servlet

Class BaseHolder<T>

java.lang.Object

org.eclipse.jetty.util.component.AbstractLifeCycle

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

Type Parameters:

T - the type of holder

All Implemented Interfaces:

Dumpable, LifeCycle

Direct Known Subclasses:

Holder, ListenerHolder

public abstract class BaseHolder<T>
extends AbstractLifeCycle
implements Dumpable

AbstractHolder Base class for all servlet-related classes that may be lazily instantiated (eg servlet, filter, listener), and/or require metadata to be held regarding their origin (web.xml, annotation, programmatic api etc).

Nested Class Summary

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.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

Modifier	Constructor	Description
protected	BaseHolder(Source source)

Method Summary

Modifier and Type	Method	Description
protected T	createInstance()
void	doStart()	Method to override to start the lifecycle
void	doStop()	Method to override to stop the lifecycle
java.lang.String	dump()
void	dump(java.lang.Appendable out, java.lang.String indent)	Dump this object (and children) into an Appendable using the provided indent after any new lines.
java.lang.String	getClassName()
java.lang.Class<? extends T>	getHeldClass()
protected T	getInstance()
javax.servlet.ServletContext	getServletContext()
ServletHandler	getServletHandler()
Source	getSource()
protected void	illegalStateIfContextStarted()
void	initialize()	Do any setup necessary after starting
boolean	isInstance()
void	setClassName(java.lang.String className)
void	setHeldClass(java.lang.Class<? extends T> held)
protected void	setInstance(T instance)
void	setServletHandler(ServletHandler servletHandler)

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

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

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 Detail

BaseHolder

protected BaseHolder(Source source)

Method Detail

getSource

public Source getSource()

initialize

public void initialize()
                throws java.lang.Exception

Do any setup necessary after starting

Throws:

java.lang.Exception - if unable to initialize

doStart

public void doStart()
             throws java.lang.Exception

Description copied from class: AbstractLifeCycle

Method to override to start the lifecycle

Overrides:

doStart in class AbstractLifeCycle

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

public void doStop()
            throws java.lang.Exception

Description copied from class: AbstractLifeCycle

Method to override to stop the lifecycle

Overrides:

doStop in class AbstractLifeCycle

Throws:

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

getClassName

@ManagedAttribute(value="Class Name",
                  readonly=true)
public java.lang.String getClassName()

getHeldClass

public java.lang.Class<? extends T> getHeldClass()

getServletHandler

public ServletHandler getServletHandler()

Returns:

Returns the servletHandler.

setServletHandler

public void setServletHandler(ServletHandler servletHandler)

Parameters:

servletHandler - The ServletHandler that will handle requests dispatched to this servlet.

setClassName

public void setClassName(java.lang.String className)

Parameters:

className - The className to set.

setHeldClass

public void setHeldClass(java.lang.Class<? extends T> held)

Parameters:

held - The class to hold

illegalStateIfContextStarted

protected void illegalStateIfContextStarted()

setInstance

protected void setInstance(T instance)

getInstance

protected T getInstance()

createInstance

protected T createInstance()
                    throws java.lang.Exception

Throws:

java.lang.Exception

getServletContext

public javax.servlet.ServletContext getServletContext()

isInstance

public boolean isInstance()

Returns:

True if this holder was created for a specific instance.

dump

public void dump(java.lang.Appendable out,
                 java.lang.String indent)
          throws java.io.IOException

Description copied from interface: Dumpable

Dump this object (and children) into an Appendable using the provided indent after any new lines. The indent should not be applied to the first object dumped.

Specified by:

dump in interface Dumpable

Parameters:

out - The appendable to dump to

indent - The indent to apply after any new lines.

Throws:

java.io.IOException - if unable to write to Appendable

dump

public java.lang.String dump()

Specified by:

dump in interface Dumpable