Update of /cvsroot/javaprofiler/interface/net/sourceforge/javaprofiler/jpi
In directory usw-pr-cvs1:/tmp/cvs-serv659
Modified Files:
VirtualMachine.java
Log Message:
isShutdowned() and shutdown() methods added.
Index: VirtualMachine.java
===================================================================
RCS file: /cvsroot/javaprofiler/interface/net/sourceforge/javaprofiler/jpi/VirtualMachine.java,v
retrieving revision 1.4
retrieving revision 1.5
diff -C2 -r1.4 -r1.5
*** VirtualMachine.java 2001/09/29 20:55:06 1.4
--- VirtualMachine.java 2002/01/27 22:49:17 1.5
***************
*** 107,114 ****
--- 107,146 ----
public void resumeThreads();
+ /**
+ * Checks if profiled JVM is shutting down. So, it means, the JVM is no
+ * longer running, the JVMPI_EVENT_JVM_SHUTDOWN event was received and
+ * profiler dynamic library waits in JVMPI_EVENT_JVM_SHUTDOWN event
+ * handler. The client can now gain any necessary data before calling
+ * the shutdown() method which shutdowns JVM definitelly.
+ *
+ * @return true (JVM is shutting down);
+ * false (still running, normal operation)
+ *
+ * @see shutdown(), exitVM()
+ */
+ public boolean isShutdowned();
+
+ /**
+ * Shuts profiled JVM down. When profiled JVM is ending, it sends
+ * the JVMPI_EVENT_JVM_SHUTDOWN event to profiler dynamic library.
+ * Then the library waits in JVMPI_EVENT_JVM_SHUTDOWN event handler
+ * until the client calls this method. The goal is the client can make
+ * any necessary calls to gain data before profiled JVM really shutdowns
+ * (so before client's shutdown() call).
+ *
+ * Note: this method doesn't stop running JVM, to stop running JVM,
+ * use exitVM() method instead.
+ *
+ * @see isShutdowned(), exitVM()
+ */
+ public void shutdown();
+
}
/*
* $Log$
+ * Revision 1.5 2002/01/27 22:49:17 stolis
+ * isShutdowned() and shutdown() methods added.
+ *
* Revision 1.4 2001/09/29 20:55:06 stolis
* Plural added in licenses.
|