Class ContextHandler.CoreContextHandler

java.lang.Object

org.eclipse.jetty.util.component.AbstractLifeCycle

org.eclipse.jetty.util.component.ContainerLifeCycle

org.eclipse.jetty.server.Handler.Abstract

org.eclipse.jetty.server.Handler.AbstractContainer

org.eclipse.jetty.server.Handler.Wrapper

org.eclipse.jetty.server.handler.ContextHandler

org.eclipse.jetty.ee8.nested.ContextHandler.CoreContextHandler

All Implemented Interfaces:

AliasCheck, Handler, Handler.Container, Handler.Singleton, Request.Handler, Attributes, Container, Destroyable, Dumpable, Dumpable.DumpableContainer, LifeCycle, Invocable

Enclosing class:

ContextHandler

public class ContextHandler.CoreContextHandler
extends ContextHandler
implements Request.Handler

Nested Class Summary

Nested classes/interfaces inherited from class ContextHandler

ContextHandler.Availability, ContextHandler.ContextScopeListener, ContextHandler.ScopedContext

Nested classes/interfaces inherited from class Handler.Abstract

Handler.Abstract.NonBlocking

Nested classes/interfaces inherited from class AbstractLifeCycle

AbstractLifeCycle.AbstractLifeCycleListener, AbstractLifeCycle.StopException

Nested classes/interfaces inherited from interface Attributes

Attributes.Layer, Attributes.Lazy, Attributes.Mapped, Attributes.Synthetic, Attributes.Wrapper

Nested classes/interfaces inherited from interface Container

Container.InheritedListener, Container.Listener

Nested classes/interfaces inherited from interface Dumpable

Dumpable.DumpableContainer

Nested classes/interfaces inherited from interface Handler

Handler.Abstract, Handler.AbstractContainer, Handler.Collection, Handler.Container, Handler.Sequence, Handler.Singleton, Handler.Wrapper

Nested classes/interfaces inherited from interface Invocable

Invocable.Callable, Invocable.InvocationType, Invocable.ReadyTask, Invocable.Task

Nested classes/interfaces inherited from interface LifeCycle

LifeCycle.Listener

Nested classes/interfaces inherited from interface Request.Handler

Request.Handler.AbortException

Field Summary

Fields inherited from class ContextHandler

CROSS_CONTEXT_ATTRIBUTE, MANAGED_ATTRIBUTES

Fields inherited from class AbstractLifeCycle

FAILED, STARTED, STARTING, STOPPED, STOPPING

Fields inherited from interface Attributes

NULL

Fields inherited from interface Dumpable

KEY

Fields inherited from interface Invocable

__nonBlocking, NOOP

Method Summary

Modifier and Type	Method	Description
void	createTempDirectory()	Create the temporary directory.
protected void	doStart()	Starts the managed lifecycle beans in the order they were added.
protected void	doStop()	Stops the managed lifecycle beans in the reverse order they were added.
Set<String>	getAttributeNameSet()	Get the immutable set of attribute names.
String	getCanonicalNameForTmpDir()	Create a canonical name for a context temp directory.
ContextHandler	getContextHandler()
Resource	getResourceForTempDirName()
void	insertHandler(Handler.Singleton handler)	Inserts the given Handler (and possible chain of Handlers) between this Handler and its current child.
void	makeTempDirectory()	Generate a reasonable name for the temp directory because one has not been explicitly configured by the user with ContextHandler.setTempDirectory(File).
protected ContextHandler.ScopedContext	newContext()
protected void	notifyEnterScope(Request coreRequest)
protected void	notifyExitScope(Request coreRequest)
void	setContextPath(String contextPath)
void	setHandler(Handler handler)
void	setServer(Server server)	Set the Server to associate to this Handler.
void	setTempDirectory(File dir)	Set the temporary directory returned by ContextHandler.ScopedContext.getTempDirectory().
protected ContextRequest	wrapRequest(Request request, Response response)

Methods inherited from class ContextHandler

addAliasCheck, addEventListener, addVirtualHosts, checkAlias, checkVirtualHost, cleanupAfterStop, clearAliasChecks, clearAttributes, destroy, dump, enterScope, exitScope, getAliasChecks, getAllowNullPathInContext, getAttribute, getBaseName, getBaseResource, getClassLoader, getClassPath, getContext, getContextHandler, getContextPath, getCrossContextHandler, getCurrentContext, getCurrentContext, getCurrentContextHandler, getDisplayName, getErrorHandler, getMimeTypes, getProtectedTargets, getTempDirectory, getVirtualHosts, handle, handleByContextHandler, handleMovedPermanently, handleUnavailable, isAvailable, isCrossContextDispatchSupported, isProtectedTarget, isTempDirectoryPersistent, removeAttribute, removeEventListener, removeVirtualHosts, setAliasChecks, setAllowNullPathInContext, setAttribute, setAvailable, setBaseResource, setBaseResourceAsPath, setBaseResourceAsString, setClassLoader, setCrossContextDispatchSupported, setDisplayName, setErrorHandler, setProtectedTargets, setTempDirectoryPersistent, setVirtualHosts, toString, wrapResponse

Methods inherited from class Handler.Wrapper

getHandler, getInvocationType

Methods inherited from class Handler.AbstractContainer

findContainerOf, getDescendant, getDescendants, isDynamic, setDynamic

Methods inherited from class Handler.Abstract

getServer

Methods inherited from class ContainerLifeCycle

addBean, addBean, addManaged, contains, dump, dump, dumpObjects, dumpStdErr, getBean, getBeans, getBeans, getContainedBeans, getContainedBeans, installBean, installBean, isAuto, isManaged, isUnmanaged, manage, removeBean, removeBeans, setBeans, start, stop, unmanage, updateBean, updateBean, updateBeans, updateBeans

