Class ImportDebugTrace

  • All Implemented Interfaces:
    EventListener, org.eclipse.osgi.service.debug.DebugOptionsListener, org.eclipse.osgi.service.debug.DebugTrace

    public class ImportDebugTrace
    extends Object
    implements org.eclipse.osgi.service.debug.DebugOptionsListener, org.eclipse.osgi.service.debug.DebugTrace
    Import debug options manager
    • Field Detail

      • IMPORT_PERFORMANCE_TRACE_OPTION

        public static final String IMPORT_PERFORMANCE_TRACE_OPTION
        Trace option constant for Import performance
        See Also:
        Constant Field Values
    • Method Detail

      • getDebugTrace

        public org.eclipse.osgi.service.debug.DebugTrace getDebugTrace()
        Import plugin DebugTrace instance
        Returns:
        DebugTrace instance, can be null if this manager not initiated
      • optionsChanged

        public void optionsChanged​(org.eclipse.osgi.service.debug.DebugOptions options)
        Specified by:
        optionsChanged in interface org.eclipse.osgi.service.debug.DebugOptionsListener
      • startPerformanceMeasurements

        public void startPerformanceMeasurements​(Object measurementsId)
        Start performance measurements if trace and option is active
        Parameters:
        measurementsId - the id of measurement, cannot be null
      • stopPerformanceMeasurements

        public void stopPerformanceMeasurements​(Object measurementsId,
                                                String messagePattern,
                                                TimeUnit timeUnit)
        Start and trace performance measurements by specified id if trace and option is active
        Parameters:
        measurementsId - the id of measurement, cannot be null
        messagePattern - the trace message, use {0} to insert performance value, cannot be null
        timeUnit - to trace performance value in desired units, cannot be null
      • trace

        public void trace​(String option,
                          String message)
        Specified by:
        trace in interface org.eclipse.osgi.service.debug.DebugTrace
      • trace

        public void trace​(String option,
                          String message,
                          Throwable error)
        Specified by:
        trace in interface org.eclipse.osgi.service.debug.DebugTrace
      • traceDumpStack

        public void traceDumpStack​(String option)
        Specified by:
        traceDumpStack in interface org.eclipse.osgi.service.debug.DebugTrace
      • traceEntry

        public void traceEntry​(String option)
        Specified by:
        traceEntry in interface org.eclipse.osgi.service.debug.DebugTrace
      • traceEntry

        public void traceEntry​(String option,
                               Object methodArgument)
        Specified by:
        traceEntry in interface org.eclipse.osgi.service.debug.DebugTrace
      • traceEntry

        public void traceEntry​(String option,
                               Object[] methodArguments)
        Specified by:
        traceEntry in interface org.eclipse.osgi.service.debug.DebugTrace
      • traceExit

        public void traceExit​(String option)
        Specified by:
        traceExit in interface org.eclipse.osgi.service.debug.DebugTrace
      • traceExit

        public void traceExit​(String option,
                              Object result)
        Specified by:
        traceExit in interface org.eclipse.osgi.service.debug.DebugTrace
      • traceExit

        public void traceExit​(String option,
                              org.eclipse.core.runtime.IStatus status)
        Intercept traceExit(String, Object) method for IStatus type of result param to simplify output of long multi status representation.
        Parameters:
        option - The name of the boolean option that will control whether the trace statement is printed (e.g., "/debug/myComponent"), or null
        result - The IStatus result object being returned from the method that was executed