com.newrelic.agent.instrumentation

Interface ClassTransformerService

All Superinterfaces:

Service

All Known Implementing Classes:

ClassTransformerServiceImpl

public interface ClassTransformerService
extends Service

Method Summary

Modifier and Type	Method and Description
boolean	addTraceMatcher(ClassAndMethodMatcher matcher, java.lang.String metricPrefix) Add a matcher that will match class/methods which should be traced.
void	checkShutdown()
PointCutClassTransformer	getClassTransformer()
InstrumentationContextManager	getContextManager()
java.lang.instrument.Instrumentation	getExtensionInstrumentation() Returns an Instrumentation instance that inserts added class transformers before the agent's class transformers.
ClassRetransformer	getLocalRetransformer()
ClassRetransformer	getRemoteRetransformer()
void	retransformMatchingClasses(java.util.Collection<ClassMatchVisitorFactory> classMatchers) Queues the retransformation of loaded classes that match the given class matchers.
void	retransformMatchingClassesImmediately(java.lang.Class<?>[] loadedClasses, java.util.Collection<ClassMatchVisitorFactory> classMatchers) Immediately retransforms the loaded classes that match the given class matchers.

Methods inherited from interface com.newrelic.agent.service.Service

getLogger, getName, isEnabled, isStarted, isStartedOrStarting, isStopped, isStoppedOrStopping, start, stop

Method Detail

getClassTransformer

PointCutClassTransformer getClassTransformer()

getLocalRetransformer

ClassRetransformer getLocalRetransformer()

getRemoteRetransformer

ClassRetransformer getRemoteRetransformer()

checkShutdown

void checkShutdown()

getContextManager

InstrumentationContextManager getContextManager()

addTraceMatcher

boolean addTraceMatcher(ClassAndMethodMatcher matcher,
                        java.lang.String metricPrefix)

Add a matcher that will match class/methods which should be traced.

Returns:

true if the matcher was not previously added

retransformMatchingClasses

void retransformMatchingClasses(java.util.Collection<ClassMatchVisitorFactory> classMatchers)

Queues the retransformation of loaded classes that match the given class matchers.

retransformMatchingClassesImmediately

void retransformMatchingClassesImmediately(java.lang.Class<?>[] loadedClasses,
                                           java.util.Collection<ClassMatchVisitorFactory> classMatchers)

Immediately retransforms the loaded classes that match the given class matchers.

getExtensionInstrumentation

java.lang.instrument.Instrumentation getExtensionInstrumentation()

Returns an Instrumentation instance that inserts added class transformers before the agent's class transformers. This allows extensions to add Trace annotations to class methods and have those annotations be picked up by the agent.