Interface IJavaExceptionBreakpoint

All Superinterfaces:
org.eclipse.core.runtime.IAdaptable, org.eclipse.debug.core.model.IBreakpoint, IJavaBreakpoint, org.eclipse.debug.core.model.ITriggerPoint

public interface IJavaExceptionBreakpoint extends IJavaBreakpoint
A breakpoint that suspends execution when a corresponding exception is thrown in a target VM. An exception breakpoint can be configured to suspend execution when the corresponding exception is thrown in a caught or uncaught location. As well, the location can be filtered inclusively or exclusively by type name patterns.
Since:
2.0
Restriction:
This interface is not intended to be implemented by clients.
Restriction:
This interface is not intended to be extended by clients.
  • Method Details

    • setInclusionFilters

      void setInclusionFilters(String[] filters) throws org.eclipse.core.runtime.CoreException
      Sets the inclusion filters that will define the scope for the associated exception. Filters are a collection of strings of type name prefixes. Default packages should be specified as the empty string.
      Parameters:
      filters - the array of filters to apply
      Throws:
      org.eclipse.core.runtime.CoreException - if unable to set the property on this breakpoint's underlying marker
      Since:
      2.1
    • getInclusionFilters

      String[] getInclusionFilters() throws org.eclipse.core.runtime.CoreException
      Returns the inclusive filters that define the scope for the associated exception. Filters are a collection of strings of type name prefixes.
      Returns:
      the array of defined inclusive filters
      Throws:
      org.eclipse.core.runtime.CoreException - if unable to access the property on this breakpoint's underlying marker
      Since:
      2.1
    • isCaught

      boolean isCaught() throws org.eclipse.core.runtime.CoreException
      Returns whether this breakpoint suspends execution when the associated exception is thrown in a caught location (in a try/catch statement).
      Returns:
      true if this is a caught exception breakpoint
      Throws:
      org.eclipse.core.runtime.CoreException - if unable to access the property from this breakpoint's underlying marker
    • isUncaught

      boolean isUncaught() throws org.eclipse.core.runtime.CoreException
      Returns whether this breakpoint suspends execution when the associated exception is thrown in an uncaught location (not caught by a try/catch statement).
      Returns:
      true if this is an uncaught exception breakpoint.
      Throws:
      org.eclipse.core.runtime.CoreException - if unable to access the property from this breakpoint's underlying marker
    • setCaught

      void setCaught(boolean caught) throws org.eclipse.core.runtime.CoreException
      Sets whether this breakpoint suspends execution when the associated exception is thrown in a caught location (in a try/catch statement).
      Parameters:
      caught - whether or not this breakpoint suspends execution when the associated exception is thrown in a caught location
      Throws:
      org.eclipse.core.runtime.CoreException - if unable to set the property on this breakpoint's underlying marker
    • setUncaught

      void setUncaught(boolean uncaught) throws org.eclipse.core.runtime.CoreException
      Sets whether this breakpoint suspends execution when the associated exception is thrown in an uncaught location.
      Parameters:
      uncaught - whether or not this breakpoint suspends execution when the associated exception is thrown in an uncaught location
      Throws:
      org.eclipse.core.runtime.CoreException - if unable to set the property on this breakpoint's underlying marker
    • isChecked

      boolean isChecked() throws org.eclipse.core.runtime.CoreException
      Returns whether the exception associated with this breakpoint is a checked exception (compiler detected).
      Returns:
      true if the exception associated with this breakpoint is a checked exception
      Throws:
      org.eclipse.core.runtime.CoreException - if unable to access the property from this breakpoint's underlying marker
    • getExceptionTypeName

      String getExceptionTypeName()
      Returns the fully qualified type name of the exception that last caused this breakpoint to suspend, of null if this breakpoint has not caused a thread to suspend. Note that this name may be a sub type of the exception that this breakpoint is associated with.
      Returns:
      fully qualified exception name or null
    • setFilters

      @Deprecated void setFilters(String[] filters, boolean inclusive) throws org.eclipse.core.runtime.CoreException
      Deprecated.
      Exception breakpoints can have a mixed set of filters. Use setInclusiveFilters(String[] filters) or setExclusiveFilters(String[] filters)
      Sets the filters that will define the scope for the associated exception. Filters are a collection of strings of type name prefixes. Default packages should be specified as the empty string.
      Parameters:
      filters - the array of filters to apply
      inclusive - whether or not to apply the filters as inclusive or exclusive
      Throws:
      org.eclipse.core.runtime.CoreException - if unable to set the property on this breakpoint's underlying marker
    • setExclusionFilters

      void setExclusionFilters(String[] filters) throws org.eclipse.core.runtime.CoreException
      Sets the exclusion filters that will define the scope for the associated exception. Filters are a collection of strings of type name prefixes. Default packages should be specified as the empty string.
      Parameters:
      filters - the array of filters to apply
      Throws:
      org.eclipse.core.runtime.CoreException - if unable to set the property on this breakpoint's underlying marker
      Since:
      2.1
    • getFilters

      @Deprecated String[] getFilters() throws org.eclipse.core.runtime.CoreException
      Deprecated.
      Use getExclusionFilters() or getInclusionFilters()
      Returns the filters that define the scope for the associated exception. Filters are a collection of strings of type name prefixes.
      Returns:
      the array of defined filters
      Throws:
      org.eclipse.core.runtime.CoreException - if unable to access the property on this breakpoint's underlying marker
    • getExclusionFilters

      String[] getExclusionFilters() throws org.eclipse.core.runtime.CoreException
      Returns the exclusive filters that define the scope for the associated exception. Filters are a collection of strings of type name prefixes.
      Returns:
      the array of defined inclusive filters
      Throws:
      org.eclipse.core.runtime.CoreException - if unable to access the property on this breakpoint's underlying marker
      Since:
      2.1
    • isInclusiveFiltered

      @Deprecated boolean isInclusiveFiltered() throws org.eclipse.core.runtime.CoreException
      Deprecated.
      Exception breakpoints can have a mixed set of filters and this method is maintained strictly for API backwards compatibility
      Returns whether any inclusive filters have been applied.
      Returns:
      true if the inclusive filters have been applied
      Throws:
      org.eclipse.core.runtime.CoreException - if unable to access the property on this breakpoint's underlying marker
    • setSuspendOnRecurrenceStrategy

      void setSuspendOnRecurrenceStrategy(IJavaExceptionBreakpoint.SuspendOnRecurrenceStrategy strategy) throws org.eclipse.core.runtime.CoreException
      Define this breakpoint's strategy for suspending on recurrences of the same exception instance.
      Parameters:
      strategy - the new strategy
      Throws:
      org.eclipse.core.runtime.CoreException - if accessing the breakpoint's marker failed
      Since:
      3.14
      See Also:
    • getSuspendOnRecurrenceStrategy

      IJavaExceptionBreakpoint.SuspendOnRecurrenceStrategy getSuspendOnRecurrenceStrategy() throws org.eclipse.core.runtime.CoreException
      Answer this breakpoint's strategy for suspending on recurrences of the same exception instance.
      Returns:
      the strategy
      Throws:
      org.eclipse.core.runtime.CoreException - if accessing the breakpoint's marker failed
      Since:
      3.14
      See Also: