org.apache.catalina.cluster
Interface ClusterDeployer

All Superinterfaces:

MessageListener

All Known Implementing Classes:

FarmWarDeployer

public interface ClusterDeployer

extends MessageListener

Field Summary

static java.lang.String

info Descriptive information about this component implementation.

Method Summary

void	backgroundProcess() call from container Background Process
void	install(java.lang.String contextPath, java.net.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(java.lang.String contextPath, boolean undeploy) Remove an existing web application, attached to the specified context path.
void	start() Start the cluster deployer, the owning container will invoke this
void	stop() Stops the cluster deployer, the owning container will invoke this

Methods inherited from interface org.apache.catalina.cluster.MessageListener

accept, equals, getCluster, hashCode, messageReceived, setCluster

Field Detail

info

public static final java.lang.String info

Descriptive information about this component implementation.

See Also:

Constant Field Values

Method Detail

start

public void start()
           throws java.lang.Exception

Start the cluster deployer, the owning container will invoke this

Throws:

java.lang.Exception - - if failure to start cluster

stop

public void stop()
          throws LifecycleException

Stops the cluster deployer, the owning container will invoke this

Throws:

LifecycleException

install

public void install(java.lang.String contextPath,
                    java.net.URL war)
             throws java.io.IOException

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. 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 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:

java.lang.IllegalArgumentException - if the specified context path is malformed (it must be "" or start with a slash)

java.lang.IllegalStateException - if the specified context path is already attached to an existing web application

java.io.IOException - if an input/output error was encountered during installation

remove

public void remove(java.lang.String contextPath,
                   boolean undeploy)
            throws java.io.IOException

Remove an existing web application, attached to the specified context path. If this application is successfully removed, a ContainerEvent of type 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:

java.lang.IllegalArgumentException - if the specified context path is malformed (it must be "" or start with a slash)

java.lang.IllegalArgumentException - if the specified context path does not identify a currently installed web application

java.io.IOException - if an input/output error occurs during removal

backgroundProcess

public void backgroundProcess()

call from container Background Process