1 IExecutionDataAccessorGenerator
被 instrument 的类需要一段代码,该代码从运行时获取 boolean[]实例。 该机制是针对于运行时的,因此由该接口抽象。 实现由 IRuntime 实现提供,并由 instrumentation process过程使用。
唯一方法
代码语言:javascript复制 /**
* 此方法生成获得具有给定id的类的coverage数据结构所需的字节码。 通常,instrumentation 过程会将此代码嵌入到在类初始化时调用的方法中。甚至可以在目标VM外部随时调用此方法。
*
* 生成的代码必须将 boolean[] 实例推入操作数栈。 除此结果对象外,生成的代码不得对嵌入方法或类的结构进行任何假设。 生成的代码不得使用或分配局部变量。
*
* @param classid
* @param classname
* VM class name
* @param probecount
* probe count for this class
* @param mv
* code output
* @return additional stack size required by the implementation, including
* the instance pushed to the stack
*/
int generateDataAccessor(long classid, String classname, int probecount,
MethodVisitor mv);
IRuntime 实现类
代码语言:javascript复制package org.jacoco.core.runtime;
/**
* 此接口表示一种特定的机制,用于在运行时收集目标VM中的执行信息。
*/
public interface IRuntime extends IExecutionDataAccessorGenerator {
/**
* start coverage runtime.
* This method MUST be called before any class instrumented for this runtime is loaded.
* 必须在加载为此运行时检测到的任何类之前调用此方法。
*
* @param data
* the execution data for this runtime
* @throws Exception
* any internal problem during startup
*/
void startup(RuntimeData data) throws Exception;
/**
* Allows the coverage runtime to cleanup internals. This class should be
* called when classes instrumented for this runtime are not used any more.
* 允许coverage运行时清理内部。 当不再使用为此运行时检测的类时,应调用该类。
*/
void shutdown();
}