com.newrelic.agent.instrumentation.weaver

Class ClassWeaverService

java.lang.Object

com.newrelic.agent.instrumentation.weaver.ClassWeaverService

All Implemented Interfaces:

ClassMatchVisitorFactory, ContextClassTransformer

public class ClassWeaverService
extends java.lang.Object
implements ClassMatchVisitorFactory, ContextClassTransformer

All interfacing with the weaver is done here.

Field Summary

Fields inherited from interface com.newrelic.agent.instrumentation.context.ClassMatchVisitorFactory

NO_OP_FACTORY

Constructor Summary

Constructors

Constructor and Description
ClassWeaverService(java.lang.instrument.Instrumentation instrumentation)

Method Summary

Modifier and Type	Method and Description
static void	addTraceInformation(java.util.concurrent.ConcurrentMap<java.lang.String,java.util.Set<TracedWeaveInstrumentationTracker>> weaveTraceDetailsTrackers, java.lang.String weavePackageName, InstrumentationContext context, org.objectweb.asm.tree.ClassNode composite, java.lang.String originalClassName) For every tracer that originated from weaved code: Add WeaveInstrumentation info to the context Remove the tracer from the composite method
java.lang.Runnable	createRetransformRunnable(java.lang.Class<?>[] loadedClasses)
com.newrelic.weave.weavepackage.WeavePackageManager	getWeavePackageManger()
org.objectweb.asm.ClassVisitor	newClassMatchVisitor(java.lang.ClassLoader loader, java.lang.Class<?> classBeingRedefined, org.objectweb.asm.ClassReader reader, org.objectweb.asm.ClassVisitor cv, InstrumentationContext context) Returns a chaining class visitor that applies matching logic to the class referenced by the class reader and classBeingRedefined.
void	registerInstrumentation() Registers the weave instrumentation jars that are packaged into the agent jar's instrumentation directory and present in the extension directory.
void	registerInstrumentationCloseable(java.lang.String instrumentationName, java.io.Closeable closeable) Register a closable which will run if/when a WeavePackage is deregistered.
void	registerSecurityInstrumentation() Registers the security weave instrumentation jars that are packaged into the Security agent jar's instrumentation directory.
java.lang.Runnable	reloadExternalWeavePackages(java.util.Collection<java.io.File> newWeaveExtensions, java.util.Collection<java.io.File> removedWeaveExtensions) Given a set of weave extensions, this method loads them, validates them and provides a runnable which will retransform any classes that match any old or new instrumentation.
byte[]	transform(java.lang.ClassLoader loader, java.lang.String className, java.lang.Class<?> classBeingRedefined, java.security.ProtectionDomain protectionDomain, byte[] classfileBuffer, InstrumentationContext context, OptimizedClassMatcher.Match match)

Methods inherited from class java.lang.Object

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

Constructor Detail

ClassWeaverService

public ClassWeaverService(java.lang.instrument.Instrumentation instrumentation)

Method Detail

registerInstrumentation

public void registerInstrumentation()

Registers the weave instrumentation jars that are packaged into the agent jar's instrumentation directory and present in the extension directory.

registerSecurityInstrumentation

public void registerSecurityInstrumentation()

Registers the security weave instrumentation jars that are packaged into the Security agent jar's instrumentation directory.

createRetransformRunnable

public java.lang.Runnable createRetransformRunnable(java.lang.Class<?>[] loadedClasses)

registerInstrumentationCloseable

public void registerInstrumentationCloseable(java.lang.String instrumentationName,
                                             java.io.Closeable closeable)

Register a closable which will run if/when a WeavePackage is deregistered.

reloadExternalWeavePackages

public java.lang.Runnable reloadExternalWeavePackages(java.util.Collection<java.io.File> newWeaveExtensions,
                                                      java.util.Collection<java.io.File> removedWeaveExtensions)

Given a set of weave extensions, this method loads them, validates them and provides a runnable which will retransform any classes that match any old or new instrumentation. Any non-instrumentation weave classes will be redefined if they were previously loaded.

Returns:

A runnable to retransform all relevant classes and close any closables

newClassMatchVisitor

public org.objectweb.asm.ClassVisitor newClassMatchVisitor(java.lang.ClassLoader loader,
                                                           java.lang.Class<?> classBeingRedefined,
                                                           org.objectweb.asm.ClassReader reader,
                                                           org.objectweb.asm.ClassVisitor cv,
                                                           InstrumentationContext context)

Description copied from interface: ClassMatchVisitorFactory

Returns a chaining class visitor that applies matching logic to the class referenced by the class reader and classBeingRedefined. The match results are reported in the InstrumentationContext.

Specified by:

newClassMatchVisitor in interface ClassMatchVisitorFactory

transform

public byte[] transform(java.lang.ClassLoader loader,
                        java.lang.String className,
                        java.lang.Class<?> classBeingRedefined,
                        java.security.ProtectionDomain protectionDomain,
                        byte[] classfileBuffer,
                        InstrumentationContext context,
                        OptimizedClassMatcher.Match match)
                 throws java.lang.instrument.IllegalClassFormatException

Specified by:

transform in interface ContextClassTransformer

Throws:

java.lang.instrument.IllegalClassFormatException

addTraceInformation

public static void addTraceInformation(java.util.concurrent.ConcurrentMap<java.lang.String,java.util.Set<TracedWeaveInstrumentationTracker>> weaveTraceDetailsTrackers,
                                       java.lang.String weavePackageName,
                                       InstrumentationContext context,
                                       org.objectweb.asm.tree.ClassNode composite,
                                       java.lang.String originalClassName)

For every tracer that originated from weaved code:

1. Add WeaveInstrumentation info to the context
2. Remove the tracer from the composite method

getWeavePackageManger

public com.newrelic.weave.weavepackage.WeavePackageManager getWeavePackageManger()