Chicory: 原生JVM上的WebAssembly运行时

项目介绍

Chicory是一个专为Java虚拟机（JVM）设计的原生WebAssembly（WASM）运行时，它使开发者能够在没有原生依赖或JNI的情况下执行WASM程序。这一工具致力于简化和安全地将WASM集成到JVM生态系统中，让WASM程序能够部署在任何支持JVM的环境中。目前尚处于早期开发阶段，团队积极寻求社区反馈和贡献。

项目快速启动

添加依赖

对于Maven项目，您需要在pom.xml中添加以下依赖来获取Chicory运行时：

<dependency>
    <groupId>com.dylibso.chicory</groupId>
    <artifactId>runtime</artifactId>
    <version>0.0.12</version>
</dependency>

若使用Gradle，则在您的构建文件中加入：

implementation 'com.dylibso.chicory:runtime:0.0.12'

此外，还可以下载并使用实验性的Chicory命令行界面（CLI），通过以下步骤：

export VERSION=$(wget -q -O - https://api.github.com/repos/dylibso/chicory/tags --header "Accept: application/json" | jq -r '.[0].name')
wget -O chicory https://repo1.maven.org/maven2/com/dylibso/chicory/cli/$VERSION/cli-$VERSION.sh
chmod a+x chicory
./chicory

运行示例

以计算阶乘的WASM程序为例，首先下载模块：

curl https://raw.githubusercontent.com/dylibso/chicory/main/wasm-corpus/src/main/resources/compiled/iterfact.wat.wasm > factorial.wasm

然后，通过Java代码加载并执行该WASM模块：

import com.dylibso.chicory.runtime.ExportFunction;
import com.dylibso.chicory.wasm.types.Value;
import com.dylibso.chicory.wasm.Module;
import com.dylibso.chicory.runtime.Instance;
import java.io.File;

// 加载并实例化WASM模块
Module module = new Parser().parse(new File("/path/to/factorial.wasm"));
Instance instance = Instance.builder(module).build();

// 获取并调用导出函数
ExportFunction iterFact = instance.export("iterFact");
Value result = iterFact.apply(Value.i32(5))[0];
System.out.println("结果: " + result.asInt()); // 应打印5的阶乘结果，即120

应用案例和最佳实践

与复杂类型交互

当需要传递更复杂的类型时，利用内存管理和WASM的指针机制是关键。例如，处理字符串输入：

1. 首先分配足够的WASM内存空间给字符串。
2. 将字符串写入到分配的内存地址。
3. 调用WASM模块中的函数，并传入内存地址。
4. 函数执行后，释放不必要的内存空间。

// 示例: 计算字符串中元音的数量
String message = "Hello, World!";
Instance countVowelInstance = ...; // 略去实例化过程
ExportFunction countVowels = countVowelInstance.export("count_vowels");
ExportFunction alloc = countVowelInstance.export("alloc");
ExportFunction dealloc = countVowelInstance.export("dealloc");

int ptr = (Integer) alloc.apply(Value.i32(message.getBytes().length))[0];
Memory memory = countVowelInstance.memory();
memory.writeString(ptr, message);

Value count = countVowels.apply(Value.i32(ptr), Value.i32(message.length()));
dealloc.apply(Value.i32(ptr), Value.i32(message.length()));

assert(count.asInt() == 3); // “Hello, World!”中有3个元音

典型生态项目

虽然当前信息未明确指出特定的“典型生态项目”，Chicory作为一款促进WASM在JVM上应用的技术，潜在的生态应用包括微服务架构中的轻量级服务容器、跨语言API实现、以及在Java应用中无缝集成机器学习模型等场景，其中模型可以通过其他语言（如Rust编译成WASM）编写，然后在Java应用中使用Chicory进行调用。

由于该项目为开源且在不断发展，鼓励开发者探索其在不同场景下的应用潜力，并参与贡献，共同推动其生态的丰富和完善。