org.jacoco.agent.rt

Class JacocoAgent

java.lang.Object

org.jacoco.agent.rt.JacocoAgent

public class JacocoAgent
extends Object

The agent which is referred as the Premain-Class.

Constructor Summary

Constructors

Constructor and Description
JacocoAgent(AgentOptions options, IExceptionLogger logger) Creates a new agent with the given agent options.
JacocoAgent(String options, IExceptionLogger logger) Creates a new agent with the given agent options string.

Method Summary

Methods

Modifier and Type	Method and Description
protected IAgentController	createAgentController() Create controller implementation as given by the agent options.
protected IRuntime	createRuntime(Instrumentation inst) Creates the specific coverage runtime implementation.
void	init(Instrumentation inst) Initializes this agent.
static void	premain(String options, Instrumentation inst) This method is called by the JVM to initialize Java agents.
void	shutdown() Shutdown the agent again.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

JacocoAgent

public JacocoAgent(AgentOptions options,
           IExceptionLogger logger)

Creates a new agent with the given agent options.

Parameters:

options - agent options

logger - logger used by this agent

JacocoAgent

public JacocoAgent(String options,
           IExceptionLogger logger)

Creates a new agent with the given agent options string.

Parameters:

options - agent options as text string

logger - logger used by this agent

Method Detail

init

public void init(Instrumentation inst)
          throws Exception

Initializes this agent.

Parameters:

inst - instrumentation services

Throws:

Exception - internal startup problem

createAgentController

protected IAgentController createAgentController()

Create controller implementation as given by the agent options.

Returns:

configured controller implementation

createRuntime

protected IRuntime createRuntime(Instrumentation inst)
                          throws Exception

Creates the specific coverage runtime implementation.

Parameters:

inst - instrumentation services

Returns:

coverage runtime instance

Throws:

Exception - creation problem

shutdown

public void shutdown()

Shutdown the agent again.

premain

public static void premain(String options,
           Instrumentation inst)
                    throws Exception

This method is called by the JVM to initialize Java agents.

Parameters:

options - agent options

inst - instrumentation callback provided by the JVM

Throws:

Exception - in case initialization fails