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