KickJava   Java API By Example, From Geeks To Geeks.

Java > Open Source Codes > gov > nasa > jpf > VMListener


1 //
2 // Copyright (C) 2005 United States Government as represented by the
3 // Administrator of the National Aeronautics and Space Administration
4 // (NASA). All Rights Reserved.
5 //
6 // This software is distributed under the NASA Open Source Agreement
7 // (NOSA), version 1.3. The NOSA has been approved by the Open Source
8 // Initiative. See the file NOSA-1.3-JPF at the top of the distribution
9 // directory tree for the complete NOSA document.
10 //
11 // THE SUBJECT SOFTWARE IS PROVIDED "AS IS" WITHOUT ANY WARRANTY OF ANY
12 // KIND, EITHER EXPRESSED, IMPLIED, OR STATUTORY, INCLUDING, BUT NOT
13 // LIMITED TO, ANY WARRANTY THAT THE SUBJECT SOFTWARE WILL CONFORM TO
14 // SPECIFICATIONS, ANY IMPLIED WARRANTIES OF MERCHANTABILITY, FITNESS FOR
15 // A PARTICULAR PURPOSE, OR FREEDOM FROM INFRINGEMENT, ANY WARRANTY THAT
16 // THE SUBJECT SOFTWARE WILL BE ERROR FREE, OR ANY WARRANTY THAT
17 // DOCUMENTATION, IF PROVIDED, WILL CONFORM TO THE SUBJECT SOFTWARE.
18 //
19 package gov.nasa.jpf;
20
21 /**
22  * interface to register for callbacks by the VM
23  * Observer role in equally named pattern
24  */
25 public interface VMListener extends JPFListener {
26   /**
27    * VM has executed next instruction
28    * (can be used to analyze branches, monitor PUTFIELD / GETFIELD and
29    * INVOKExx / RETURN instructions)
30    */
31   void instructionExecuted (VM vm);
32   
33   /**
34    * new Thread entered run() method
35    */
36   void threadStarted (VM vm);
37   
38   /**
39    * Thread exited run() method
40    */
41   void threadTerminated (VM vm);
42   
43   /**
44    * new class was loaded
45    */
46   void classLoaded (VM vm);
47   
48   /**
49    * new object was created
50    */
51   void objectCreated (VM vm);
52   
53   /**
54    * object was garbage collected (after potential finalization)
55    */
56   void objectReleased (VM vm);
57   
58   void gcBegin (VM vm);
59   
60   void gcEnd (VM vm);
61   
62   /**
63    * exception was thrown
64    */
65   void exceptionThrown (VM vm);
66 }
67
68
Popular Tags