com.newrelic.agent

Class InstrumentationProxy

java.lang.Object

com.newrelic.agent.util.DelegatingInstrumentation

com.newrelic.agent.util.InstrumentationWrapper

com.newrelic.agent.InstrumentationProxy

All Implemented Interfaces:

java.lang.instrument.Instrumentation

public class InstrumentationProxy
extends InstrumentationWrapper

This interface wraps the normal Instrumentation interface and adds a few extra methods. In previous agent versions it was used to create a consistent api across Java 5/6, but now it's kind of useless. We could remove this class and move most of the logic it contains to a static helper.

Field Summary

Fields inherited from class com.newrelic.agent.util.DelegatingInstrumentation

delegate

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	InstrumentationProxy(java.lang.instrument.Instrumentation instrumentation, boolean enableBootstrapClassInstrumentationDefault)

Method Summary

Modifier and Type	Method and Description
static void	forceRedefinition(java.lang.instrument.Instrumentation instrumentation, java.lang.Class<?>... classes) The InstrumentationWrapper.retransformClasses(Class...) method is known to ignore retransform requests for bootstrap classes.
int	getClassReaderFlags()
protected java.lang.instrument.Instrumentation	getInstrumentation()
static InstrumentationProxy	getInstrumentationProxy(java.lang.instrument.Instrumentation inst)
boolean	isAppendToClassLoaderSearchSupported()
boolean	isBootstrapClassInstrumentationEnabled() Returns true if instrumentation should be turned on for bootstrap classes.
void	redefineClasses(java.lang.instrument.ClassDefinition... definitions)
java.lang.Class<?>[]	retransformUninstrumentedClasses(java.lang.String... classNames)

Methods inherited from class com.newrelic.agent.util.InstrumentationWrapper

retransformClasses

Methods inherited from class com.newrelic.agent.util.DelegatingInstrumentation

addTransformer, addTransformer, appendToBootstrapClassLoaderSearch, appendToSystemClassLoaderSearch, getAllLoadedClasses, getInitiatedClasses, getObjectSize, isModifiableClass, isNativeMethodPrefixSupported, isRedefineClassesSupported, isRetransformClassesSupported, removeTransformer, setNativeMethodPrefix

Methods inherited from class java.lang.Object

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

Constructor Detail

InstrumentationProxy

protected InstrumentationProxy(java.lang.instrument.Instrumentation instrumentation,
                               boolean enableBootstrapClassInstrumentationDefault)

Method Detail

getInstrumentationProxy

public static InstrumentationProxy getInstrumentationProxy(java.lang.instrument.Instrumentation inst)

getInstrumentation

protected java.lang.instrument.Instrumentation getInstrumentation()

redefineClasses

public void redefineClasses(java.lang.instrument.ClassDefinition... definitions)
                     throws java.lang.ClassNotFoundException,
                            java.lang.instrument.UnmodifiableClassException

Specified by:

redefineClasses in interface java.lang.instrument.Instrumentation

Overrides:

redefineClasses in class InstrumentationWrapper

Throws:

java.lang.ClassNotFoundException

java.lang.instrument.UnmodifiableClassException

retransformUninstrumentedClasses

public java.lang.Class<?>[] retransformUninstrumentedClasses(java.lang.String... classNames)
                                                      throws java.lang.instrument.UnmodifiableClassException,
                                                             java.lang.ClassNotFoundException

Throws:

java.lang.instrument.UnmodifiableClassException

java.lang.ClassNotFoundException

getClassReaderFlags

public int getClassReaderFlags()

isBootstrapClassInstrumentationEnabled

public final boolean isBootstrapClassInstrumentationEnabled()

Returns true if instrumentation should be turned on for bootstrap classes. This can be controlled with the agent configuration switch 'enable_bootstrap_class_instrumentation'.

isAppendToClassLoaderSearchSupported

public boolean isAppendToClassLoaderSearchSupported()

forceRedefinition

public static void forceRedefinition(java.lang.instrument.Instrumentation instrumentation,
                                     java.lang.Class<?>... classes)
                              throws java.lang.ClassNotFoundException,
                                     java.lang.instrument.UnmodifiableClassException

The InstrumentationWrapper.retransformClasses(Class...) method is known to ignore retransform requests for bootstrap classes. A call to redefineClasses(ClassDefinition...) with the original class bytes seems to trigger the retransform, and that's what this method does.

Throws:

java.lang.ClassNotFoundException

java.lang.instrument.UnmodifiableClassException