com.appdynamics.instrumentation.sdk.template

Class AGenericInterceptor

java.lang.Object

com.appdynamics.instrumentation.sdk.ASDKPlugin

com.appdynamics.instrumentation.sdk.template.AGenericInterceptor

All Implemented Interfaces:

IRuleAppliable

public abstract class AGenericInterceptor
extends ASDKPlugin

This template is for a "blank slate" interceptor. The agent does not do anything for these interceptors at the start or end of the method other than call into the methods defined by the user. This interceptor can be combined with the legacy SDK to tap into agent transaction/metric/event functionality.

Constructor Summary

Constructors

Constructor and Description
AGenericInterceptor()

Method Summary

Modifier and Type	Method and Description
int	getInterceptorId() Overriden to return interceptor id if implementation on this intended to be used in micro java agent framework
abstract java.lang.Object	onMethodBegin(java.lang.Object invokedObject, java.lang.String className, java.lang.String methodName, java.lang.Object[] paramValues) This method is invoked at the start of the instrumented method.
abstract void	onMethodEnd(java.lang.Object state, java.lang.Object invokedObject, java.lang.String className, java.lang.String methodName, java.lang.Object[] paramValues, java.lang.Throwable thrownException, java.lang.Object returnValue) This method is invoked at the end of the instrumented method.

Methods inherited from class com.appdynamics.instrumentation.sdk.ASDKPlugin

getAgentPluginDirectory, getLogger, getNewReflectionBuilder, getRules, initializeRules

Methods inherited from class java.lang.Object

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

Constructor Detail

AGenericInterceptor

public AGenericInterceptor()

Method Detail

onMethodBegin

public abstract java.lang.Object onMethodBegin(java.lang.Object invokedObject,
                                               java.lang.String className,
                                               java.lang.String methodName,
                                               java.lang.Object[] paramValues)

This method is invoked at the start of the instrumented method. The class that implements this method will define everything that is done on start; the agent further does not start transactions, define exits, or decorate payloads. This is up to the user to handle.

Parameters:

invokedObject - The invoked object of the instrumented method

className - The name of the class that defines the instrumented method

methodName - The name of the instrumented method

paramValues - The parameter values for this invocation of the instrumented method

Returns:

A state object that is passed to onMethodEnd(Object, Object, String, String, Object[], Throwable, Object)

onMethodEnd

public abstract void onMethodEnd(java.lang.Object state,
                                 java.lang.Object invokedObject,
                                 java.lang.String className,
                                 java.lang.String methodName,
                                 java.lang.Object[] paramValues,
                                 java.lang.Throwable thrownException,
                                 java.lang.Object returnValue)

This method is invoked at the end of the instrumented method. The class that implements this method will define everything that is done on end; the agent further does not start transactions, define exits, or decorate payloads. This is up to the user to handle.

Parameters:

state - The state object returned from onMethodBegin(Object, String, String, Object[])

invokedObject - The invoked object of the instrumented method

className - The name of the class that defines the instrumented method

methodName - The name of the instrumented method

paramValues - The parameter values for this invocation of the instrumented method

thrownException - The exception thrown during the invocation of the instrumented method that is not caught. Is null if an exception is not thrown and the method exits normally.

returnValue - The return value of the method. Is null if the return type is void or the method exits with an exception.

getInterceptorId

public int getInterceptorId()

Overriden to return interceptor id if implementation on this intended to be used in micro java agent framework

Returns: