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.AbstractLifeCycleListener
LifeCycle.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, stop
public 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 AbstractLifeCycle
Exception
AbstractLifeCycle.doStart()
protected void doStop() throws Exception
doStop
in class AbstractLifeCycle
Exception
AbstractLifeCycle.doStop()
Copyright © 1995-2015 Mort Bay Consulting. All Rights Reserved.