Class LoggerRuntime

java.lang.Object
org.jacoco.core.runtime.AbstractRuntime
org.jacoco.core.runtime.LoggerRuntime
All Implemented Interfaces:
IExecutionDataAccessorGenerator, IRuntime

public class LoggerRuntime extends AbstractRuntime
This IRuntime implementation uses the Java logging API to report coverage data.

The implementation uses a dedicated log channel. Instrumented classes call Logger.log(Level, String, Object[]) with the class identifier in the first slot of the parameter array. The runtime implements a Handler for this channel that puts the probe data structure into the first slot of the parameter array.

  • Field Details

  • Constructor Details

    • LoggerRuntime

      public LoggerRuntime()
      Creates a new runtime.
  • Method Details

    • configureLogger

      private Logger configureLogger()
    • generateDataAccessor

      public int generateDataAccessor(long classid, String classname, int probecount, org.objectweb.asm.MethodVisitor mv)
      Description copied from interface: IExecutionDataAccessorGenerator
      This method generates the byte code required to obtain the coverage data structure for the class with the given id. Typically the instrumentation process will embed this code into a method that is called on class initialization. This method can be called at any time even outside the target VM. The generated code must push a boolean[] instance to the operand stack. Except this result object the generated code must not make any assumptions about the structure of the embedding method or class. The generated code must not use or allocate local variables.
      Parameters:
      classid - identifier of the class
      classname - VM class name
      probecount - probe count for this class
      mv - code output
      Returns:
      additional stack size required by the implementation, including the instance pushed to the stack
    • startup

      public void startup(RuntimeData data) throws Exception
      Description copied from class: AbstractRuntime
      Subclasses must call this method when overwriting it.
      Specified by:
      startup in interface IRuntime
      Overrides:
      startup in class AbstractRuntime
      Parameters:
      data - the execution data for this runtime
      Throws:
      Exception - any internal problem during startup
    • shutdown

      public void shutdown()
      Description copied from interface: IRuntime
      Allows the coverage runtime to cleanup internals. This class should be called when classes instrumented for this runtime are not used any more.