com.newrelic.agent.instrumentation.context

Class InstrumentationContext

java.lang.Object

com.newrelic.agent.instrumentation.context.InstrumentationContext

All Implemented Interfaces:

TraceDetailsList

public class InstrumentationContext
extends java.lang.Object
implements TraceDetailsList

This class tracks information about a class passing through the InstrumentationContextManager. It keeps track of the methods of the class that have been matched by different class transformers that are registered with the manager.

Field Summary

Fields

Modifier and Type	Field and Description
protected byte[]	bytes

Constructor Summary

Constructors

Constructor and Description
InstrumentationContext(byte[] bytes, java.lang.Class<?> classBeingRedefined, java.security.ProtectionDomain protectionDomain)

Method Summary

Modifier and Type	Method and Description
void	addBridgeMethod(org.objectweb.asm.commons.Method method) Add a bridged method to this context.
void	addClassResolver(ClassResolver classResolver) Adds a class resolver to the current context.
void	addIgnoreApdexMethod(java.lang.String methodName, java.lang.String methodDesc)
void	addIgnoreTransactionMethod(org.objectweb.asm.commons.Method m)
void	addIgnoreTransactionMethod(java.lang.String methodName, java.lang.String methodDesc)
void	addOldInvokerStyleInstrumentationMethod(org.objectweb.asm.commons.Method method, PointCut pointCut)
void	addOldReflectionStyleInstrumentationMethod(org.objectweb.asm.commons.Method method, PointCut pointCut)
void	addScalaFinalField(java.lang.String fieldName)
void	addSkipMethod(org.objectweb.asm.commons.Method method, java.lang.String owningClass)
void	addTimedMethods(org.objectweb.asm.commons.Method... methods) Adds methods that are timed with method tracers.
void	addTrace(org.objectweb.asm.commons.Method method, TraceDetails traceDetails) Adds a method to be traced (timed) by instrumentation injected by the TraceClassVisitor.
void	addTracedMethods(java.util.Map<org.objectweb.asm.commons.Method,TraceDetails> tracedMethods) Adds methods to be traced (timed) by instrumentation injected by the TraceClassVisitor.
void	addWeavedMethod(org.objectweb.asm.commons.Method method, java.lang.String instrumentationTitle) Adds a weaved method.
java.util.Map<org.objectweb.asm.commons.Method,org.objectweb.asm.commons.Method>	getBridgeMethods() Returns a map of bridge methods.
java.lang.Class<?>	getClassBeingRedefined()
java.lang.String	getClassName()
ClassResolver	getClassResolver(java.lang.ClassLoader loader) Returns a class resolver that will delegate to the class resolvers added with addClassResolver(ClassResolver).
java.net.URL	getCodeSourceLocation()
java.lang.String[]	getInterfaces()
java.util.Map<ClassMatchVisitorFactory,OptimizedClassMatcher.Match>	getMatches()
java.util.Collection<java.lang.String>	getMergeInstrumentationPackages(org.objectweb.asm.commons.Method method)
PointCut	getOldStylePointCut(org.objectweb.asm.commons.Method method)
java.security.ProtectionDomain	getProtectionDomain()
java.util.Set<java.lang.String>	getScalaFinalFields()
java.util.Map<org.objectweb.asm.commons.Method,java.util.Collection<java.lang.String>>	getSkipMethods()
java.util.Set<org.objectweb.asm.commons.Method>	getTimedMethods() Returns methods that are timed with instrumentation injected by the new TraceClassVisitor or the old GenericClassAdapter.
TraceInformation	getTraceInformation()
java.util.Set<org.objectweb.asm.commons.Method>	getWeavedMethods()
boolean	hasModifiedClassStructure()
boolean	hasSourceAttribute() Return true if the GeneratedClassDetector found that this class has a source attribute.
boolean	isGenerated() Return true if the GeneratedClassDetector identified this class as a generated class.
boolean	isModified()
boolean	isModified(org.objectweb.asm.commons.Method method)
boolean	isTracerMatch()
boolean	isUsingLegacyInstrumentation()
void	markAsModified()
void	match(java.lang.ClassLoader loader, java.lang.Class<?> classBeingRedefined, org.objectweb.asm.ClassReader reader, java.util.Collection<ClassMatchVisitorFactory> classVisitorFactories)
void	putMatch(ClassMatchVisitorFactory matcher, OptimizedClassMatcher.Match match)
void	putTraceAnnotation(org.objectweb.asm.commons.Method method, TraceDetails traceDetails)
void	setClassName(java.lang.String className)
void	setGenerated(boolean isGenerated)
void	setInterfaces(java.lang.String[] interfaces)
void	setSourceAttribute(boolean hasSource)

Methods inherited from class java.lang.Object

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

Field Detail

bytes

protected final byte[] bytes

Constructor Detail

InstrumentationContext

public InstrumentationContext(byte[] bytes,
                              java.lang.Class<?> classBeingRedefined,
                              java.security.ProtectionDomain protectionDomain)

Method Detail

getInterfaces

public java.lang.String[] getInterfaces()

getClassName

public java.lang.String getClassName()

getClassBeingRedefined

public java.lang.Class<?> getClassBeingRedefined()

getProtectionDomain

public java.security.ProtectionDomain getProtectionDomain()

markAsModified

public void markAsModified()

isModified

public boolean isModified()

getTraceInformation

public TraceInformation getTraceInformation()

isTracerMatch

public boolean isTracerMatch()

addWeavedMethod

