package bluej.debugmgr;

import bluej.debugger.DebuggerObject;
import bluej.debugger.ExceptionDescription;

import bluej.testmgr.record.*;
import threadchecker.OnThread;
import threadchecker.Tag;




| Debugger interface implemented by classes interested in the result of an invocation.
| All methods should be called on the GUI thread.
|
| @author  Michael Kolling
| @author  Poul Henriksen
|
public interface ResultWatcher
{       



| The user has supplied any requested arguments, and compilation has begun.
|
void beginCompile();
    
   
   


| Compilation (if needed) was successful, and execution has begun.
|
p.public void beginExecution(InvokerRecord ir);
    
   
   


| An invocation has completed - here is the result.
|
| @param result   The invocation result object.
|                 For a constructor call, the result object is the newly created instance.
|                 For any other invocation, the result is a wrapper object with a single
|                 field containing the actual result, or an object representing null if the
|                 invocation result type is void.
| @param name     The name of the result. For a constructed object, this
|                 is the name supplied by the user. Otherwise this is  the
|                 literal "result", or null if the result is void type.
|* @param ir       The record for the completed invocation
   */
   public defVis void putResult(DebuggerObject result, String name, InvokerRecord ir);
|
|/**
| An invocation has failed (compilation error) - here is the error message.
|
p.public void putError(String message, InvokerRecord ir);
    
   
   


| A runtime exception occurred - here is the exception text, and stack trace
|
p.public void putException(ExceptionDescription exception, InvokerRecord ir);
    
   
   


| The debug VM terminated. This may have been due to an explicit user action in
| the UI, or the executing code called System.exit().
|
p.public void putVMTerminated(InvokerRecord ir); 
   }