字节码编程，Byte-buddy篇三《使用委托实现抽象类方法并注入自定义注解信息》

作者：小傅哥
博客：https://bugstack.cn - 汇总系列专题文章

沉淀、分享、成长，让自己和他人都能有所收获！

一、前言

截至到本章节关于字节码框架 Byte-buddy 的大部分常用 API 的使用已经通过案例介绍比较全面了，接下来介绍关于如何去实现一个抽象类以及创建出相应注解(包括类的注解和方法的注解)的知识点。而注解的这部分内容在一些监控或者拦截处理的场景下还是比较常用的，所以在这章节我们会通过一个例子来创建出含有自定义注解的类和方法。

如果你已经阅读了之前的系列文章，这部分学习的内容并不会有太多的陌生，主要是关于委托(MethodDelegation)方法的使用以及补充自定义注解。

那么，接下来我们就使用委托和注解方式来创建这样的案例进行学习。

二、开发环境

JDK 1.8.0
byte-buddy 1.10.9
byte-buddy-agent 1.10.9
本章涉及源码在：itstack-demo-bytecode-2-03，可以关注公众号：bugstack虫洞栈，回复源码下载获取。你会获得一个下载链接列表，打开后里面的第17个「因为我有好多开源代码」，记得给个Star！

三、案例目标

在这里我们定义了一个抽象并且含有泛型的接口类，如下；

public abstract class Repository<T> {public abstract T queryData(int id);}

那么接下来的案例会使用到委托的方式进行实现抽象类方法并加入自定义注解，也就相当于我们使用代码进行编程实现的效果。

