Interface ProcessTracerInterface

All Known Implementing Classes:
LoggingProcessTracer, NoopProcessTracer
public interface ProcessTracerInterface
Interface that can be plugged into the execution of a QProcess, that gets callbacks from QQQ for events in the lifecycle of a process, which one may wish to log or otherwise be aware of.

  • Method Details

    • handleProcessStart

      void handleProcessStart(RunProcessInput runProcessInput)
      Called when a new process is started.

    • handleProcessResume

      void handleProcessResume(RunProcessInput runProcessInput)
      Called when a process is resumed, e.g., after a "break" occurs between backend steps and frontend steps.

    • handleStepStart

      void handleStepStart(RunBackendStepInput runBackendStepInput)
      Called when a (backend) step is started.

    • handleMessage

      void handleMessage(RunBackendStepInput runBackendStepInput, ProcessTracerMessage message)
      Called when the (application, custom) process step code itself decides to trace something. We imagine various subclasses of ProcessTracerMessage to be created, to communicate more specific data for the tracer implementation.

    • handleStepFinish

      void handleStepFinish(RunBackendStepInput runBackendStepInput, RunBackendStepOutput runBackendStepOutput)
      Called when a (backend) step finishes.

    • handleProcessBreak

      void handleProcessBreak(RunProcessInput runProcessInput, RunProcessOutput runProcessOutput, Exception processException)
      Called when a process break occurs, e.g., between backend and frontend steps (but only if there are no more backend steps in the queue).

    • handleProcessFinish

      void handleProcessFinish(RunProcessInput runProcessInput, RunProcessOutput runProcessOutput, Exception processException)
      Called after the last (backend) step of a process.