Graalvm配置文件与Feature和Substitute机制介绍

1. 配置文件

1.1 动态代码配置文件

对于动态代码，需要通过指定的json文件来描述其metadata，这样GraalVM才能正确的编译和优化代码。如下类型

  • 反射，配置文件名：reflect-config.json
  • 动态代理， 配置文件名：proxy-config.json
  • 资源文件, 配置文件名：resource-config.json
  • JNI, 配置文件名：jni-config.json，配置被JNI代码调用的java方法，可见jni-lib模块
  • 资源序列化, 配置文件名：serialization-config.json
  • predefined classes, 配置文件名：predefined-classes-config.json

这些JSON文件内容格式可见github: graalvm json file schema

1.2 命令参数配置文件

graalvm推荐开发者为自己的项目提供文件名为native-image.properties的配置文件，在该配置文件中可指定native-image编译分析所需要的配置，在properties文件中，支持如下key：

  1. Args 配置native-image命令参数，如–feature指定扩展的Feature接口、–initialize-at-build-time指定编译时初始化的类。更多命令行选项见Command-line Options
  2. JavaArgs 配置native-image执行时的JVM参数
  3. ImageName 配置最后生成的可执行文件名称

关于native-image.properties的内容更多具体的可见文档Native Image Build Configuration

1.3 存放位置

配置文件都存放在项目jar文件的META-INF/native-image/目录下，native-image会自动加载该目录下的文件。如：

META-INF/
└── native-image└── native-image.properties└── reflect-config.json└── jni-config.json

为了防止多个jar文件内的配置冲突，graalvm推荐在META-INF/native-image/目录下新建以你项目的groupId/artifactID为子目录，如：

META-INF/
└── native-image└── groupID└── artifactID└── native-image.properties└── reflect-config.json└── jni-config.json

2. 动态代码配置示例

2.1 反射

  1. 类所有方法都可以用于反射，reflect-config.json配置如下
[{"name": "com.example.User","allDeclaredConstructors": true,"allPublicMethods": true,"allDeclaredFields": true}
]
  1. 类中指定方法和字段可用于反射，配置示例如下
[{"name": "com.example.User","fields": [{"name": "name"}],"methods": [{"name": "<init>","parameterTypes": []},{"name": "setName","parameterTypes": ["java.lang.String"]}]}
]

2.2 动态代理

  1. 假设接口com.example.IPrintServic会用于动态代理，proxy-config.json配置示例如下
[{"interfaces": ["com.example.IPrintService"]}
]

2.3 资源文件

假设有如下代码用于加载类路径下的资源

try(InputStream stream = this.getClass().getClassLoader().getResourceAsStream(“resource_config.properties”)) {//读取资源内容
}

resource-config.json配置示例如下

{"resources": {"includes": [{"pattern": "\\Qresource_config.properties\\E"}]}
}

说明： 上面pattern属性值为正则表达式，字符\Q和\E之间的内容在正则表达式中表示字面量，即对其中的特殊字符进行原始匹配，比如上面的.不是匹配任意字符，而就是匹配字符串中的.。

2.4 类序列化

如果项目中类com.example.User使用了JDK的序列化方式，则其serialization-config.json配置示例如下

[{"name": "com.example.User"}
]

2.5 JNI中调JAVA API

如果JNI代码中有调com.example.Utils类的public static int add(int,int)方法，则jni-config.json配置示例如下

[
{"name":"com.example.Utils","methods":[{"name":"add","parameterTypes":["int","int"] }]
}
]

3. 扩展Feature接口

native-image生成可执行代码过程中会在关键步骤执行用户自定义代码，而用户代码的执行是通过graalvm的Feature机制实现的，开发者可以实现Feature接口来为程序设置一些特定行为，比如通过编码的方式设置以上动态代码配置。

示例

示例需求： 为com.example包下注解了@Reflect注解的类注册反射配置

  1. 实现Feature接口
