You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@tomcat.apache.org by fh...@apache.org on 2003/03/20 01:11:05 UTC
cvs commit: jakarta-tomcat-catalina/catalina/src/share/org/apache/catalina Cluster.java
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: tomcat-dev-unsubscribe@jakarta.apache.org
For additional commands, e-mail: tomcat-dev-help@jakarta.apache.org