fhanik 2003/03/19 16:11:05 Modified: catalina/src/share/org/apache/catalina Cluster.java Log: added methods for cluster wide deployments Revision Changes Path 1.3 +71 -8 jakarta-tomcat-catalina/catalina/src/share/org/apache/catalina/Cluster.java Index: Cluster.java =================================================================== RCS file: /home/cvs/jakarta-tomcat-catalina/catalina/src/share/org/apache/catalina/Cluster.java,v retrieving revision 1.2 retrieving revision 1.3 diff -u -r1.2 -r1.3 --- Cluster.java 5 Dec 2002 12:22:15 -0000 1.2 +++ Cluster.java 20 Mar 2003 00:11:05 -0000 1.3 @@ -63,8 +63,8 @@ package org.apache.catalina; - - +import java.io.IOException; +import java.net.URL; /** * A <b>Cluster</b> works as a Cluster client/server for the local host * Different Cluster implementations can be used to support different @@ -76,6 +76,7 @@ * * @author Bip Thelin * @author Remy Maucherat + * @author Filip Hanik * @version $Revision$, $Date$ */ @@ -151,12 +152,74 @@ // --------------------------------------------------------- Public Methods /** - * Create a new manager which will use this cluster to replicate its + * Create a new manager which will use this cluster to replicate its * sessions. - * + * * @param name Name (key) of the application with which the manager is * associated */ public Manager createManager(String name); + + // --------------------------------------------------------- Cluster Wide Deployments + /** + * Start an existing web application, attached to the specified context + * path in all the other nodes in the cluster. + * Only starts a web application if it is not running. + * + * @param contextPath The context path of the application to be started + * + * @exception IllegalArgumentException if the specified context path + * is malformed (it must be "" or start with a slash) + * @exception IllegalArgumentException if the specified context path does + * not identify a currently installed web application + * @exception IOException if an input/output error occurs during + * startup + */ + public void startContext(String contextPath) 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. + * <p> + * If this application is successfully installed, a ContainerEvent of type + * <code>PRE_INSTALL_EVENT</code> will be sent to registered listeners + * before the associated Context is started, and a ContainerEvent of type + * <code>INSTALL_EVENT</code> will be sent to all registered listeners + * after the associated Context is started, with the newly created + * <code>Context</code> as an argument. + * + * @param contextPath The context path to which this application should + * be installed (must be unique) + * @param 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 + * + * @exception IllegalArgumentException if the specified context path + * is malformed (it must be "" or start with a slash) + * @exception IllegalStateException if the specified context path + * is already attached to an existing web application + * @exception IOException if an input/output error was encountered + * during installation + */ + public void installContext(String contextPath, URL war); + + /** + * Stop an existing web application, attached to the specified context + * path. Only stops a web application if it is running. + * + * @param contextPath The context path of the application to be stopped + * + * @exception IllegalArgumentException if the specified context path + * is malformed (it must be "" or start with a slash) + * @exception IllegalArgumentException if the specified context path does + * not identify a currently installed web application + * @exception IOException if an input/output error occurs while stopping + * the web application + */ + public void stop(String contextPath) throws IOException; }
--------------------------------------------------------------------- To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]