public class ReflectFeature implements Feature {@Overridepublic void beforeAnalysis(BeforeAnalysisAccess access) {// 注册元数据try (ScanResult graph = new ClassGraph().overrideClassLoaders(access.getApplicationClassLoader()).overrideClasspath(access.getApplicationClassPath()).enableAllInfo().acceptPackages("com.example").scan()) {graph.getClassesWithAnnotation(Reflect.class).forEach(classInfo -> {Class clazz = classInfo.loadClass();RuntimeReflection.register(clazz);RuntimeReflection.registerForReflectiveInstantiation(clazz); // 可通过newInstance()方法创建，与allDeclaredConstructors=true类似RuntimeReflection.register(clazz.getDeclaredFields()); // allDeclaredFields=true类似RuntimeReflection.register(clazz.getDeclaredMethods());// allPublicMethods=true类似});}}
}

注：以上包扫描使用classgraph工具，它与其它反射工具相比优势在于它是直接解析字节码来进行匹配的，好处就是不用把类加载到JVM中。classgraph的maven配置如下：

<dependency><groupId>io.github.classgraph</groupId><artifactId>classgraph</artifactId><version>4.8.173</version>
</dependency>
  1. 注册自定义的com.example.feature.ReflectFeature接口
    有两种方式，
    1. 方式一：在native-image命令行使用参数配置--features=com.example.feature.ReflectFeature指定
    2. 方式二：推荐在native-image.properties文件配置，内容如下
     Args = --features=com.st.graalvm.feature.StepTrackFeature

4. Substitute机制

Substitute替换机制使得可以在不修改源代码的前提下，对运行时行为进行适配改造，以保持对原API的兼容。 GraalVM本身也通过该机制对JDK API做了很多兼容性替换。

基于该机制，开发者也可以根据实际需求对一些类、方法、字段甚至是构造函数在native-image编译过程中进行替换。

替换通过注解来实现，native-image编译过程会扫描这些特定注解的类，替换类必须为final类型，命名格式推荐为Target_{原类包名}_{原类名}。
替换机制提供的注解如下

  1. @TargetClass 注解替换类，其value值为被替换类

  2. @Substitute 注解替换方法，被注解的方法在方法名和签名上需与目标方法一致

  3. @Alias 注解在替换字段上，被注解的字段在名称和签名上需与目标字段一致，

    1. 搭配**@InjectAccessors**注解可拦截字段的get和set方法，示例如下
     @Alias @InjectAccessors(Target_OriginClass_Version_value.class)
private static String version;
static class Target_OriginClass_Version_value {private static String versionValue;static String getVersion() {if (versionValue == null) {versionValue = "44444444L_substitute";}return versionValue;}static void setVersion(String value) {System.out.println("setVersion:"  + value);}
}
    1. 搭配**@RecomputeFieldValue**注解可替换字段的值，示例如下
    // 替换静态字段，需设置isFinal=true
@Alias @RecomputeFieldValue(kind = Kind.FromAlias, isFinal = true)
private static boolean useNative = true;
// 替换字段
@Alias @RecomputeFieldValue(kind = Kind.FromAlias)
private boolean inited = true;

  4. @Inject 注解在替换类的字段上，该字段在被替换类中不存在，需搭配@RecomputeFieldValue注解，示例如下

@TargetClass(OriginClass.class)
public final class Target_com_example_OriginClass {// 替换并设置字段值@Alias @InjectAccessors(Target_OriginClass_Type_value.class)private TypeEnum type;@Inject @RecomputeFieldValue(kind = Kind.Reset)private TypeEnum typeValue;static class Target_OriginClass_Type_value {static TypeEnum getType(Target_OriginClass receiver) {if (receiver.typeValue == null) {receiver.typeValue = TypeEnum.SUBSTITUTE;}return receiver.typeValue;}static void setType(Target_OriginClass receiver, TypeEnum value) {receiver.typeValue = value;}}
}

5. maven编译打包配置

<plugin><groupId>org.graalvm.buildtools</groupId><artifactId>native-maven-plugin</artifactId><version>0.10.2</version><extensions>true</extensions><executions><execution><id>build-native</id><goals><goal>compile-no-fork</goal></goals><phase>package</phase></execution><execution><id>test-native</id><goals><goal>test</goal></goals><phase>test</phase></execution></executions><configuration><imageName>${project.artifactId}</imageName><sharedLibrary>false</sharedLibrary><metadataRepository><enabled>true</enabled></metadataRepository></configuration>
</plugin>

6. 其它特性

