bytebuddy 进阶

一、ByteBuddyAgent

示例
1.1 Attacher 负责启动agent.jar
1.2 Intaller Instrumention对象的载体
- 很简单的getInstrumention
- premain agentmain
1.3 VirtualMachine jvm平台的支持
1.4 ByteBuddyAgent(核心)
二、类型的描述

2.1 NamedElement.java

2.1.1 PackageDescription.java
2.1.3 修饰符ModifierReviewable.java
2.1.3 类型描述 TypeDescription

1. 非泛型
- 变量类型 7种
- 方法
2 泛型Generic
- 变量。
2.1.4 注解的封装
2.1.5 EnumerationDescription
2.1.6 FieldDescription
2.1.7 方法和参数列表
2.1.7 修饰符
- asm的编码
2.2 ASM相关
- 2.2.1 Advice.OnMethodEnter
- - Advice.Argument
  - Advice.This
- 2.2.2 Advice.OnMethodExit
- 2.2.3 AsmVisitorWrapper
2.3 ElementMatcher 匹配
- Junction extends ElementMatcher
2.4 Implementation 自定义实现
- 2.4.1 fixedValue.java
- 2.4.2 FieldAccessor.java
- 2.4.3 MethodCall
- - Specific
- 2.4.4 DefaultMethodCall
- 2.4.5 MethodDelegation
- 2.4.6 SuperMethodCall
- 2.4.7 Annotations 注解修改
2.5 DynamicType 动态类型
- 类型的加载策略
三、字节码的修改

示例
属性
3.1 classFileVersion
3.2 命名策略
3.3 注解过滤器
3.4 注解策略
3.5 implement内容上下文
3.6 方法视图编译器 MethodGraph
3.7 字节码生成器类型InstrumentedType
3.8 类型校验 TypeValidation
3.9 继承关系的Bridge
3.10 class写入策略
3.11 ignoredMethods
3.12 重要的方法
三、compose agent.jar

示例

博客
不同于使用-agent-jar参数的方式。bytebuddy自己实现了对Attach API的封装，可以直接将agent.jar加载。就是启动后主动attach到目标进程。

bytebuddy如何将类替换进内存。核心的函数是 net.bytebuddy.agent.install 方法。
可以先看 VirtualMachine 和 Instrument 完成扫盲。

1.1 Attacher 负责启动agent.jar

负责启动agent.jar包

只有一个方法install()，

接受一个jvm的pid，和jvm建立连接，执行attach，返回一个 VirtualMachine 。
执行loadagentpath或者loadagent加载agent.jar并触发premain或者domain方法
detach

1.2 Intaller Instrumention对象的载体

只要有有一个内部变量instrumention，用来包含对类的修改设定

很简单的getInstrumention

多了个权限策略的控制

premain agentmain

简单的赋值

1.3 VirtualMachine jvm平台的支持

支持的JVM，对JDK VirtualMachine的增强版
这里不需要细看

Resover获取 jvm平台信息

Resolver

OPENJ9

HotSpot

平台具体的attach处理，bytebuddy自己写的attach逻辑

1.4 ByteBuddyAgent(核心)

Provider

1. ProceessProvider

当前JVM pi的获取

2. AttachmentProvider

得到VirtulMachine用来attch的API

返回用来支持attach的Provider集合

内部实现了ACCESSOR，是对不同jvm的封装

用来attach的jvm的具体实现

3. AgentProvider

用来处理提供的jar文件或者agent.jar。

比如Agent-jar包中的 Manifest 文件有 PreMain-class 属性。
这个provider会
1 解析Manifest属性，设置到 ByteBuddyAgent 的属性去
2 读取agent的jar包

4.AttachmentTypeEvaluator

install()方法

其他 attach（）方法

底层也是调用了install方法

二、类型的描述

2.1 NamedElement.java

net.bytebuddy.description 用来承载和操作类型

getActualName() sourcecode中的名称，没有就返回空""
getName() 运行中，byte code中变量的名称，例如 int i=0 的 i
getInternalName() 运行中，byte code中变量的名称，以classfile变量方式，比如常量池的序号 #1=int 中的 #1
isNamed() 是已经有设置的名称，而不是用默认
toGenericString() 返回泛型名称,如 List<>

2.1.1 PackageDescription.java

包名的载体

2.1.3 修饰符ModifierReviewable.java

2.1.3 类型描述 TypeDescription

java type的藐视，要么是一个class要么是interface。

1. 非泛型

变量类型 7种


0	FieldList<FieldDescription.InDefinedShape `getDeclaredFields()`	不管private还是public只要是生命过的filed。
1	MethodList<MethodDescription.InDefinedShape> getDeclaredMethods()	针对方法
2	boolean isInstance(Object value);	判读是否是某个类的实例
3	boolean isAssignableFrom(Class<?> type);	`class Bar extends Foo` —Foo.class.isAssignableFrom(Bar.class) 判读继承关系
4	isAssignableTo	Bar.class.isAssignableTo(Foo.class)刚好相反
5	boolean isInHierarchyWith(Class<?> type);	范围更大是否继承于
6	MethodDescription.InDefinedShape getEnclosingMethod()	返回当前方法
7	getEnclosingType()	返回当前类型
8	PackageDescription getPackage()	返回包的类型
9	getInheritedAnnotations()	返回继承的注解
10	isNestedClass()	是否是嵌套类型

