Interface IBslExceptionBreakpoint

  • All Superinterfaces:
    org.eclipse.core.runtime.IAdaptable, org.eclipse.debug.core.model.IBreakpoint, IBslBreakpoint

    public interface IBslExceptionBreakpoint
    extends IBslBreakpoint
    BSL exception breakpoint. This breakpoint suspends execution when a corresponding exception is thrown in a 1C:Enterprise runtime debug process.

    Clients may use IBslBreakpointFactory to create instances of BSL breakpoints.

    • Field Summary

      Fields 
      Modifier and Type Field Description
      static String ALL_EXCEPTIONS
      Breakpoint attribute storing a breakpoint's all exceptions catching state.
      static String EXCEPTION_MESSAGE
      Breakpoint attribute storing a breakpoint's exception message.
      static String MARKER_TYPE
      Marker type for this breakpoint.
      • Fields inherited from interface org.eclipse.debug.core.model.IBreakpoint

        BREAKPOINT_MARKER, ENABLED, ID, LINE_BREAKPOINT_MARKER, PERSISTED, REGISTERED
    • Method Summary

      All Methods Instance Methods Abstract Methods 
      Modifier and Type Method Description
      String getExceptionMessage()
      Returns the exception message associated with this breakpoint, or null if this breakpoint does not have a exception message.
      boolean isCatchAllExceptions()
      Returns whether all exceptions will be caught by this breakpoint.
      void setCatchAllExceptions​(boolean allExceptions)
      Sets all exceptions catching state of this breakpoint's condition to the given state.
      void setExceptionMessage​(String exceptionMessage)
      Sets the exception message associated with this breakpoint.
      • Methods inherited from interface org.eclipse.core.runtime.IAdaptable

        getAdapter
      • Methods inherited from interface org.eclipse.debug.core.model.IBreakpoint

        delete, getMarker, getModelIdentifier, isEnabled, isPersisted, isRegistered, setEnabled, setMarker, setPersisted, setRegistered
    • Field Detail

      • EXCEPTION_MESSAGE

        static final String EXCEPTION_MESSAGE
        Breakpoint attribute storing a breakpoint's exception message. This attribute is stored as a String.
        See Also:
        Constant Field Values
      • ALL_EXCEPTIONS

        static final String ALL_EXCEPTIONS
        Breakpoint attribute storing a breakpoint's all exceptions catching state. This attribute is stored as an boolean.
        See Also:
        Constant Field Values
    • Method Detail

      • getExceptionMessage

        String getExceptionMessage()
                            throws org.eclipse.core.runtime.CoreException
        Returns the exception message associated with this breakpoint, or null if this breakpoint does not have a exception message.
        Returns:
        this breakpoint's exception message, or null
        Throws:
        org.eclipse.core.runtime.CoreException - if unable to access the property on this breakpoint's underlying marker
      • setExceptionMessage

        void setExceptionMessage​(String exceptionMessage)
                          throws org.eclipse.core.runtime.CoreException
        Sets the exception message associated with this breakpoint. Setting the exception message to null or an empty string removes the exception message.

        If this breakpoint does catch all exceptions, setting the exception message has no effect.

        Parameters:
        exceptionMessage - exception message
        Throws:
        org.eclipse.core.runtime.CoreException - if unable to set the property on this breakpoint's underlying marker
      • isCatchAllExceptions

        boolean isCatchAllExceptions()
                              throws org.eclipse.core.runtime.CoreException
        Returns whether all exceptions will be caught by this breakpoint.
        Returns:
        whether all exceptions will be caught by this breakpoint
        Throws:
        org.eclipse.core.runtime.CoreException - if unable to access the property on this breakpoint's underlying marker
      • setCatchAllExceptions

        void setCatchAllExceptions​(boolean allExceptions)
                            throws org.eclipse.core.runtime.CoreException
        Sets all exceptions catching state of this breakpoint's condition to the given state. When enabled, tall exceptions will be caught by this breakpoint. When disabled, this breakpoint will suspend only for associated exception messages.
        Parameters:
        allExceptions - new all exceptions catching state
        Throws:
        org.eclipse.core.runtime.CoreException - if unable to set the property on this breakpoint's underlying marker