Prev Class | Next Class | Frames | No Frames |
Summary: Nested | Field | Method | Constr | Detail: Nested | Field | Method | Constr |
java.lang.Object
org.apache.catalina.core.StandardHostDeployer
StandardHost
implementation class.
Field Summary | |
protected StandardHost |
|
protected static StringManager |
|
Fields inherited from interface org.apache.catalina.Deployer | |
INSTALL_EVENT , PRE_INSTALL_EVENT , REMOVE_EVENT |
Constructor Summary | |
|
Method Summary | |
void | |
protected Digester |
|
Context |
|
String[] |
|
Host |
|
String |
|
ClassLoader |
|
void |
|
void |
|
void |
|
void |
|
boolean |
|
void |
|
void |
|
void | |
void |
|
void |
|
public StandardHostDeployer()
public StandardHostDeployer(StandardHost host)
Create a new StandardHostDeployer associated with the specified StandardHost.
- Parameters:
host
- The StandardHost we are associated with
public void addChild(Container child)
Delegate a request to add a child Context to our associated Host.
- Parameters:
child
- The child Context to be added
protected Digester createDigester()
Create (if necessary) and return a Digester configured to process the context configuration descriptor for an application.
public Context findDeployedApp(String contextPath)
Return the Context for the deployed application that is associated with the specified context path (if any); otherwise returnnull
.
- Specified by:
- findDeployedApp in interface Deployer
- Parameters:
contextPath
- The context path of the requested web application
public String[] findDeployedApps()
Return the context paths of all deployed web applications in this Container. If there are no deployed applications, a zero-length array is returned.
- Specified by:
- findDeployedApps in interface Deployer
public String getName()
Return the name of the Container with which this Deployer is associated.
public ClassLoader getParentClassLoader()
Delegate a request for the parent class loader to our associated Host.
public void install(String contextPath, URL war) throws IOException
Install a new web application, whose web application archive is at the specified URL, into this container with the specified context path. A context path of "" (the empty string) should be used for the root application for this container. Otherwise, the context path must start with a slash. If this application is successfully installed, a ContainerEvent of typePRE_INSTALL_EVENT
will be sent to registered listeners before the associated Context is started, and a ContainerEvent of typeINSTALL_EVENT
will be sent to all registered listeners after the associated Context is started, with the newly createdContext
as an argument.
- Parameters:
contextPath
- The context path to which this application should be installed (must be unique)war
- A URL of type "jar:" that points to a WAR file, or type "file:" that points to an unpacked directory structure containing the web application to be installed
public void install(String contextPath, URL war, String configFile) throws IOException
Install a new web application, whose web application archive is at the specified URL, into this container with the specified context path. A context path of "" (the empty string) should be used for the root application for this container. Otherwise, the context path must start with a slash. If this application is successfully installed, a ContainerEvent of typePRE_INSTALL_EVENT
will be sent to registered listeners before the associated Context is started, and a ContainerEvent of typeINSTALL_EVENT
will be sent to all registered listeners after the associated Context is started, with the newly createdContext
as an argument.
- Parameters:
contextPath
- The context path to which this application should be installed (must be unique)war
- A URL of type "jar:" that points to a WAR file, or type "file:" that points to an unpacked directory structure containing the web application to be installedconfigFile
- The path to a file to save the Context information. If configFile is null, the Context information is saved in server.xml; if it is NOT null, the Context information is saved in configFile.
public void install(URL war) throws IOException
Installs a new web application from the web application archive at the specified URL, which must contain a META-INF/context.xml context configuration file (consisting of a<Context>
element). The web application is installed at the path specified inside the embedded META-INF/context.xml. The docBase (if any) specified inside the embedded META-INF/context.xml is overridden with the web application's location. If the installation succeeds, a ContainerEvent of typeINSTALL_EVENT
is sent to all registered listeners, with the newly createdContext
as its argument.
- Parameters:
war
- URL pointing to web application location (WAR-packaged or unpacked directory)
public void install(URL config, URL war) throws IOException
Install a new web application, whose context configuration file (consisting of a<Context>
element) and (optional) web application archive are at the specified URLs. If this application is successfully installed, a ContainerEvent of typePRE_INSTALL_EVENT
will be sent to registered listeners before the associated Context is started, and a ContainerEvent of typeINSTALL_EVENT
will be sent to all registered listeners after the associated Context is started, with the newly createdContext
as an argument.
- Parameters:
config
- A URL that points to the context configuration descriptor to be used for configuring the new Contextwar
- A URL of type "jar:" that points to a WAR file, or type "file:" that points to an unpacked directory structure containing the web application to be installed, ornull
to use thedocBase
attribute from the configuration descriptor
public boolean isDeployXML()
Returns true if context.xml config files are supported.
- Specified by:
- isDeployXML in interface Deployer
- Returns:
- true of context.xml config files are supported, false otherwise
public void remove(String contextPath) throws IOException
Remove an existing web application, attached to the specified context path. If this application is successfully removed, a ContainerEvent of typeREMOVE_EVENT
will be sent to all registered listeners, with the removedContext
as an argument.
- Parameters:
contextPath
- The context path of the application to be removed
public void remove(String contextPath, boolean undeploy) throws IOException
Remove an existing web application, attached to the specified context path. If this application is successfully removed, a ContainerEvent of typeREMOVE_EVENT
will be sent to all registered listeners, with the removedContext
as an argument. Deletes the web application war file and/or directory if they exist in the Host's appBase.
- Parameters:
contextPath
- The context path of the application to be removedundeploy
- boolean flag to remove web application from server
public void start(String contextPath) throws IOException
Start an existing web application, attached to the specified context path. Only starts a web application if it is not running.
- Parameters:
contextPath
- The context path of the application to be started