com.bluemarsh.jswat.breakpoint
Class ExceptionBreakpoint

java.lang.Object
  |
  +--com.bluemarsh.jswat.breakpoint.DefaultBreakpoint
        |
        +--com.bluemarsh.jswat.breakpoint.ResolvableBreakpoint
              |
              +--com.bluemarsh.jswat.breakpoint.ExceptionBreakpoint
All Implemented Interfaces:
Breakpoint, java.util.EventListener, java.io.Serializable, VMEventListener

public class ExceptionBreakpoint
extends ResolvableBreakpoint
implements VMEventListener

Class ExceptionBreakpoint implements the Breakpoint interface. Its only property is the name of an exception class. It halts execution of the debuggee VM whenever an exception of the given type (or subtype) has been thrown. This includes caught and uncaught exceptions.

Author:
Nathan Fiedler
See Also:
Serialized Form

Field Summary
protected static Category logCategory
          Reporting category.
 
Fields inherited from class com.bluemarsh.jswat.breakpoint.ResolvableBreakpoint
eventRequest, prepareRequest, referenceSpec
 
Fields inherited from class com.bluemarsh.jswat.breakpoint.DefaultBreakpoint
breakpointGroup, conditionList, deleteOnExpire, expireCount, isEnabled, monitorList, propertyList, skipCount, stoppedCount, suspendPolicy
 
Fields inherited from interface com.bluemarsh.jswat.event.VMEventListener
PRIORITY_BREAKPOINT, PRIORITY_DEFAULT, PRIORITY_HIGH, PRIORITY_HIGHEST, PRIORITY_LOW, PRIORITY_LOWEST, PRIORITY_SESSION
 
Fields inherited from interface com.bluemarsh.jswat.breakpoint.Breakpoint
serialVersionUID
 
Method Summary
 boolean eventOccurred(com.sun.jdi.event.Event e)
          Invoked when a VM event has occurred.
 BreakpointUI getUIAdapter()
          Returns the user interface widget for customizing this breakpoint.
 void init()
          Initialize the breakpoint so it may operate normally.
protected  void performStop(com.sun.jdi.event.Event e)
          This breakpoint has caused the debuggee VM to stop.
protected  com.sun.jdi.request.EventRequest resolveReference(com.sun.jdi.ReferenceType refType)
          Resolve against the given ReferenceType.
 java.lang.String toString()
          Returns a String representation of this.
 java.lang.String toString(boolean terse)
          Returns a String representation of this.
 
Methods inherited from class com.bluemarsh.jswat.breakpoint.ResolvableBreakpoint
destroy, eventRequest, getReferenceTypeSpec, isResolved, reset, resolveAgainstEvent, resolveEagerly, setEnabled, setSuspendPolicy, unresolve
 
Methods inherited from class com.bluemarsh.jswat.breakpoint.DefaultBreakpoint
addCondition, addMonitor, conditions, deleteOnExpire, fireChange, getBreakpointGroup, getBreakpointManager, getExpireCount, getProperty, getSkipCount, getSuspendPolicy, hasExpired, incrementStoppedCount, isEnabled, isSkipping, monitors, removeCondition, removeMonitor, setBreakpointGroup, setExpireCount, setProperty, setSkipCount, shouldResume
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
 

Field Detail

logCategory

protected static Category logCategory
Reporting category.
Method Detail

eventOccurred

public boolean eventOccurred(com.sun.jdi.event.Event e)
Invoked when a VM event has occurred.
Specified by:
eventOccurred in interface VMEventListener
Parameters:
e - VM event.
Returns:
true if debuggee VM should be resumed, false otherwise.

getUIAdapter

public BreakpointUI getUIAdapter()
Returns the user interface widget for customizing this breakpoint.
Overrides:
getUIAdapter in class DefaultBreakpoint
Returns:
Breakpoint user interface adapter.

init

public void init()
Initialize the breakpoint so it may operate normally.
Overrides:
init in class DefaultBreakpoint

performStop

protected void performStop(com.sun.jdi.event.Event e)
This breakpoint has caused the debuggee VM to stop. Increment any breakpoint counters and execute all monitors associated with this breakpoint.
Overrides:
performStop in class DefaultBreakpoint
Parameters:
e - Event for which we are stopping.

resolveReference

protected com.sun.jdi.request.EventRequest resolveReference(com.sun.jdi.ReferenceType refType)
                                                     throws ResolveException
Resolve against the given ReferenceType. If successful, return the new event request.
Overrides:
resolveReference in class ResolvableBreakpoint
Parameters:
refType - ReferenceType against which to resolve.
Returns:
event request, or null if not resolved.
Throws:
ResolveException - Thrown if breakpoint resolve fails.

toString

public java.lang.String toString(boolean terse)
Returns a String representation of this.
Parameters:
terse - true to keep the description terse.

toString

public java.lang.String toString()
Returns a String representation of this.
Overrides:
toString in class java.lang.Object