public void addWeavedMethod(org.objectweb.asm.commons.Method method,
                            java.lang.String instrumentationTitle)

Adds a weaved method.

Parameters:

instrumentationTitle - The name of the instrumentation package from which the weaved code originated.

addSkipMethod

public void addSkipMethod(org.objectweb.asm.commons.Method method,
                          java.lang.String owningClass)

addScalaFinalField

public void addScalaFinalField(java.lang.String fieldName)

getOldStylePointCut

public PointCut getOldStylePointCut(org.objectweb.asm.commons.Method method)

getWeavedMethods

public java.util.Set<org.objectweb.asm.commons.Method> getWeavedMethods()

getSkipMethods

public java.util.Map<org.objectweb.asm.commons.Method,java.util.Collection<java.lang.String>> getSkipMethods()

getScalaFinalFields

public java.util.Set<java.lang.String> getScalaFinalFields()

getTimedMethods

public java.util.Set<org.objectweb.asm.commons.Method> getTimedMethods()

Returns methods that are timed with instrumentation injected by the new TraceClassVisitor or the old GenericClassAdapter.

getMergeInstrumentationPackages

public java.util.Collection<java.lang.String> getMergeInstrumentationPackages(org.objectweb.asm.commons.Method method)

isModified

public boolean isModified(org.objectweb.asm.commons.Method method)

addTimedMethods

public void addTimedMethods(org.objectweb.asm.commons.Method... methods)

Adds methods that are timed with method tracers.

addOldReflectionStyleInstrumentationMethod

public void addOldReflectionStyleInstrumentationMethod(org.objectweb.asm.commons.Method method,
                                                       PointCut pointCut)

addOldInvokerStyleInstrumentationMethod

public void addOldInvokerStyleInstrumentationMethod(org.objectweb.asm.commons.Method method,
                                                    PointCut pointCut)

getMatches

public java.util.Map<ClassMatchVisitorFactory,OptimizedClassMatcher.Match> getMatches()

putTraceAnnotation

public void putTraceAnnotation(org.objectweb.asm.commons.Method method,
                               TraceDetails traceDetails)

addIgnoreApdexMethod

public void addIgnoreApdexMethod(java.lang.String methodName,
                                 java.lang.String methodDesc)

addIgnoreTransactionMethod

public void addIgnoreTransactionMethod(java.lang.String methodName,
                                       java.lang.String methodDesc)

addIgnoreTransactionMethod

public void addIgnoreTransactionMethod(org.objectweb.asm.commons.Method m)

putMatch

public void putMatch(ClassMatchVisitorFactory matcher,
                     OptimizedClassMatcher.Match match)

setInterfaces

public void setInterfaces(java.lang.String[] interfaces)

setClassName

public void setClassName(java.lang.String className)

addTracedMethods

public void addTracedMethods(java.util.Map<org.objectweb.asm.commons.Method,TraceDetails> tracedMethods)

Adds methods to be traced (timed) by instrumentation injected by the TraceClassVisitor.

addTrace

public void addTrace(org.objectweb.asm.commons.Method method,
                     TraceDetails traceDetails)

Adds a method to be traced (timed) by instrumentation injected by the TraceClassVisitor.

Specified by:

addTrace in interface TraceDetailsList

match

public void match(java.lang.ClassLoader loader,
                  java.lang.Class<?> classBeingRedefined,
                  org.objectweb.asm.ClassReader reader,
                  java.util.Collection<ClassMatchVisitorFactory> classVisitorFactories)

addBridgeMethod

public void addBridgeMethod(org.objectweb.asm.commons.Method method)

Add a bridged method to this context.

See Also:

Opcodes.ACC_BRIDGE

getBridgeMethods

public java.util.Map<org.objectweb.asm.commons.Method,org.objectweb.asm.commons.Method> getBridgeMethods()

Returns a map of bridge methods. The key is the generic method definition from the matchers, and the value is the actual method implementation with generic types. For example, a class may implement List with a specific type of Person. The class will implement a method called add(Person) and the JVM will generate the bridge method add(Object) which will simply invoke add(Person). Generally speaking, we want to be able to create matchers that match the loosely typed version of the method (the signature that's usually a bridge method), but we want to instrument the typed version of the method because it can be invoked directly without passing through the bridge implementation.

isUsingLegacyInstrumentation

public boolean isUsingLegacyInstrumentation()

hasModifiedClassStructure

public boolean hasModifiedClassStructure()

addClassResolver

public void addClassResolver(ClassResolver classResolver)

Adds a class resolver to the current context.

getClassResolver

public ClassResolver getClassResolver(java.lang.ClassLoader loader)

Returns a class resolver that will delegate to the class resolvers added with addClassResolver(ClassResolver). If those fail to resolve the class the given classloader is used.

See Also:

ClassResolvers.getClassLoaderResolver(ClassLoader)

setGenerated

public void setGenerated(boolean isGenerated)

isGenerated

public boolean isGenerated()

Return true if the GeneratedClassDetector identified this class as a generated class.

setSourceAttribute

public void setSourceAttribute(boolean hasSource)

hasSourceAttribute

public boolean hasSourceAttribute()

Return true if the GeneratedClassDetector found that this class has a source attribute. Java class files are not required to have a source attribute. When a class is created by a compiler, the source attribute generally contains the name of the source file. When a class is generated by a bytecode tool, the attribute may contain anything or may be absent.

Returns:

true if a source attribute was found on the class file.

getCodeSourceLocation

public java.net.URL getCodeSourceLocation()