  1. 创建动态库供C/C++，可见文档Build a Native Shared Library
  2. JAVA代码可以直接调动态库接口，不过java代码需要经过native-image编译后才能运行
  3. 创建JNI接口，在之前JNI接口实现都是C/C++编写，使用native-image可以直接使用JAVA来编写JNI接口实现，可见文档JNI Invocation API
  4. 与其它语言集成（包含的语言有JS/Node.js、Python、R、Ruby、WebAssembly、LLVM语言），在Truffle基础上实现，可见文档Embedding Languages

工具

1. 使用native-image-agent代理库生成metadata文件

如果不清楚应用中有哪些动态代码需要提供配置，可以使用graalvm提供native-image-agent来跟踪代码执行情况来生成metadata文件，只需要在java启动参数中加上-agentlib:native-image-agent参数即可，命令示例如下

java -agentlib:native-image-agent=config-output-dir=graalvm -jar graalvm-1.0-SNAPSHOT.jar

总结

  1. Java语言的动态特性阻碍了native-image静态分析和编译，开发者需要提供相应的配置文件native-image才能完整的识别出需要静态编译的代码。
  2. Feature机制和替换机制为开发者提供了在编译期间尽可能多的控制
  3. 通过native-image不仅可以把应用编译为可执行文件，也可以把公共库编译为动态库供其它语言调用，还可以把公共库通过JNI接口暴露给其它java程序使用。

本文来自互联网用户投稿，该文观点仅代表作者本人，不代表本站立场。本站仅提供信息存储空间服务，不拥有所有权，不承担相关法律责任。如若转载，请注明出处：http://www.mzph.cn/news/862919.shtml

如若内容造成侵权/违法违规/事实不符，请联系多彩编程网进行投诉反馈email:809451989@qq.com，一经查实，立即删除！

相关文章

【高中数学之基本不等式】已知：x,y皆为正实数且x+3y=5xy,求3x+4y的最小值？

【高中数学之基本不等式】已知：x,y皆为正实数且x+3y=5xy,求3x+4y的最小值？

解&#xff1a;此题若使用“化二为一”法&#xff0c;会发现分母中出现了5x-3或是5y-1这样的式子&#xff0c;它可能导致负数的出现&#xff0c;已经违反了基本不等式中a,b皆大于零的应用条件。 此时应该迷途知返&#xff0c;及时易辙改弦。 此题适用“乘一法”&#xff0c;这…
阅读更多...
MyBatis（12）MyBatis 映射文件中的 resultMap

MyBatis（12）MyBatis 映射文件中的 resultMap

MyBatis 的 resultMap 是一种高级映射策略&#xff0c;用于处理复杂的SQL查询结果和Java对象之间的映射关系。resultMap 提供了比 auto-mapping 更为灵活的映射方式&#xff0c;它允许开发者显式指定数据库列和Java对象属性之间的映射关系&#xff0c;甚至可以处理复杂的数据结…
阅读更多...
【C++11 之单例模式线程安全原理+案例】及旧版本互斥锁线程安全案例

【C++11 之单例模式线程安全原理+案例】及旧版本互斥锁线程安全案例

在C11及之后的版本中&#xff0c;当函数返回局部静态变量时&#xff0c;该变量的初始化是线程安全的。 浅层原理 这是因为C11标准引入了“魔术静态局部变量”&#xff08;Magic Static Locals&#xff09;的概念&#xff0c;它确保了在多线程环境中&#xff0c;局部静态变量的…
阅读更多...
第1章_搭建开发环境

第1章_搭建开发环境

文章目录 第1章 搭建开发环境1.1开发套件硬件接口资源介绍1.2资料下载1.3安装Keil MDK1.3.1**软件下载**1.3.2**软件安装**1.3.3 PACK 安装 1.4 安装 STM32CubeMX1.5 安装 STM32CubeProgrammer1.6 安装 ST-Link 驱动1.7 安装 CH340 驱动 第1章 搭建开发环境 1.1开发套件硬件接…
阅读更多...
Dijkstra算法C代码

Dijkstra算法C代码

一个带权图n个点m条边&#xff0c;求起点到终点的最短距离 先定义一个邻接矩阵graph&#xff0c;graph[i][j]表示从i到j的距离&#xff0c;i到j没有路就表示为无穷 然后定义一个visit数组&#xff0c;visit[i]表示i结点是否被访问 然后定义一个dist数组&#xff0c;dist[i]表…
阅读更多...
Redis基础教程（一）：redis配置

Redis基础教程（一）：redis配置

&#x1f49d;&#x1f49d;&#x1f49d;首先&#xff0c;欢迎各位来到我的博客&#xff0c;很高兴能够在这里和您见面&#xff01;希望您在这里不仅可以有所收获&#xff0c;同时也能感受到一份轻松欢乐的氛围&#xff0c;祝你生活愉快&#xff01; &#x1f49d;&#x1f49…
阅读更多...
星光云720全景VR系统源码

星光云720全景VR系统源码

星光云720全景VR系统源码 系统体验地址项目介绍JDK版本后端主要依赖前端框架前端node 版本用户端框架介绍技术选型依赖全景内容简介系统图片部分功能截图系统体验地址 系统体验地址 VR全景系统体验地址 账号&#xff1a;18175760278 密码&#xff1a;12345678 项目介绍 JDK版…
阅读更多...
AudioLM: 音频生成模型

AudioLM: 音频生成模型

AudioLM: 音频生成模型 音频生成模型是一种利用人工智能技术生成声音或音频内容的模型。它利用深度学习技术，尤其是生成对抗网络（GANs）或变分自编码器（VAEs），结合声音合成和信号处理技术，从输入的文本、图像或其他形式的数据中生成音频。这些模型广泛应用于语音助手、游…
阅读更多...
图鸟模板-官网：基于Vue 3的前端技术探索与实践

图鸟模板-官网：基于Vue 3的前端技术探索与实践

摘要&#xff1a; 随着Web技术的不断发展&#xff0c;前端开发已经从简单的页面展示向功能丰富、交互体验优良的方向发展。Vue.js作为一款轻量级且功能强大的前端框架&#xff0c;自推出以来就受到了广泛的关注和应用。特别是Vue 3的发布&#xff0c;更是为前端开发带来了诸多新…
阅读更多...
机器学习笔记 人脸识别技术全面回顾和小结(1)

机器学习笔记 人脸识别技术全面回顾和小结(1)

一、简述 人脸识别是视觉模式识别的一个细分问题。人类一直在识别视觉模式&#xff0c;我们通过眼睛获得视觉信息。这些信息被大脑识别为有意义的概念。对于计算机来说&#xff0c;无论是图片还是视频&#xff0c;它都是许多像素的矩阵。机器应该找出数据的某一部分在数据中代表…
阅读更多...
最近公共祖先(倍增,tarjan,树链剖分)

最近公共祖先(倍增,tarjan,树链剖分)

两个点的最近公共祖先&#xff0c;即两个点的所有公共祖先中&#xff0c;离根节点最远的一个节点。 倍增算法 1.dfs一遍&#xff0c;创建ST表 2.利用ST表求LCA 内容来源 D09 倍增算法 P3379【模板】最近公共祖先&#xff08;LCA&#xff09; #include<iostream> #in…
阅读更多...
特斯拉下一代自动驾驶芯片的深度预测

特斯拉下一代自动驾驶芯片的深度预测

引言 特斯拉一直以来都在自动驾驶技术上不断突破&#xff0c;随着AI大模型技术的爆发&#xff0c;其下一代自动驾驶芯片&#xff08;HW5.0&#xff09;也备受瞩目。本文将深入分析和预测特斯拉下一代自动驾驶芯片AI5的技术特点及其对行业的影响。 深入技术分析 现有自动驾驶…
阅读更多...
MySQL8.0新特性~General tablespaces

MySQL8.0新特性~General tablespaces

通用表空间创建语法 InnoDB and NDB:[ADD DATAFILE file_name][AUTOEXTEND_SIZE [] value]InnoDB only:[FILE_BLOCK_SIZE value][ENCRYPTION [] {Y | N}]NDB only:USE LOGFILE GROUP logfile_group[EXTENT_SIZE [] extent_size][INITIAL_SIZE [] initial_size][MAX_SIZE [] ma…
阅读更多...
React小记（五）_Hooks入门到进阶

React小记（五）_Hooks入门到进阶

React 16.8 版本 类组件 和 函数组件 两种组件共存&#xff0c;到目前 React 18 版本&#xff0c;官方已经不在推荐使用类组件&#xff0c;在函数组件中 hooks 是必不可少的&#xff0c;它允许我们函数组件像类组件一样可以使用组件的状态&#xff0c;并模拟组件的生命周期等一…
阅读更多...
用Python写一个基于ai agent服务scrm，mes和erp系统的协同流程

用Python写一个基于ai agent服务scrm，mes和erp系统的协同流程

要实现一个基于AI Agent的协同流程&#xff0c;我们需要首先了解SCRM、MES和ERP系统的基本功能和相互之间的关系。然后&#xff0c;我们可以用Python编写一个简单的示例&#xff0c;展示这些系统如何协同工作。以下是一个基本的协同流程示例&#xff1a; 1. 假设我们有一个SCRM…
阅读更多...
高效数据采集监控平台 一体化平台 数据可视化！

高效数据采集监控平台 一体化平台 数据可视化！

提高工作效率&#xff0c;一直是各种厂家在寻找的方法。任何一种有效且实用的方法都值得去尝试。数据采集监控平台是一种能高效处理数据的方式&#xff0c;其主要工作内容是从各个产生数据的仪器设备传感器中采集数据、对数据进行集中整理整合、分析、显示、绘制图表、存储、传…
阅读更多...
java基于ssm+jsp 扶贫惠农推介系统

java基于ssm+jsp 扶贫惠农推介系统

1管理员功能模块 管理员输入个人的用户名、密码、角色登录系统&#xff0c;这时候系统的数据库就会在进行查找相关的信息&#xff0c;如果我们输入的用户名、密码不正确&#xff0c;数据库就会提示出错误的信息提示&#xff0c;同时会提示管理员重新输入自己的用户名、密码&am…
阅读更多...
DigiRL：让 AI 自己学会控制手机

DigiRL：让 AI 自己学会控制手机

类似于苹果此前发布的Ferret-UI 的安卓开源平替。主要用于在 Android 设备上识别 UI 和执行指令&#xff0c;不同的是它利用了离线到在线强化学习&#xff08;Offline-to-Online RL&#xff09;&#xff0c;能够快速适应应用更新或 UI 变化。
阅读更多...
2023信息素养大赛国赛C++真题

2023信息素养大赛国赛C++真题

2023信息素养大赛国赛C 第一题 给定一个五位数x&#xff0c;你需要重复做以下操作: 把数的各个数位进行由大到小排序和由小到大排序&#xff0c;得到的最大值和最小值&#xff0c;进行求差后作为新的x。 可以证明&#xff0c;在经过有限次操作后&#xff0c;x会循环出现。 …
阅读更多...
总结：Hive

总结：Hive

一、Hive介绍 Hive 是一个构建在 Hadoop 上的数仓工具&#xff0c;用于处理和查询存储在 HDFS 上的大规模数据。它使用类似 SQL 的 HiveQL 来执行查询&#xff0c;但背后是将查询任务转译成 MapReduce、Tez 或 Spark 等分布式计算任务来执行。Hive 的主要优势包括&#xff1a;…
阅读更多...
最新文章

Copyright @ 2022~2023