Jasione

模组

· 作者 decce6

通过字节码分析,安全地消除 Enum#values 数组克隆和内存分配开销,从而减少 GC 压力

0 本站下载 0 关注 更新于 1 个月前

最新 1.0.9+26.1.2-neoforge · 26.3 · NeoForge

一键开服(送7天)

Jasione

概述

Jasione 是一款优化模组,旨在减少内存分配(降低 GC 压力)。

Java 编译器会为每个枚举类生成一个 values() 方法,可用于将所有枚举值作为数组获取。该方法在返回前会对数组进行克隆,以确保调用者可以安全地修改该数组而不影响其他调用者。然而,这会产生性能开销。当在高频路径中调用时,这些微小的内存分配会累积并增加 GC 压力。

Jasione 通过将不修改返回数组的 values() 调用重定向到使用缓存来解决此问题,从而消除克隆开销和内存分配。有关如何安全实现此功能的详细信息,请参阅下方的“技术细节”部分。

配置

Jasione 目前提供几个调试选项,可用于检查优化结果。配置文件位于 config/jasione.toml。

#指定是否启用模组
enabled = true

[debug]
	#启用后,在应用优化时记录统计信息
	printOptimization = false
	#启用后,将转换后的类转储到 ".jasione.out" 文件夹
	dumpClasses = false

常见问题

JIT 不是在 Enum#values() 调用安全时会对其进行优化吗?

不会,JIT 编译器目前甚至无法识别通过迭代值数组等最 trivial 的使用模式。克隆和内存分配的开销依然存在,参见 JMH 测试。

NeoForge 显示关于此模组的警告。为什么?

在最新 NeoForge (1.21.11+) 上运行此模组时,您可能会遇到以下警告:

[Render thread/ERROR] [ne.ne.fm.cl.tr.ClassTransformStatistics/]: Class processor jasione:main transformed 100.00% of loaded class which is suspiciously high; it may be attempting mass-ASM. Please report this to the mod author.

根据 NeoForge 团队成员的说法,此消息本质上是对模组作者的一种提示,让他们确认这种用例是否必要。对于 Jasione,这种转换是必要的。(参见上一个问题)

参考:“The NeoForged Project” Discord 服务器上的讨论(请注意,讨论涉及不同的实现方案,由于各种原因未能成为最终版本。更多详情请见“技术细节”部分。)

技术细节

Enum#values(其中 Enum 指代任何枚举类)的契约规定,返回的数组是全新的且可以自由修改。因此,我们必须通过分析调用者是否修改了数组或数组是否逃逸,来识别哪些调用者可以安全地进行优化。借助 asm-analysis 库可以实现这一点。如果通过字节码分析检测到数组修改或逃逸,则调用保持不变以保持正确性。

我们需要找到一个地方来存储缓存的值数组,因为枚举类的合成 $VALUES 字段是私有的。当前实现执行运行时类生成。对于每个枚举类,都会生成一个对应的缓存持有者类,用于以 static final 字段的形式存储值数组。例如,当转换器首次检测到对 net.minecraft.core.Direction#values 的使用时,它会生成类 me.decce.jasione.cached.net.minecraft.core.Direction,该类包含一个缓存的值数组以及各种确保正确性的元数据。借此,它可以将原始 values() 方法的所有调用者转换为使用缓存类。

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源