N久之前的一个坑——用 Node.js 来重构 NBUT 的 Online Judge,包括评测端也得重构一遍。(至于什么时候完成大家就不要关心了,(/‵Д′)/~ ╧╧
总之我们现在要做的其实简而言之就是——用C/C++来实现 Node.js 的模块。
准备工作
工欲善其事,必先~~耍流氓~~利其器。
node-gyp
首先你需要一个 node-gyp 模块。
在任意角落,执行:
复制代码 代码如下:
$ npm install node-gyp -g
在进行一系列的 blahblah 之后,你就安装好了。
Python
然后你需要有个 python 环境。
自己去官网搞一个来。
注意: 根据 node-gyp 的GitHub显示,请务必保证你的 python 版本介于 2.5.0 和 3.0.0 之间。
编译环境
嘛嘛,我就偷懒点不细写了,还请自己移步到 node-gyp 去看编译器的需求。并且倒腾好。
入门
我就拿官网的入门 Hello World说事儿了。
Hello World
请准备一个 C++ 文件,比如就叫 ~~sb.cc~~ hello.cc。
然后我们一步步来,先往里面搞出头文件和定义好命名空间:
复制代码 代码如下:
#include <node.h>
#include <v8.h>
using namespace v8;
主要函数
接下去我们写一个函数,其返回值是 Handle<Value>。
复制代码 代码如下:
Handle<Value> Hello(const Arguments& args)
{
//... 嗷嗷待写
}
然后我来粗粗解析一下这些东西:
Handle<Value>
做人要有节操,我事先申明我是从这里(@fool)参考的。
V8 里使用 Handle 类型来托管 JavaScript 对象,与 C++ 的 std::sharedpointer 类似,Handle 类型间的赋值均是直接传递对象引用,但不同的是,V8 使用自己的 GC 来管理对象生命周期,而不是智能指针常用的引用计数。
JavaScript 类型在 C++ 中均有对应的自定义类型,如 String 、 Integer 、 Object 、 Date 、 Array 等,严格遵守在 JavaScript 中的继承关系。 C++ 中使用这些类型时,必须使用 Handle 托管,以使用 GC 来管理它们的生命周期,而不使用原生栈和堆。
而这个所谓的 Value ,从 V8 引擎的头文件 v8.h 中的各种继承关系中可以看出来,其实就是 JavaScript 中各种对象的基类。
在了解了这件事之后,我们大致能明白上面那段函数的申明的意思就是说,我们写一个 Hello 函数,其返回的是一个不定类型的值。
注意: 我们只能返回特定的类型,即在 Handle 托管下的 String 啊 Integer 啊等等等等。
Arguments
这个就是传入这个函数的参数了。我们都知道在 Node.js 中,参数个数是乱来的。而这些参数传进去到 C++ 中的时候,就转变成了这个 Arguments 类型的对象了。
具体的用法我们在后面再说,在这里只需要明白这个是个什么东西就好。(为毛要卖关子?因为 Node.js 官方文档中的例子就是分开来讲的,我现在只是讲第一个 Hello World 的例子而已( ´థ౪థ)σ
添砖加瓦
接下去我们就开始添砖加瓦了。就最简单的两句话:
复制代码 代码如下:
Handle<Value> Hello(const Arguments& args)
{
HandleScope scope;
return scope.Close(String::New("world"));
}
这两句话是什么意思呢?大致的意思就是返回一个 Node.js 中的字符串 "world"。
HandleScope
同参考自这里。
Handle 的生命周期和 C++ 智能指针不同,并不是在 C++ 语义的 scope 内生存(即{} 包围的部分),而需要通过 HandleScope 手动指定。HandleScope 只能分配在栈上,HandleScope 对象声明后,其后建立的 Handle 都由 HandleScope 来管理生命周期,HandleScope 对象析构后,其管理的 Handle 将由 GC 判断是否回收。
所以呢,我们得在需要管理他的生命周期的时候申明这个 Scope 。好的,那么为什么我们的代码不这么写呢?
复制代码 代码如下:
Handle<Value> Hello(const Arguments& args)
{
HandleScope scope;
return String::New("world");
}
因为当函数返回时,scope 会被析构,其管理的Handle也都将被回收,所以这个 String 就会变得没有意义。
所以呢 V8 就想出了个神奇的点子——HandleScope::Close(Handle<T> Value) 函数!这个函数的用处就是关闭这个 Scope 并且把里面的参数转交给上一个 Scope 管理,也就是进入这个函数前的 Scope。
于是就有了我们之前的代码 scope.Close(String::New("world"));。
String::New
这个 String 类所对应的就是 Node.js 中原生的字符串类。继承自 Value 类。与此类似,还有: