ContextProvider from the DeploymentManager@Deprecated public class ContextDeployer extends AbstractLifeCycle
Note: The WebAppDeployer is being phased out of Jetty in favor of the DeploymentManager and
ContextProvider implementation.
This deployer scans a designated directory by setConfigurationDir(String) for the appearance/disappearance
or changes to xml configuration files. The scan is performed at startup and at an optional hot deployment frequency
specified by setScanInterval(int). By default, the scanning is NOT recursive, but can be made so by
setRecursive(boolean).
Each configuration file is in XmlConfiguration format and represents the configuration of a instance of
ContextHandler (or a subclass specified by the XML Configure element).
The xml should configure the context and the instance is deployed to the ContextHandlerCollection specified
by HandlerWrapper.setHandler(org.eclipse.jetty.server.Handler).
Similarly, when one of these existing files is removed, the corresponding context is undeployed; when one of these files is changed, the corresponding context is undeployed, the (changed) xml config file reapplied to it, and then (re)deployed.
Note that the context itself is NOT copied into the hot deploy directory. The webapp directory or war file can exist anywhere. It is the xml config file that points to it's location and deploys it from there.
It means, for example, that you can keep a "read-only" copy of your webapp somewhere, and apply different configurations to it simply by dropping different xml configuration files into the configuration directory.
DeploymentManager,
ScanningAppProvider| Modifier and Type | Class and Description |
|---|---|
protected class |
ContextDeployer.ScannerListener
Deprecated.
|
AbstractLifeCycle.AbstractLifeCycleListenerLifeCycle.Listener_listeners, FAILED, RUNNING, STARTED, STARTING, STOPPED, STOPPING| Constructor and Description |
|---|
ContextDeployer()
Deprecated.
Constructor
|
| Modifier and Type | Method and Description |
|---|---|
protected void |
doStart()
Deprecated.
Start the hot deployer looking for webapps to deploy/undeploy
|
protected void |
doStop()
Deprecated.
Stop the hot deployer.
|
Object |
getAttribute(String name)
Deprecated.
Get a contextAttribute that will be set for every Context deployed by this deployer.
|
Resource |
getConfigurationDir()
Deprecated.
|
ConfigurationManager |
getConfigurationManager()
Deprecated.
|
ContextHandlerCollection |
getContexts()
Deprecated.
|
String |
getContextsDir()
Deprecated.
|
String |
getDirectory()
Deprecated.
|
boolean |
getRecursive()
Deprecated.
|
int |
getScanInterval()
Deprecated.
|
boolean |
isRecursive()
Deprecated.
|
void |
removeAttribute(String name)
Deprecated.
Remove a contextAttribute that will be set for every Context deployed by this deployer.
|
void |
setAttribute(String name,
Object value)
Deprecated.
Set a contextAttribute that will be set for every Context deployed by this deployer.
|
void |
setConfigurationDir(File file)
Deprecated.
|
void |
setConfigurationDir(Resource resource)
Deprecated.
|
void |
setConfigurationDir(String dir)
Deprecated.
|
void |
setConfigurationManager(ConfigurationManager configMgr)
Deprecated.
|
void |
setContexts(ContextHandlerCollection contexts)
Deprecated.
Associate with a
ContextHandlerCollection. |
void |
setContextsDir(String dir)
Deprecated.
|
void |
setDirectory(String directory)
Deprecated.
|
void |
setRecursive(boolean recursive)
Deprecated.
|
void |
setScanInterval(int seconds)
Deprecated.
|
addLifeCycleListener, getState, getState, isFailed, isRunning, isStarted, isStarting, isStopped, isStopping, removeLifeCycleListener, start, stoppublic ContextHandlerCollection getContexts()
public void setContexts(ContextHandlerCollection contexts)
ContextHandlerCollection.contexts - the ContextHandlerColletion to which to deploy the contextspublic void setScanInterval(int seconds)
seconds - The period in second between scans for changed configuration
files. A zero or negative interval disables hot deploymentpublic int getScanInterval()
public void setContextsDir(String dir)
dir - Directory to scan for context descriptorspublic String getContextsDir()
@Deprecated public void setConfigurationDir(String dir) throws Exception
setContextsDir(String)dir - Exception@Deprecated public void setConfigurationDir(File file) throws Exception
setContextsDir(String)file - Exception@Deprecated public void setConfigurationDir(Resource resource)
setContextsDir(String)resource - @Deprecated public void setDirectory(String directory) throws Exception
setContextsDir(String)directory - Exception@Deprecated public String getDirectory()
setContextsDir(String)@Deprecated public Resource getConfigurationDir()
setContextsDir(String)public void setConfigurationManager(ConfigurationManager configMgr)
configMgr - public ConfigurationManager getConfigurationManager()
public void setRecursive(boolean recursive)
public boolean getRecursive()
public boolean isRecursive()
public void setAttribute(String name, Object value)
name - value - public Object getAttribute(String name)
name - public void removeAttribute(String name)
name - protected void doStart()
throws Exception
doStart in class AbstractLifeCycleExceptionAbstractLifeCycle.doStart()protected void doStop()
throws Exception
doStop in class AbstractLifeCycleExceptionAbstractLifeCycle.doStop()Copyright © 1995-2015 Mort Bay Consulting. All Rights Reserved.