You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@tomcat.apache.org by pi...@locus.apache.org on 2000/09/22 04:05:16 UTC
cvs commit: jakarta-tomcat-4.0/invocation/src/share/org/apache/invocation InvocationAbstraction.java package.html
pier 00/09/21 19:05:13
Modified: invocation README
invocation/src/share/org/apache/invocation
InvocationAbstraction.java package.html
Log:
Updated documentation.
Added method canRestart() in interface and changed return type.
Revision Changes Path
1.3 +2 -3 jakarta-tomcat-4.0/invocation/README
Index: README
===================================================================
RCS file: /home/cvs/jakarta-tomcat-4.0/invocation/README,v
retrieving revision 1.2
retrieving revision 1.3
diff -u -r1.2 -r1.3
--- README 2000/09/22 01:54:11 1.2
+++ README 2000/09/22 02:05:09 1.3
@@ -89,7 +89,6 @@
about ports to different operating systems (MacOS/9, IBM...).
-------------------------------------------------------------------------
-Copyright (c) 2000 The Apache Software Foundation. All rights reserved. *
-- $Revision: 1.2 $
-- $Date: 2000/09/22 01:54:11 $
+Copyright (c) 2000 The Apache Software Foundation. All rights reserved.
+$Revision: 1.3 $ $Date: 2000/09/22 02:05:09 $
-------------------------------------------------------------------------
1.3 +19 -5 jakarta-tomcat-4.0/invocation/src/share/org/apache/invocation/InvocationAbstraction.java
Index: InvocationAbstraction.java
===================================================================
RCS file: /home/cvs/jakarta-tomcat-4.0/invocation/src/share/org/apache/invocation/InvocationAbstraction.java,v
retrieving revision 1.2
retrieving revision 1.3
diff -u -r1.2 -r1.3
--- InvocationAbstraction.java 2000/09/21 09:28:02 1.2
+++ InvocationAbstraction.java 2000/09/22 02:05:11 1.3
@@ -105,7 +105,7 @@
* @author <a href="mailto:pier.fumagalli@eng.sun.com">Pier Fumagalli</a>
* @author Copyright © 1999-2000 <a href="http://www.apache.org">The
* Apache Software Foundation</a>
- * @version CVS $Revision: 1.2 $ $Date: 2000/09/21 09:28:02 $
+ * @version CVS $Revision: 1.3 $ $Date: 2000/09/22 02:05:11 $
*/
public interface InvocationAbstraction {
@@ -119,22 +119,26 @@
* exception is thrown the virtual machine
* is shut down.
*/
- public boolean start(String args[])
+ public void start(String args[])
throws InvocationException;
/**
* Restart the service handled by this <code>InvocationAbstraction</code>
- * instance.
+ * instance <i>(optional)</i>.
* <br>
* This method is called when a restart signal is detected, meaning that
* the service should be stopped, disk configuration reloaded, and the
* servoce restarted.
+ * <br>
+ * This method is optional: services not willing to provide a restart
+ * function should simply return to the caller, and the return value for
+ * the <code>canRestart()</code> method should be <b>false</b>.
*
* @exception InvocationException The service cannot be restarted. When
* this exception is thrown the virtual
* machine is shut down.
*/
- public boolean restart()
+ public void restart()
throws InvocationException;
/**
@@ -147,6 +151,16 @@
* When this exception is thrown the virtual
* machine is shut down.
*/
- public boolean stop()
+ public void stop()
throws InvocationException;
+
+ /**
+ * Queries this <code>InvocationAbstraction</code> implementation wether
+ * the <code>restart()</code> method will perform something or not.
+ *
+ * @return This method returns <b>true</b> if the <code>restart()</code>
+ * method can be invoked without raising an exception (the
+ * service can be restarted), <b>false</b> otherwise.
+ */
+ public boolean canRestart();
}
1.2 +8 -1 jakarta-tomcat-4.0/invocation/src/share/org/apache/invocation/package.html
Index: package.html
===================================================================
RCS file: /home/cvs/jakarta-tomcat-4.0/invocation/src/share/org/apache/invocation/package.html,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -r1.1 -r1.2
--- package.html 2000/09/22 01:54:14 1.1
+++ package.html 2000/09/22 02:05:12 1.2
@@ -79,4 +79,11 @@
</tr>
</table>
</body>
-</html>
\ No newline at end of file
+</html>
+
+<!-- --------------------------------------------------------------------
+Copyright (c) 2000 The Apache Software Foundation. All rights reserved.
+$Revision: 1.2 $ $Date: 2000/09/22 02:05:12 $
+--------------------------------------------------------------------- -->
+
+