|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Object org.eclipse.jetty.util.component.AbstractLifeCycle org.eclipse.jetty.deploy.ContextDeployer
ContextProvider
from the DeploymentManager
@Deprecated public class ContextDeployer
Legacy Context Deployer.
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
Nested Class Summary | |
---|---|
protected class |
ContextDeployer.ScannerListener
Deprecated. |
Nested classes/interfaces inherited from class org.eclipse.jetty.util.component.AbstractLifeCycle |
---|
AbstractLifeCycle.AbstractLifeCycleListener |
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 |
---|
_listeners, FAILED, RUNNING, STARTED, STARTING, STOPPED, STOPPING |
Constructor Summary | |
---|---|
ContextDeployer()
Deprecated. Constructor |
Method Summary | |
---|---|
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. use setContextsDir(String) |
ConfigurationManager |
getConfigurationManager()
Deprecated. |
ContextHandlerCollection |
getContexts()
Deprecated. |
String |
getContextsDir()
Deprecated. |
String |
getDirectory()
Deprecated. use setContextsDir(String) |
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. use setContextsDir(String) |
void |
setConfigurationDir(Resource resource)
Deprecated. use setContextsDir(String) |
void |
setConfigurationDir(String dir)
Deprecated. use setContextsDir(String) |
void |
setConfigurationManager(ConfigurationManager configMgr)
Deprecated. |
void |
setContexts(ContextHandlerCollection contexts)
Deprecated. Associate with a ContextHandlerCollection . |
void |
setContextsDir(String dir)
Deprecated. |
void |
setDirectory(String directory)
Deprecated. use setContextsDir(String) |
void |
setRecursive(boolean recursive)
Deprecated. |
void |
setScanInterval(int seconds)
Deprecated. |
Methods inherited from class org.eclipse.jetty.util.component.AbstractLifeCycle |
---|
addLifeCycleListener, getState, getState, isFailed, isRunning, isStarted, isStarting, isStopped, isStopping, removeLifeCycleListener, start, stop |
Methods inherited from class java.lang.Object |
---|
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
Constructor Detail |
---|
public ContextDeployer()
Method Detail |
---|
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()
|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |