GraalVm反射配置辅助工具agentlib

前言

Graalvm通过静态分析提前编译来为Java应用程序构建高度优化的本机可执行文件，这就需要在编译时就知道所有的程序类型，而java中的反射、动态代理等功能，在编译时不确定具体的类型，所以在使用GraalVm构建native image前需要通过配置列出反射可见的所有类型。反射的配置是一个json格式的文件。为了简化这种反射的配置，GraalVm提供agentlib工具，来辅助生成这个配置文件

Reflection配置文档：https://github.com/oracle/REFLECTION.md

agetnlib文档：https://www.graalvm.org/docs/Native-Image/user/CONFIGURE

关于agentlib工具

为了更方便地准备这些配置文件，GraalVM提供了一个代理，该代理可以跟踪常规Java VM上执行动态功能的所有使用情况。可以在GraalVM的 java命令的命令行上启用它，如：

./java -agentlib:native-image-agent=config-output-dir=/home/kl/graal/data/ -jar /home/kl/graal/app/kk-risk-model-0.0.1-runner.jar

config-output-dir配置好配置的输出目录，默认情况下，配置文件生成将在jvm停止后输出，也可以通过添加配置，定期输出，如

• config-write-period-secs：按照此配置中的指定，每隔几秒钟执行一次定期写入。仅支持大于零的整数值。
• config-write-initial-delay-secs：第一次写入的秒数。仅支持大于或等于零的整数值。仅当config-write-period-secs大于零时启用。

每个配置间使用逗号分隔，如：

./java -agentlib:native-image-agent=config-output-dir=/home/kl/graal/data/,config-write-period-secs=60,config-write-initial-delay-secs=5 -jar /home/kl/graal/app/kk-risk-model-0.0.1-runner.jar

在执行期间，代理与Java VM交互以拦截所有查找类，方法，字段，资源或请求代理访问的调用。然后，代理生成的文件jni-config.json，reflect-config.json，proxy-config.json、resource-config.json在指定的目录输出。生成的文件是JSON格式的独立配置文件，其中包含所有拦截的动态访问。

在使用agentlib生成配置时，建议将应用的测试用例全部跑一边，让应用覆盖到所有的业务接口，不然，生成的配置可能覆盖不到所有的反射类

配置文件使用

通过将生成的配置文件放置在项目的resources/META-INF/native-image/类路径上的目录中使其生效，如果在quarkus中使用，还可以通过添加如下的配置参数使配置生效：

quarkus.native.additional-build-args =-H:ResourceConfigurationFiles=resources-config.json

第一种方案是GraalVm提供的默认的配置加载路径，第二种方式是Quarkus提供的配置加载方式，所有在quarkus中使用maven构建的话，可以在构建命令中看到你配置的指令，而第一种方案是看不到的，但是也是生效的。

ps：直接下载下来的graalvm sdk不包含如上功能，需要在graalvm的bin目录下执行gu install native-image安装好native-image环境后才行