最近我在着手将一个用C++写的线路优化算法整合进node.js服务端,尝试了多种方法,包括本地编译、调用动态链接库以及命令行调用,下面是我的一些心得体会。
利用node-gyp
直接将C++代码在服务端中编译并生成可用的模块需要用到node-gyp这个库,具体做法是首先进行安装:
sudo npm install node-gyp -g
为了编译一个C++文件test.cc
我们需要首先在原来项目中添加如下三个文件:
test.cc
, test.js
和binding.gyp
其中,经过测试,binding.gyp
作为配置文件最好放在与项目主入口app.js
同级的目录下, 三个文件的内容分别如下所示,
test.cc:
#include<node.h>
#include<v8.h>
#include<iostream>
using namespace std;
using namespace v8;
void hello(const FunctionCallbackInfo<Value>& args){
Isolate* isolate = args.GetIsolate();
args.GetReturnValue().Set(String::NewFromUtf8(isolate, "world"));
}
void init(Handle<Object>exports){
NODE_SET_METHOD(exports, "hello", hello);
}
NODE_MODULE(test, init);
test.js:
var test = require('build/Release/test');
test.hello('test', function(data){
console.log(data);
});
binding.gyp:
{
"targets":[
{
"target_name":"test",
"sources": [ "./tsModule/test.cc" ]
}
]
}
接下来是配置和编译的命令:
sudo node-gyp configure
sudo node-gyp build
简单的分析
我们来观察一下test.cc中的hello函数,本例中它的作用是返回一个字符串"world",其中第一行代码Isolate* isolate = args.GetIsolate();
完成了设定上下文的工作,这个“上下文”在各种v8.h
下的类的声明中都会用到;第二行设定了这个函数作为js模块的返回值,尽管这个C++函数本身返回值是void
说到这里,有必要简单介绍一下v8.h
中定义的用于js与C++交互的几个数据类型,常用的有Value, Object, Array, Number, String等。其中Value是父类,Object对应于json格式,剩下三个就是数组,浮点数和字符串。比如我们这样实现hello函数:
void hello(const FunctionCallbackInfo<Value>& args){
Isolate* isolate = args.GetIsolate();
Local<Object>obj = Local<Object>::New(isolate);
obj->Set(String::NewFromUtf8(isolate, "msg"),String::NewFromUtf8(isolate, "nothing"));
args.GetReturnValue().Set(obj);
}
就返回了{msg:'nothing'}
这个json数据
在实际使用中,数组的I/O曾一度让我非常困扰,后来终于摸到了一些门路,分享如下:
Local<Array>tArr = Local<Array>::Cast(args[0]);
cout<<tArr->Get(0)->NumberValue()<<endl;
以上就是从传入参数中解析出一个数组的方法,值得一提的是在C++中调用标准输出是可以接到js的控制台中的,方便调试
更多的API使用方法可以查看官方网站或直接去看v8.h
中的接口源码