使用node-addon-api编写c/c++扩展(传递复杂对象)

本文提供了在使用node-addon-api编写c/c++扩展时，由js向c++传递复杂类型时遇到的各种情况。其他基础知识就不赘述了，这篇文章讲的不错，不熟悉Node.js编写扩展的同学可以了解下。

官方给出了很多简单的例子以供参考，但是这些例子仍旧偏少，缺少各种用法示例。我相信各位能找到这篇文章八成是遇到了传参问题。

js如何向c++传递二维数组？

这里给出关键代码，最主要的是参数类型的转化。由这个例子，我想想c++传递三维数组也不成问题。网上有一种解决方案说是js这边先将参数调用JSON.stringify转化为string再传入到c++接口中，然后在c++里面解析这个传入的string为JSON。但是很明显，这种方案无疑会降低性能。想想我们编写c/c++扩展的目的是什么？就是想提高性能！这样不是和我们最初的目标背道而驰吗？

Napi::Value MyObject::JsToCpp2DArray(const Napi::CallbackInfo& info) {
    Napi::Env env = info.Env();
    if (info.Length() <= 0 || !info[0].IsArray()) {
        Napi::TypeError::New(env, "array expected").ThrowAsJavaScriptException();
    }

    Napi::Array array = info[0].As<Napi::Array>();
    uint32_t len = array.Length();
    cout<<"array length="<<len<<endl;
    for(uint32_t i=0;i<len;i++) {
        Napi::Array subArray = static_cast<Napi::Value>(array[i]).As<Napi::Array>();
        uint32_t lenj = subArray.Length();
        for(uint32_t j=0;j<lenj;j++) {
            string element = static_cast<Napi::Value>(subArray[j]).As<Napi::String>().ToString();
                cout<<"i="<<i<<" j="<<j<<" element ="<<element<<endl;
        }
    }
    Napi::Object objOut = Napi::Object::New(env);
    objOut.Set(Napi::String::New(env, "msg"), array);
    return objOut;
}

js代码

var obj = new addon.MyObject();
console.log(obj.jsToCpp2DArray([["aa","bb","cc","dd"],["aaa","bbb","ccc","ddd"]]));

最终输出

clipboard1.png

js如何向c++传递复杂对象？

这里给出如下示例

Napi::Value MyObject::JsToCppObject(const Napi::CallbackInfo& info) {
    Napi::Env env = info.Env();
    if (info.Length() <= 0 || !info[0].IsObject()) {
        Napi::TypeError::New(env, "Object expected").ThrowAsJavaScriptException();
    }
    Napi::Object obj = info[0].ToObject();
    double amount = obj.Get(static_cast<napi_value>(Napi::String::New(info.Env(),"amount"))).As<Napi::Number>().DoubleValue();
    cout<<"amount="<<amount<<endl;
    
    Napi::Array array = obj.Get(static_cast<napi_value>(Napi::String::New(info.Env(),"letters"))).As<Napi::Array>();
    uint32_t len = array.Length();
    cout<<"array length="<<len<<endl;
    for(uint32_t i=0;i<len;i++) {
        Napi::Array subArray = static_cast<Napi::Value>(array[i]).As<Napi::Array>();
        uint32_t lenj = subArray.Length();
        for(uint32_t j=0;j<lenj;j++) {
            string element = static_cast<Napi::Value>(subArray[j]).As<Napi::String>().ToString();
                cout<<"i="<<i<<" j="<<j<<" element ="<<element<<endl;
        }
    }
    Napi::Object objOut = Napi::Object::New(env);
    objOut.Set(Napi::String::New(env, "msg"), array);
    return objOut;
}

js代码

console.log(obj.jsToCppObject({
    "amount":99,
    "letters":[["aa","bb","cc","dd"],["aaa","bbb","ccc","ddd"]]
}));

最终输出

clipboard2.png

以上代码都实地测试通过。另外以上两个示例完整代码点此链接在github上可查。