com.newrelic.agent.tracers

Class ClassMethodSignature

java.lang.Object

com.newrelic.agent.tracers.ClassMethodSignature

public final class ClassMethodSignature
extends java.lang.Object

When an instrumented method is invoked, this object is created to track the original class/method signature that was instrumented. The class name of the signature might differ from the class name of the actual invoked object, typically the case when the instrumented signature is an interface or a superclass. This class is performance sentitive and its state is immutable. Don't modify this class unless you understand the implications. If possible, we try to cache and reuse instances of this class.

Constructor Summary

Constructors

Constructor and Description
ClassMethodSignature(java.lang.String className, java.lang.String methodName, java.lang.String methodDesc) Creates a class method signature.

Method Summary

Modifier and Type	Method and Description
boolean	equals(java.lang.Object obj)
java.lang.String	getClassName() Returns the class name that was instrumented, which is not necessarily the class name of the object being invoked.
java.lang.String	getMethodDesc()
java.lang.String	getMethodName()
MetricNameFormat	getMetricNameFormat(java.lang.String targetClassName, int flags)
int	hashCode()
ClassMethodSignature	intern()
java.lang.String	toString()

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Constructor Detail

ClassMethodSignature

public ClassMethodSignature(java.lang.String className,
                            java.lang.String methodName,
                            java.lang.String methodDesc)

Creates a class method signature. The class name must be the dot separated name, ie java.lang.List, NOT the internal name. Performance note: method names and method descriptors are defined as constants in classes, so they can be interned without using additional perm gen memory (there's still some overhead in the intern lookup). The internal class name (the forward slash delimited name) is also a constant. I'm almost certain the '.' delimited name is also interned. It's not a constant in the class file, but it may be that the class loaders intern it. As I ran a test in which I changed our primary class transformer to convert every internal class name to the dot delimited version and interned that string. It had no effect on the perm gen heap, which indicates the string is already interned. Besides, we often inject the dot delimited name into classes, so it will appear in the consts table.

Parameters:

className - The dot separated class name, not the internal class name.

methodName -

methodDesc -

Method Detail

getClassName

public java.lang.String getClassName()

Returns the class name that was instrumented, which is not necessarily the class name of the object being invoked. The servlet tracer, for example, will return GenericServlet for the class name of all instrumented servlets.

getMethodName

public java.lang.String getMethodName()

getMethodDesc

public java.lang.String getMethodDesc()

toString

public java.lang.String toString()

Overrides:

toString in class java.lang.Object

hashCode

public int hashCode()

Overrides:

hashCode in class java.lang.Object

equals

public boolean equals(java.lang.Object obj)

Overrides:

equals in class java.lang.Object

intern

public ClassMethodSignature intern()

getMetricNameFormat

public MetricNameFormat getMetricNameFormat(java.lang.String targetClassName,
                                            int flags)