Interface IDebugTargetsConfigure

  • All Known Subinterfaces:
    IRuntimeDebugClientTarget
    All Known Implementing Classes:
    ProfilingRuntimeDebugClientTarget, com._1c.g5.v8.dt.internal.debug.core.model.RuntimeDebugClientTarget

    public interface IDebugTargetsConfigure
    Provides the ability to configure debug area (types of debug targets) of an execution context - for example, a thread or debug target.

    Clients may implement this interface. The G5-V8-DT debug platform extension provides a debug area configure action that delegates to this handler interface. As well, the debug platform provides an implementation of the debug area configure handler registered as an adapter on objects that implement IDebugTargetsConfigure.

    • Method Detail

      • canConfigure

        boolean canConfigure()
        Returns whether this element can currently configure debug areas.
        Returns:
        whether this element can currently configure debug areas
      • getDebugAreaName

        String getDebugAreaName()
        Returns current 1C:Enterprise Runtime debug area name. Can return null if no areas is currently chosen by debug process.
        Returns:
        current 1C:Enterprise Runtime debug area name, or null if there isn't one
      • configureDebugArea

        void configureDebugArea​(DebugAreaInfo area)
                         throws org.eclipse.debug.core.DebugException
        Configures target execution context with given 1C:Enterprise Runtime debug area instance. Clients may pass null as area to force debug process to disable 1C:Enterprise Runtime debug area usage.

        Implementation is intended to use only 1C:Enterprise Runtime debug targets that matches with given debug area.

        Parameters:
        area - debug area to configure, or null to disable debug area usage
        Throws:
        org.eclipse.debug.core.DebugException - if configure request fails
      • getDebugAreas

        List<DebugAreaInfo> getDebugAreas()
                                   throws org.eclipse.debug.core.DebugException
        Returns list of all existing 1C:Enterprise Runtime debug areas.
        Parameters:
        list - of debug area in target 1C:Enterprise Runtime debug server, never null
        Throws:
        org.eclipse.debug.core.DebugException - if get request fails
      • setDebugAreas

        void setDebugAreas​(List<DebugAreaInfo> areas)
                    throws org.eclipse.debug.core.DebugException
        Set list of all existing 1C:Enterprise Runtime debug areas.
        Parameters:
        areas - list of debug area to set in target 1C:Enterprise Runtime debug server, cannot be null
        Throws:
        org.eclipse.debug.core.DebugException - if set request fails
      • getAutoconnectDebugTargets

        List<DebugTargetType> getAutoconnectDebugTargets()
                                                  throws org.eclipse.debug.core.DebugException
        Get list 1C:Enterprise Runtime debug targets for auto-connection.
        Returns:
        list 1C:Enterprise Runtime debug targets for auto-connection, never null
        Throws:
        org.eclipse.debug.core.DebugException - if get fails
      • setAutoconnectDebugTargets

        void setAutoconnectDebugTargets​(List<DebugTargetType> debugTargets)
                                 throws org.eclipse.debug.core.DebugException
        Set list 1C:Enterprise Runtime debug targets for auto-connection.
        Parameters:
        debugTargets - list 1C:Enterprise Runtime debug targets for auto-connection, cannot be null
        Throws:
        org.eclipse.debug.core.DebugException - if set fails