Tomcat plugin为例,TomcatPlugin实现了ProfilerPlugin接口,在APM agent启动时,已经通过扫描插件目录并注入了TomcatPlugin实例到plugin context里。随后,在classloader加载一个class时,javaagent机制会调用instrumentation里的ClassFileTransformer对象的transform方法来修改字节码,APM agent启动时向instrumentation中放了一个ClassFileTransformerDispatcher,这个对象的transform方法里根据当前加载的类的全限名选择对应的插件来修改字节码。
APM对修改字节码的过程中获取到的类、方法,以及添加拦截器都做了包装,以便方便的添加拦截器。
public class TomcatPlugin implements ProfilerPlugin, TransformTemplateAware {
@Override
public void setup(ProfilerPluginSetupContext context) {// plugin接口
addRequestEditor();// 修改字节码
}
private void addRequestEditor() {
// 这个名字不贴切,实际上只是注册了一个修改字节码的类到transformContext里
// 第一个参数是目标类,第二个参数是具体修改实现
transformTemplate.transform("org.apache.catalina.connector.Request", new TransformCallback() {
@Override
public byte[] doInTransform(Instrumentor instrumentor, ClassLoader classLoader, String className, Class<?> classBeingRedefined, ProtectionDomain protectionDomain, byte[] classfileBuffer) throws InstrumentException {
InstrumentClass target = instrumentor.getInstrumentClass(classLoader, className, classfileBuffer);
target.addField(TomcatConstants.TRACE_ACCESSOR);
target.addField(TomcatConstants.ASYNC_ACCESSOR);
// clear request.// 修改特定的方法
InstrumentMethod recycleMethodEditorBuilder = target.getDeclaredMethod("recycle");
if (recycleMethodEditorBuilder != null) {
recycleMethodEditorBuilder.addInterceptor("com.navercorp.APM.plugin.tomcat.interceptor.RequestRecycleInterceptor");
}
// trace asynchronous process.
InstrumentMethod startAsyncMethodEditor = target.getDeclaredMethod("startAsync", "javax.servlet.ServletRequest", "javax.servlet.ServletResponse");
if (startAsyncMethodEditor != null) {
startAsyncMethodEditor.addInterceptor("com.navercorp.APM.plugin.tomcat.interceptor.RequestStartAsyncInterceptor");
}
return target.toBytecode();
}
});
}