@RpcGatewayClazz( clazzDesc = "查询数据信息", alias = "dataApi", timeOut = 350L )
public class UserRepository extends Repository<String> {      @RpcGatewayMethod( methodName = "queryData", methodDesc = "查询数据" )public String queryData(int var1) {// ...}}

这里就是最终效果，我们模拟是一种网关接口的实现和定义注解暴漏接口信息（如果你是在互联网中做开发，类似这样的需求还是蛮多的，接口统一走网关服务）。

四、技术实现

在技术实现的过程中会逐步的去实现我们需要的功能，将需要的用到知识点信息拆开讲解，以达到最终的案例目标。

1. 创建自定义注解

模拟网关类注解

@Retention(RetentionPolicy.RUNTIME)
@Target(ElementType.TYPE)
public @interface RpcGatewayClazz {String clazzDesc() default "";String alias() default "";long timeOut() default 350;}

模拟网关方法注解

@Retention(RetentionPolicy.RUNTIME)
@Target(ElementType.METHOD)
public @interface RpcGatewayMethod {String methodName() default "";String methodDesc() default "";}

这部分你可以创建任何类型的注解，主要是用于模拟类和方法上分别添加注解并获取最终属性值的效果。

2. 创建委托函数

public class UserRepositoryInterceptor {public static String intercept(@Origin Method method, @AllArguments Object[] arguments) {return "小傅哥博客，查询文章数据：https://bugstack.cn/?id=" + arguments[0];}}

最终我们的字节码操作会通过委托的方式来实现抽象类的功能。
在委托函数中的用到注解已经在上一章节中完整的介绍了，可以回顾参考。
@Origin 可以绑定到以下类型的参数：Method 被调用的原始方法 Constructor 被调用的原始构造器 Class 当前动态创建的类 MethodHandle MethodType String 动态类的toString()的返回值 int 动态方法的修饰符.
@AllArguments 绑定所有参数的数组。

3. 创建方法主体信息

// 生成含有注解的泛型实现字类
DynamicType.Unloaded<?> dynamicType = new ByteBuddy().subclass(TypeDescription.Generic.Builder.parameterizedType(Repository.class, String.class).build()) // 创建复杂类型的泛型注解.name(Repository.class.getPackage().getName().concat(".").concat("UserRepository"))                  // 添加类信息包括地址.method(ElementMatchers.named("queryData"))                                                          // 匹配处理的方法.intercept(MethodDelegation.to(UserRepositoryInterceptor.class))                                     // 交给委托函数.annotateMethod(AnnotationDescription.Builder.ofType(RpcGatewayMethod.class).define("methodName", "queryData").define("methodDesc", "查询数据").build()).annotateType(AnnotationDescription.Builder.ofType(RpcGatewayClazz.class).define("alias", "dataApi").define("clazzDesc", "查询数据信息").define("timeOut", 350L).build()).make();

这部分基本是Byte-buddy的模板方法，通过核心API；subclass、name、method、intercept、annotateMethod、annotateType 的使用构建方法。
首先是定义复杂类型的自定义注解，设定为本方法的父类，这部分内容也就是抽象类。Repository<T>，通过 TypeDescription.Generic.Builder.parameterizedType(Repository.class, String.class).build() 来构建。
设定类名称在我们之前就已经使用过，这里多加类的路径信息。concat 函数是字符串的连接符，替换 + 号。
method，设定匹配处理方法名称。
MethodDelegation.to(UserRepositoryInterceptor.class)，最终的核心是关于委托函数的使用。这里的使用也就可以调用到我们上面定义的委托函数，等最终我们通过字节码生成的 class 类进行查看。
annotateMethod、annotateType，定义类和方法的注解，通过 define 设定值（可以多次使用）。

4. 将创建的类写入目录

// 输出类信息到目标文件夹下
dynamicType.saveIn(new File(ApiTest.class.getResource("/").getPath()));

这部分内容是 Byte-buddy 提供的 API 方法；saveIn，把字节码信息写成 class 到执行的文件夹下。这样就可以非常方便的验证通过字节码框架创建的方法内容。

字节码方法内容

package org.itstack.demo.bytebuddy;@RpcGatewayClazz(clazzDesc = "查询数据信息",alias = "dataApi",timeOut = 350L
)
public class UserRepository extends Repository<String> {@RpcGatewayMethod(methodName = "queryData",methodDesc = "查询数据")public String queryData(int var1) {return FindOneInterceptor.intercept(cachedValue$aGmAjHXh$iha1qv0, new Object[]{var1});}public UserRepository() {}static {cachedValue$aGmAjHXh$iha1qv0 = Repository.class.getMethod("queryData", Integer.TYPE);}
}

从上可以看出来我们的自定义类已经实现了抽象类，同时也添加了类和方法的注解信息。
而在实现的类中有一步是使用委托函数进行处理方法的内容。

5. 输出自定义注解信息

// 从目标文件夹下加载类信息
Class<Repository<String>> repositoryClass = (Class<Repository<String>>) Class.forName("org.itstack.demo.bytebuddy.UserRepository");// 获取类注解
RpcGatewayClazz rpcGatewayClazz = repositoryClass.getAnnotation(RpcGatewayClazz.class);
System.out.println("RpcGatewayClazz.clazzDesc：" + rpcGatewayClazz.clazzDesc());
System.out.println("RpcGatewayClazz.alias：" + rpcGatewayClazz.alias());
System.out.println("RpcGatewayClazz.timeOut：" + rpcGatewayClazz.timeOut()); // 获取方法注解
RpcGatewayMethod rpcGatewayMethod = repositoryClass.getMethod("queryData", int.class).getAnnotation(RpcGatewayMethod.class);
System.out.println("RpcGatewayMethod.methodName：" + rpcGatewayMethod.methodName());
System.out.println("RpcGatewayMethod.methodDesc：" + rpcGatewayMethod.methodDesc());

在这里我们使用的是 Class.forName，进行加载类信息。也可以像以前的章节一样使用；unloadedType.load(XXX.class.getClassLoader()) 的方式进行直接处理字节码。
最后是读取自定义注解的信息内容，包括类和方法。

6. 测试验证运行

// 实例化对象
Repository<String> repository = repositoryClass.newInstance();
// 测试输出
System.out.println(repository.queryData(10001));

通过 Class.forName 的方式就可以直接调用方法，如果加载字节码的方式就需要通过反射进行处理（以往章节有案例可以对照学习）。

测试结果

RpcGatewayClazz.clazzDesc：查询数据信息
RpcGatewayClazz.alias：dataApi
RpcGatewayClazz.timeOut：350
RpcGatewayMethod.methodName：queryData
RpcGatewayMethod.methodDesc：查询数据
小傅哥博客，查询文章数据：https://bugstack.cn/?id=10001Process finished with exit code 0

不出意外你会看到以上的结果信息，通过我们使用字节码创建的方法已经可以按照我们的需求进行内容输出。

五、总结

在本章节的学习中需要注意几个知识点的使用，包括；委托方法使用、复杂类型的泛型创建、类和方法自定义注解的添加以及写入字节码信息到文件中。
截至到目前基本我们已经对常用的字节码框架自我学习和分享的基本完成了，另外一些其他的API的使用可以参考官方文档；https://bytebuddy.net
每一段知识都是只有进行系统化的学习才能有完整的收获，只言片语带来的碎片化体验总是不能对一个技术进行全方面的了解。在技术的这条路上，多加油！

六、彩蛋

CodeGuide | 程序员编码指南 Go!

本代码库是作者小傅哥多年从事一线互联网 Java 开发的学习历程技术汇总，旨在为大家提供一个清晰详细的学习教程，侧重点更倾向编写Java核心内容。如果本仓库能为您提供帮助，请给予支持(关注、点赞、分享)！

字节码编程，Byte-buddy篇三《使用委托实现抽象类方法并注入自定义注解信息》相关推荐

字节码编程，Javassist篇三《使用Javassist在运行时重新加载类「替换原方法输出不一样的结果」》
作者:小傅哥博客:https://bugstack.cn 沉淀.分享.成长,让自己和他人都能有所收获! 一.前言通过前面两篇 javassist 的基本内容,大体介绍了:类池(ClassPool) ...
字节码编程，Byte-buddy篇二《监控方法执行耗时动态获取出入参类型和值》
作者:小傅哥博客:https://bugstack.cn - 汇总系列专题文章沉淀.分享.成长,让自己和他人都能有所收获! 一.前言案例是剥去外衣包装展示出核心功能的最佳学习方式! 就像是我们研 ...
aop 获取方法入参出参_ASM字节码编程 | JavaAgent+ASM字节码插桩采集方法名称及入参和出参结果并记录方法耗时...
作者:小傅哥博客:bugstack.cn ❝ 沉淀.分享.成长,让自己和他人都能有所收获! ❞ 一.前言在我们实际的业务开发到上线的过程中,中间都会经过测试.那么怎么来保证测试质量呢?比如:提交了 ...
ASM字节码编程 | JavaAgent+ASM字节码插桩采集方法名称以及入参和出参结果并记录方法耗时
作者:小傅哥博客:bugstack.cn 沉淀.分享.成长,让自己和他人都能有所收获! 一.前言在我们实际的业务开发到上线的过程中,中间都会经过测试.那么怎么来保证测试质量呢?比如:提交了多少代码 ...
牛散村:Java字节码编程javassist的详细介绍
本篇文章将和大家分享一下关于Java字节码编程中一个非常之好用的技术javassist,下面将详细为大家介绍一下javassist技术,以及具体实例代码讲解. 一.Javassist入门 (一)Jav ...
ASM字节码编程 | 用字节码增强技术给所有方法加上TryCatch捕获异常并输出
作者:小傅哥博客:https://bugstack.cn Wiki:https://github.com/fuzhengwei/CodeGuide/wiki 沉淀.分享.成长,让自己和他人都能有所收 ...
字节码编程 | 工作多年的你依然重复做着CRUD？是否接触过这种技术？
大家好,我是冰河~~ 最近和不少小伙伴聊天,发现大部分小伙伴,其中可能就包括正在看文章的你和我,工作时间已经不短了,有些小伙伴工作3~5年了,有些甚至超过8年了. 但是大部分小伙伴平时的工作都是在简单 ...
字节码编程 | 使用Javassist动态生成Hello World
大家好,我是冰河~~ 字节码编程在实际的业务开发(CRUD)中并不常用,但是随着网络编程,RPC.动态字节码增强技术和自动化测试以及零侵入APM监控的不断发展与大量使用,越来越多的技术需要使用到字节码 ...
JVM学习笔记(Ⅰ)：Class类文件结构解析（带你读懂Java字节码，这一篇就够了）
JVM学习笔记(Ⅰ):Class类文件结构解析,带你读懂Java字节码前言:本文属于博主个人的学习笔记,博主也是小白.如果有不对的地方希望各位帮忙指出.本文主要还是我的学习总结,因为网上的一些知识分 ...