2 泛型Generic

非泛型被认为是，泛型的儿子。非泛型是一个更具体的泛型。

无法了解更细了，需要了解泛型的原理。

2.1.4 注解的封装

AnnotationDescription

AnnotationList 也定义了一系列注解实例

2.1.5 EnumerationDescription

2.1.6 FieldDescription

2.1.7 方法和参数列表

和前面一样，带list的在筛选时提供遍历的筛选接口。

2.1.7 修饰符

这里不细讲，只是说明做什么的

asm的编码

2.2 ASM相关

和ASM API交互的包，这里简单看一下Advice是干什么的。

Advice 包含了 OnMethodEnter 和 OnMethodExit 注解。这两个类是在方法的执行前和后加入织入代码。使用可以用自己的实现，然后标注这两个注解，来达到将自己的代码嵌入目标类的前后，实现增强。
示例
 官网
在这里插入图片描述

2.2.1 Advice.OnMethodEnter

方法执行前

Advice.Argument

用来获取被执行对象的 field 或者参数

Advice.This

是当前advice对象的载体，标注之后，方法内部可以获取目前advice对象。

2.2.2 Advice.OnMethodExit

Advice.Argument

Advice.This

Advice.Return

给一个参数标识Advice.Return 后可以接收返回结果。

Advice.Thrown

给一个参数标识Advice. Thrown 后可以接收抛出的异常。

如果方法引发异常，则该方法将提前终止。如果由Advice.OnMethodEnter注释的方法引发异常，则不会调用由Advice.OnMethodExit方法注释的方法。如果检测的方法引发异常，则仅当Advice.OnMethodExit.onThrowable（）属性设置为true（默认值）时，才调用由Advice.OnMethodExit注释的方法。

2.2.3 AsmVisitorWrapper

可以对已经增强的方法，继续增强。可以理解为基于asm对已有的增强的处理。至于怎么增强等待后面研究。

2.3 ElementMatcher 匹配

内置了很多匹配类可以直接使用，也可以自定义。这里描述的少，但是很重要。使用也很简单。

boolean matches(T target);匹配目标方法

Junction extends ElementMatcher

and | or matcher之前的匹配关系

2.4 Implementation 自定义实现

都继承 Implementation 接口， DynamicType.intercet(Implementation) 方法使用他去构造动态类的实现。

将定义好的类转为字节码

2.4.1 fixedValue.java

为method构造一个返回值。其他构造返回值得方法在 net.bytebuddy.implementation.StubMethod
打桩，即允许根据参数预设要返回的值

2.4.2 FieldAccessor.java

为一个field,构造setter和getter方法。

2.4.3 MethodCall

构造方法的调用字节码

Specific

调用具体的方法，就是指无需知道类名称，直接动态获取就行。

2.4.4 DefaultMethodCall

java8的interface可以指定default实现，这个类就是用来，给interface添加defalut的实现的。

2.4.5 MethodDelegation

不错的参考

委托调用，移花接木。将类的某个方法，指定成调用另外一个类的方法。
在这里插入图片描述

它会匹配Target.hello(String)方法，但是这不够精确，比如 target 有三个hello方法呢，默认采用和编译一致的算法，需要 target 中方法签名为 hello(String) 。除此之外可以配合注解使用，来设置匹配的优先级。

@Argument 主要使用的注解

判断是不是用来代理的方法。如果被判断的方法，没有两个以上(如图)，或者类型不匹配，就判断不是，继续下一个
@AllArguments
被修饰的参数意味值必须为一个数组
@This and @Super

注解	说明
@Argument	绑定单个参数
@AllArguments	绑定所有参数的数组
@This	当前被拦截的、动态生成的那个对象
@Super	当前被拦截的、动态生成的那个对象的父类对象
@Origin	可以绑定到以下类型的参数：Method 被调用的原始方法；Constructor 被调用的原始构造器；Class 当前动态创建的类；MethodHandle；MethodType；String 动态类的toString()的返回值；int 动态方法的修饰符
@DefaultCall	调用默认方法而非super的方法
@SuperCall	用于调用父类版本的方法
@Super	注入父类型对象，可以是接口，从而调用它的任何方法
@RuntimeType	可以用在返回值、参数上，提示ByteBuddy禁用严格的类型检查
@Empty	注入参数的类型的默认值
@StubValue	注入一个存根值。对于返回引用、void的方法，注入null；对于返回原始类型的方法，注入0
@FieldValue	注入被拦截对象的一个字段的值
@Morph	类似于@SuperCall，但是允许指定调用参数

2.4.6 SuperMethodCall

调用父方法

2.4.7 Annotations 注解修改

bytebuddy可修改类的注解（添加删除，修改）
bytebuddy也可以修改注解的属性，比如 value 值,或者注解本身的属性

2.5 DynamicType 动态类型

类型的载体

Loaded 对于加载进jvm的修改
Unloaded 未加载进jvm的修改

类型的加载策略

ClassLoadingStrategy

WRAPPER（默认）
新建classloader,去加载缺点是和其他类不再一个namespace下。
CHILD_FIRST
和WRAPPER类似，但是有classloader直接加载，不去请求上层classloader加载。好处是避免加载了同名的类，缺点是破坏了双亲委派模型
INJECTION
使用反射调用当前的classloader的方法去加载。缺点是程序再次加载时找不到当前的修改。就是一次性的。