从 JavaScript 调用本地函数 | 用 WasmEdge 运行JavaScript 程序
WasmEdge 让 JavaScript 可以在共享库调用本地函数。
在前三篇文章中，我解释了为什么以及如何在 WebAssembly 沙箱中运行 JavaScript 程序。同时，还讨论了如何使用 Rust 为 WasmEdge 创建自定义 JavaScript AP。
- 用 WasmEdge 在 WebAssembly 中运行 JavaScript
- 将 JavaScript 嵌入到 Rust 中，并在 WebAssembly 中运行
- 用 Rust 创建高性能 JavaScript API，并在 WebAssembly 中运行
但是，为了完全访问底层系统的操作系统和硬件功能，我们有时需要为基于 C 的本机函数创建 JavaScript API。 也就是说，当 JavaScript 程序调用预定义的函数时，WasmEdge 会将其传递给 OS 上的原生共享库执行。
本文中，我们将向你展示如何做到这一点。我们将创建以下两个组件。
- 一个定制的 WasmEdge runtime，允许 WebAssembly 函数调用外部原生函数。
- 一个定制的 QuickJS 解释器，用于解析 JavaScript 中的函数调用，并将外部函数调用传递给 WebAssembly，后者又将它们传递给原生函数调用。 为了能够 follow 这个例子，你需要 fork 或克隆 wasmedge-quickjs repo。示例在该Repo的
examples/host_function文件夹。
$ git clone https://github.com/second-state/wasmedge-quickjs/
将一个基于 C 的函数嵌入 WasmEdge
首先，我们将向 WasmEdge runtime 添加一个基于 C 的函数，以便我们的 JavaScript 程序可以稍后调用它。我们使用 WasmEdge C API 创建一个 HostInc 函数，然后将其注册为 host_inc。
wasmedge_c/demo_wasmedge.c 文件包含 host 函数的完整源代码和其在 WasmEdge 的注册。
#include <stdio.h>
#include "wasmedge.h"
WasmEdge_Result HostInc(void *Data, WasmEdge_MemoryInstanceContext *MemCxt, const WasmEdge_Value *In, WasmEdge_Value *Out) {
int32_t Val1 = WasmEdge_ValueGetI32(In[0]);
printf("Runtime(c)=> host_inc call : %d\n",Val1 + 1);
Out[0] = WasmEdge_ValueGenI32(Val1 + 1);
return WasmEdge_Result_Success;
}
// mapping dirs
char* dirs = ".:..\0";
int main(int Argc, const char* Argv[]) {
/* Create the configure context and add the WASI support. */
/* This step is not necessary unless you need WASI support. */
WasmEdge_ConfigureContext *ConfCxt = WasmEdge_ConfigureCreate();
WasmEdge_ConfigureAddHostRegistration(ConfCxt, WasmEdge_HostRegistration_Wasi);
/* The configure and store context to the VM creation can be NULL. */
WasmEdge_VMContext *VMCxt = WasmEdge_VMCreate(ConfCxt, NULL);
WasmEdge_ImportObjectContext *WasiObject = WasmEdge_VMGetImportModuleContext(VMCxt, WasmEdge_HostRegistration_Wasi);
WasmEdge_ImportObjectInitWASI(WasiObject,Argv+1,Argc-1,NULL,0,&dirs,1,NULL,0);
/* Create the import object. */
WasmEdge_String ExportName = WasmEdge_StringCreateByCString("extern");
WasmEdge_ImportObjectContext *ImpObj = WasmEdge_ImportObjectCreate(ExportName, NULL);
enum WasmEdge_ValType ParamList[1] = { WasmEdge_ValType_I32 };
enum WasmEdge_ValType ReturnList[1] = { WasmEdge_ValType_I32 };
WasmEdge_FunctionTypeContext *HostFType = WasmEdge_FunctionTypeCreate(ParamList, 1, ReturnList, 1);
WasmEdge_HostFunctionContext *HostFunc = WasmEdge_HostFunctionCreate(HostFType, HostInc, 0);
WasmEdge_FunctionTypeDelete(HostFType);
WasmEdge_String HostFuncName = WasmEdge_StringCreateByCString("host_inc");
WasmEdge_ImportObjectAddHostFunction(ImpObj, HostFuncName, HostFunc);
WasmEdge_StringDelete(HostFuncName);
WasmEdge_VMRegisterModuleFromImport(VMCxt, ImpObj);
/* The parameters and returns arrays. */
WasmEdge_Value Params[0];
WasmEdge_Value Returns[0];
/* Function name. */
WasmEdge_String FuncName = WasmEdge_StringCreateByCString("_start");
/* Run the WASM function from file. */
WasmEdge_Result Res = WasmEdge_VMRunWasmFromFile(VMCxt, Argv[1], FuncName, Params, 0, Returns, 0);
if (WasmEdge_ResultOK(Res)) {
printf("\nRuntime(c)=> OK\n");
} else {
printf("\nRuntime(c)=> Error message: %s\n", WasmEdge_ResultGetMessage(Res));
}
/* Resources deallocations. */
WasmEdge_VMDelete(VMCxt);
WasmEdge_ConfigureDelete(ConfCxt);
WasmEdge_StringDelete(FuncName);
return 0;
}
你可以使用一个标准的 C 编译器，如 GCC，来编译 C 源代码。
#build custom webassembly Runtime
$ cd wasmedge_c
#build a custom Runtime
wasmedge_c/$ gcc demo_wasmedge.c -lwasmedge_c -o demo_wasmedge
编译器生成一个二进制码可执行文件 demo_wasmedge ，用于定制化的含有 host 函数的 WasmEdge runtime 版本。
创建一个 Rust 模块来将函数 bind 到 JavaScript
接下来，我们需要在 Rust 中创建一个定制的 JavaScript 解释器。它解释对 host_inc 的 JavaScript 调用，并通过自定义的 WasmEdge runtime (demo_wasmedge) 将调用定向到本地 C 函数。src/main.rs 文件有完整的 Rust 源代码，用于注册外部函数。
mod host_extern {
use quickjs_rs_wasi::{Context, JsValue};
#[link(wasm_import_module = "extern")]
extern "C" {
pub fn host_inc(v: i32) -> i32;
}
pub struct HostIncFn;
impl quickjs_rs_wasi::JsFn for HostIncFn {
fn call(ctx: &mut Context, _this_val: JsValue, argv: &[JsValue]) -> JsValue {
if let Some(JsValue::Int(i)) = argv.get(0) {
unsafe {
let r = host_inc(*i);
r.into()
}
} else {
ctx.throw_type_error("'v' is not a int").into()
}
}
}
}
use quickjs_rs_wasi::*;
fn main() {
let mut ctx = Context::new();
let f = ctx.new_function::<host_extern::HostIncFn>("host_inc");
ctx.get_global().set("host_inc", f.into());
// Run the embedded JavaScript
ctx.eval_global_str("print('js=> host_inc(2)=',host_inc(2))");
}
Rust 程序创建一个定制的 QuickJS 解释器，然后执行一个 JavaScript 程序，该程序依次调用在 WasmEdge runtime 中注册的基于 C 的本地函数。
$ cargo build --target wasm32-wasi --release
带有嵌入的 JavaScript 程序的定制 QuickJS 解释器可以在 target/wasm32-wasi/release/quickjs-rs-wasi.wasm 查看。
调用 JavaScript 函数
嵌入的 JavaScript 程序调用 host_inc() 函数。 JavaScript 解释器（host_function.wasm 的 Rust 程序）将此调用路由到 WebAssembly host_inc() 调用。定制的 WasmEdge 运行时（demo_wasmedge 的 C 程序）将 WebAssembly 调用路由到本机 C 函数。
print('js=> host_inc(2)=',host_inc(2))
当然，你也可以编写一个从文件中读取 JavaScript 的通用 Rust 程序。
要运行此 JavaScript，你需要在我们定制的 WasmEdge Runtime 中使用我们定制的 QuickJS 解释器。解释器和运行时都经过检测以支持 host_inc 本机函数调用。
$ cd wasmedge_c
$ export LD_LIBRARY_PATH=.
$ ./demo_wasmedge --dir .:. ../target/wasm32-wasi/release/host_function.wasm
js=> host_inc(2)= 3
接下来
上面这个简单的例子展示了如何将一个基于 C 的原生函数变为一个 JavaScript API。你可以使用同样的方式添加很多本地 API 到 JavaScript。非常期待你的绝妙点子！
云原生 WebAssembly 中的 JavaScript 是下一代云和边缘计算基础设施中的新兴领域。 我们也是刚刚起步！如果你也感兴趣，请加入我们的 WasmEdge 项目（或通过提出 feature request issue 告诉我们你的需求）。
