org.apache.catalina.ha
public interface ClusterDeployer extends ChannelListener
Version: $Revision: 467222 $, $Date: 2006-10-24 05:17:11 +0200 (Tue, 24 Oct 2006) $
| Field Summary | |
|---|---|
| String | info
Descriptive information about this component implementation. |
| Method Summary | |
|---|---|
| void | backgroundProcess()
call from container Background Process |
| CatalinaCluster | getCluster()
Returns the cluster the cluster deployer is associated with |
| void | install(String contextPath, URL war)
Install a new web application, whose web application archive is at the
specified URL, into this container and all the other
members of the cluster with the specified context path.
|
| void | remove(String contextPath, boolean undeploy)
Remove an existing web application, attached to the specified context
path. |
| void | setCluster(CatalinaCluster cluster)
Associates the cluster deployer with a cluster |
| void | start()
Start the cluster deployer, the owning container will invoke this |
| void | stop()
Stops the cluster deployer, the owning container will invoke this |
Returns: CatalinaCluster
If this application is successfully installed locally,
a ContainerEvent of type
INSTALL_EVENT will be sent to all registered listeners,
with the newly created Context 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
Throws: IllegalArgumentException if the specified context path is malformed (it must be "" or start with a slash) IllegalStateException if the specified context path is already attached to an existing web application IOException if an input/output error was encountered during installation
REMOVE_EVENT will be sent to all
registered listeners, with the removed Context 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 removed undeploy boolean flag to remove web application from server
Throws: IllegalArgumentException if the specified context path is malformed (it must be "" or start with a slash) IllegalArgumentException if the specified context path does not identify a currently installed web application IOException if an input/output error occurs during removal
Parameters: cluster CatalinaCluster
Throws: Exception - if failure to start cluster
Throws: LifecycleException