• 这篇文档会忽略java agent的基础知识，请自行百度。或者参考instrument
• 对过于繁琐的代码，会说明意图，细节等。
• 首先会介绍用法的模板，涉及bytebuddy的各个类的作用，请参考bytebuddy简单入门
• 然后是按照类的结构来介绍Agentbuilder的功能。

希望我能写完吧，太难了。

一、使用范式:创建一个agent

当一个应用变得庞大和模块化时，使用java agent机制很合适。

定义transformer，每有一个类加载时，触发transformer逻辑，对类进行匹配和修改。

bytebuddy提供了Agentbuilder，封装了一系列API来新建一个 agent。
示例
假设我们定义了一个注解ToString，我们匹配所有标注@ToString的类，修改toString方法，让其返回"transformed"。

class ToStringAgent {
   
  public static void premain(String arguments, Instrumentation instrumentation) {
   
    new AgentBuilder.Default()
        .type(isAnnotatedWith(ToString.class))
        .transform(new AgentBuilder.Transformer() {
   
      @Override
      public DynamicType.Builder transform(DynamicType.Builder builder,
                                              TypeDescription typeDescription,
                                              ClassLoader classloader) {
   
        return builder.method(named("toString"))
                      .intercept(FixedValue.value("transformed"));
      }
    }).installOn(instrumentation);
  }
}

• type 接受 一个ElementMatcher 匹配 ToString注解
• transform 接受AgentBuilder.Transformer 来描述修改逻辑

// 这里匹配类里面的`toString`方法，使用`intercept`修改返回值
 public DynamicType.Builder transform(DynamicType.Builder builder,
                                              TypeDescription typeDescription,
                                              ClassLoader classloader) {
   
        return builder.method(named("toString"))
                      .intercept(FixedValue.value("transformed"));
      }

• installOn ,将修改，应用到instrumentation中。

二、AgentBuilder 类结构

bytebuddy的API

2.1 嵌套的内部类

2.2 方法

相当于API的翻译，会有简单解释，觉得不准请看上面的API文档。

• 加载过 往往意味值loaded，就是指classloader已经加载过目标类。bytebuddy通常就是感知类的加载，并且返回一个加工过的类。如此完成字节码修改的作用。