Methods inherited from class AbstractLifeCycle

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

Methods inherited from class Object

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

Methods inherited from interface Attributes

asAttributeMap, equals, hashCode

Methods inherited from interface Container

getCachedBeans, getEventListeners

Methods inherited from interface Dumpable

dumpSelf

Methods inherited from interface Dumpable.DumpableContainer

isDumpable

Methods inherited from interface Handler

getServer

Methods inherited from interface Handler.Container

getContainer, getDescendant, getDescendants, getDescendants

Methods inherited from interface Handler.Singleton

getHandlers, getTail, setHandler

Methods inherited from interface LifeCycle

isFailed, isRunning, isStarted, isStarting, isStopped, isStopping, start, stop

Methods inherited from interface Request.Handler

getInvocationType, handle

Method Details

makeTempDirectory

public void makeTempDirectory()
                       throws Exception

Description copied from class: ContextHandler

Generate a reasonable name for the temp directory because one has not been explicitly configured by the user with ContextHandler.setTempDirectory(File). The directory may also be created, if it is not persistent. If it is persistent it will be created as necessary by ContextHandler.createTempDirectory() later during the startup of the context.

Overrides:

makeTempDirectory in class ContextHandler

Throws:

Exception - IllegalStateException if the parent tmp directory does not exist, or IOException if the child tmp directory cannot be created.

getCanonicalNameForTmpDir

public String getCanonicalNameForTmpDir()

Description copied from class: ContextHandler

Create a canonical name for a context temp directory.

The form of the name is:

"jetty-"+host+"-"+port+"-"+resourceBase+"-_"+context+"-"+virtualhost+"-"+randomdigits+".dir"

host and port uniquely identify the server context and virtual host uniquely identify the context randomdigits ensure every tmp directory is unique

Overrides:

getCanonicalNameForTmpDir in class ContextHandler

Returns:

the canonical name for the context temp directory

getResourceForTempDirName

public Resource getResourceForTempDirName()

Overrides:

getResourceForTempDirName in class ContextHandler

Returns:

the baseResource for the context to use in the temp dir name

setTempDirectory

public void setTempDirectory(File dir)

Description copied from class: ContextHandler

Set the temporary directory returned by ContextHandler.ScopedContext.getTempDirectory(). If not set here, then the Server.getTempDirectory() is returned by ContextHandler.ScopedContext.getTempDirectory().

If ContextHandler.isTempDirectoryPersistent() is true, the directory set here is used directly but may be created if it does not exist. If ContextHandler.isTempDirectoryPersistent() is false, then any File set here will be deleted and recreated as a directory during AbstractLifeCycle.start() and will be deleted during AbstractLifeCycle.stop().

Overrides:

setTempDirectory in class ContextHandler

Parameters:

dir - A directory. If it does not exist, it must be able to be created during start.

See Also:

• ContextHandler.setTempDirectoryPersistent(boolean)

setContextPath

public void setContextPath(String contextPath)

Overrides:

setContextPath in class ContextHandler

Parameters:

contextPath - The _contextPath to set.

doStart

protected void doStart()
                throws Exception

Description copied from class: ContainerLifeCycle

Starts the managed lifecycle beans in the order they were added.

Overrides:

doStart in class ContextHandler

Throws:

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

createTempDirectory

public void createTempDirectory()

Description copied from class: ContextHandler

Create the temporary directory. If the directory exists, but is not persistent, then it is first deleted and then recreated. Once created, this method is a noop if called again before stopping the context.

Overrides:

createTempDirectory in class ContextHandler

doStop

protected void doStop()
               throws Exception

Description copied from class: ContainerLifeCycle

Stops the managed lifecycle beans in the reverse order they were added.

Overrides:

doStop in class ContextHandler

Throws:

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

insertHandler

public void insertHandler(Handler.Singleton handler)

Description copied from interface: Handler.Singleton

Inserts the given Handler (and possible chain of Handlers) between this Handler and its current child.

For example, if this Handler A has a child B, inserting Handler X built as a chain Handlers X-Y-Z results in the structure A-X-Y-Z-B.

Specified by:

insertHandler in interface Handler.Singleton

Parameters:

handler - the Handler to insert

setHandler

public void setHandler(Handler handler)

Specified by:

setHandler in interface Handler.Singleton

Overrides:

setHandler in class Handler.Wrapper

Parameters:

handler - The Handler to set as a child

setServer

public void setServer(Server server)

Description copied from interface: Handler

Set the Server to associate to this Handler.

Specified by:

setServer in interface Handler

Overrides:

setServer in class ContextHandler

Parameters:

server - the Server to associate to this Handler

newContext

protected ContextHandler.ScopedContext newContext()

Overrides:

newContext in class ContextHandler

wrapRequest

protected ContextRequest wrapRequest(Request request,
 Response response)

Overrides:

wrapRequest in class ContextHandler

notifyEnterScope

protected void notifyEnterScope(Request coreRequest)

Overrides:

notifyEnterScope in class ContextHandler

Parameters:

coreRequest - A request that is applicable to the scope, or null

notifyExitScope

protected void notifyExitScope(Request coreRequest)

Overrides:

notifyExitScope in class ContextHandler

Parameters:

coreRequest - A request that is applicable to the scope, or null

getContextHandler

public ContextHandler getContextHandler()

getAttributeNameSet

public Set<String> getAttributeNameSet()

Description copied from interface: Attributes

Get the immutable set of attribute names.

Specified by:

getAttributeNameSet in interface Attributes

Overrides:

getAttributeNameSet in class ContextHandler

Returns:

Set of attribute names, or an empty set if there are no attributes.