org.cojen.dirmi.trace

Class TraceAgent

java.lang.Object

org.cojen.dirmi.trace.TraceAgent

public class TraceAgent
extends Object

Instrumentation agent for tracing. To install, pass a java argument as follows:

 java -javaagent:<path to agent jar file>=<class name of trace handler>[;<argument>]
 

For example:

 java -javaagent:dirmi-1.0.jar=org.cojen.dirmi.trace.SimpleHandler ...
 

Handlers may accept a single string argument, provided after the handler name, separated by a semi-colon.

Author:

Brian S O'Neill

See Also:

Trace, TraceHandler

Method Summary

Modifier and Type	Method and Description
long	getAgentId()
static TraceAgent	getTraceAgent(long id) Method called by instrumented class to get reference to agent.
TraceHandler	getTraceHandler() Method called by instrumented class to get the trace handler.
static void	premain(String agentArgs, Instrumentation inst) Premain method, as required by instrumentation agents.
void	registerTraceMethod(int mid, String operation, Class clazz, String methodName, Class returnType, Class... paramTypes) Method called by instrumented class to register traced methods.

Methods inherited from class java.lang.Object

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

Method Detail

premain

public static void premain(String agentArgs,
                           Instrumentation inst)
                    throws Throwable

Premain method, as required by instrumentation agents.

Parameters:

agentArgs - specify trace handler class name

inst - instrumentation instance passed in by JVM

Throws:

Throwable

See Also:

TraceHandler

getTraceAgent

public static TraceAgent getTraceAgent(long id)

Method called by instrumented class to get reference to agent.

getTraceHandler

public TraceHandler getTraceHandler()

Method called by instrumented class to get the trace handler.

registerTraceMethod

public void registerTraceMethod(int mid,
                                String operation,
                                Class clazz,
                                String methodName,
                                Class returnType,
                                Class... paramTypes)

Method called by instrumented class to register traced methods.

getAgentId

public long getAgentId()