用C/C++来实现 Node.js 的模块(一)


Posted in Javascript onSeptember 24, 2014

 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 类。与此类似,还有:

 •Array
•Integer
•Boolean
•Object
•Date
•Number
•Function
•...
 

这些东西有些是继承自 Value,有些是二次继承。我们这里就不多做研究,自己可以看看 V8 的代码(至少是头文件)研究研究或者看看这个手册。

而这个 New 呢?这里可以看的。就是新建一个 String 对象。

至此,这个主要函数我们就解析完毕了。

导出对象

我们来温习一下,如果是在 Node.js 里面写的话,我们怎么导出函数或者对象什么的呢?

exports.hello = function() {}

 

那么,在 C++ 中我们该如何做到这一步呢?

初始化函数

首先,我们写个初始化函数:

void init(Handle<Object> exports)

{

    //... 嗷嗷待写你妹啊!#゚Å゚)⊂彡☆))゚Д゚)・∵

}

 

这是龟腚!函数名什么的无所谓,但是传入的参数一定是一个 Handle<Object>,代表我们下面将要在这货上导出东西。

然后,我们就在这里面写上导出的东西了:

void init(Handle<Object> exports)

{

    exports->Set(String::NewSymbol("hello"),

        FunctionTemplate::New(Hello)->GetFunction());

}

 

大致的意思就是说,为这个 exports 对象添加一个字段叫 hello,所对应的东西是一个函数,而这个函数就是我们亲爱的 Hello 函数了。

用伪代码写直白点就是:

void init(Handle<Object> exports)

{

    exports.Set("hello", function hello);

}

 

大功告成!

(大功告成你妹啊!闭嘴( ‘д‘⊂彡☆))Д´)

真·导出

这才是最后一步,我们最后要申明,这个就是导出的入口,所以我们在代码的末尾加上这一行:
NODE_MODULE(hello, init)

 

纳了个尼?!这又是什么东西?

别着急,这个 NODE_MODULE 是一个宏,它的意思呢就是说我们采用 init 这个初始化函数来把要导出的东西导出到 hello 中。那么这个 hello 哪来呢?

它来自文件名!对,没错,它来自文件名。你并不需要事先申明它,你也不必担心不能用,总之你的这个最终编译好的二进制文件名叫什么,这里的 hello 你就填什么,当然要除去后缀名了。

详见官方文档。

Note that all Node addons must export an initialization function:

void Initialize (Handle<Object> exports);

NODE_MODULE(module_name, Initialize)

 There is no semi-colon after NODE_MODULE as it's not a function (see node.h).

The module_name needs to match the filename of the final binary (minus the .node suffix).
 
编译 (๑•́ ₃ •̀๑)

来吧,让我们一起编译吧!

我们再新建一个类似于 Makefile 的归档文件吧——binding.gyp。

并且在里面添加这样的代码:

{

  "targets": [

    {

      "target_name": "hello",

      "sources": [ "hello.cc" ]

    }

  ]

}

 

为什么这么写呢?可以参考 node-gyp 的官方文档。

configure

在文件搞好之后,我们要在这个目录下面执行这个命令了:

$ node-gyp configure

 

如果一切正常的话,应该会生成一个 build 的目录,然后里面有相关文件,也许是 M$ Visual Studio 的 vcxproj 文件等,也许是 Makefile ,视平台而定。

build

Makefile 也生成好之后,我们就开始构造编译了:
$ node-gyp build

 

等到一切编译完成,才算是真正的大功告成了!不信你去看看 build/Release 目录,下面是不是有一个 hello.node 文件了?没错,这个就是 C++ 等下要给 Node.js 捡的肥皂!

搞基吧!Node ?(✿゚?゚)ノ C++

我们在刚才那个目录下新建一个文件 jianfeizao.js:

var addon = require("./build/Release/hello");

console.log(addon.hello());

 

看到没!看到没!出来了出来了!Node.js 和 C++ 搞基的结果!这个 addon.hello() 就是我们之前在 C++ 代码中写的 Handle<Value> Hello(const Arguments& args) 了,我们现在就已经把它返回的值给输出了。

洗洗睡吧,下节更深入

时间不早了,今天就写到这里了,至此为止大家都能搞出最基础的 Hello world 的 C++ 扩展了吧。下一次写的应该会更深入一点,至于下一次是什么时候,我也不知道啦其实。
 

(喂喂喂,撸主怎么可以这么不负责!(o゚ロ゚)┌┛Σ(ノ´ω`)ノ

Javascript 相关文章推荐
原生JavaScript生成GUID的实现示例
Sep 05 Javascript
JavaScript中this详解
Sep 01 Javascript
JS简单实现无缝滚动效果实例
Aug 24 Javascript
BootStrap与validator 使用笔记(JAVA SpringMVC实现)
Sep 21 Javascript
jquery popupDialog 使用 加载jsp页面的方法
Oct 25 Javascript
javascript 作用于作用域链的详解
Sep 27 Javascript
three.js加载obj模型的实例代码
Nov 10 Javascript
Angular5.1新功能分享
Dec 21 Javascript
three.js实现炫酷的全景3D重力感应
Dec 30 Javascript
浅谈layui分页控件field参数接收对象的问题
Sep 20 Javascript
jquery实现手风琴案例
May 04 jQuery
js实现弹窗效果
Aug 09 Javascript
JS实现一个列表中包含上移下移删除等功能
Sep 24 #Javascript
一个JavaScript函数把URL参数解析成Json对象
Sep 24 #Javascript
js监听鼠标点击和键盘点击事件并自动跳转页面
Sep 24 #Javascript
JavaScript设计模式之单例模式实例
Sep 24 #Javascript
JavaScript中实现异步编程模式的4种方法
Sep 24 #Javascript
JavaScript设计模式之观察者模式(发布者-订阅者模式)
Sep 24 #Javascript
JavaScript获取图片真实大小代码实例
Sep 24 #Javascript
You might like
PHP STRING 陷阱原理说明
2010/07/24 PHP
thinkphp验证码显示不出来的解决方法
2014/03/29 PHP
php函数与传递参数实例分析
2014/11/15 PHP
PHP跨平台获取服务器IP地址自定义函数分享
2014/12/29 PHP
smarty模板引擎之分配数据类型
2015/03/30 PHP
php 生成Tab键或逗号分隔的CSV
2016/09/24 PHP
两个listbox实现选项的添加删除和搜索
2013/03/01 Javascript
JS截取字符串常用方法详细整理
2013/10/28 Javascript
jquery ajax修改全局变量示例代码
2013/11/08 Javascript
javascript自定义的addClass()方法
2014/05/28 Javascript
JavaScript AJAX之惰性载入函数
2014/08/27 Javascript
jquery中show()、hide()和toggle()用法实例
2015/01/15 Javascript
Jquery动态替换div内容及动态展示的方法
2015/01/23 Javascript
JavaScript 用fetch 实现异步下载文件功能
2017/07/21 Javascript
小程序登录态管理的方法示例
2018/11/13 Javascript
解决Vue.js应用回退或刷新界面时提示用户保存修改问题
2019/11/24 Javascript
解决vue中的无限循环问题
2020/07/27 Javascript
[39:08]完美世界DOTA2联赛PWL S3 LBZS vs CPG 第一场 12.12
2020/12/16 DOTA
python类装饰器用法实例
2015/06/04 Python
python 获取页面表格数据存放到csv中的方法
2018/12/26 Python
在Pycharm中修改文件默认打开方式的方法
2019/01/17 Python
python实现邮件自动发送
2019/08/10 Python
Django中的cookie和session
2019/08/27 Python
解决Django连接db遇到的问题
2019/08/29 Python
Python爬虫爬取Bilibili弹幕过程解析
2019/10/10 Python
Python HTTP下载文件并显示下载进度条功能的实现
2020/04/02 Python
VSCODE配置Markdown及Markdown基础语法详解
2021/01/19 Python
英国领先的电子、技术和办公用品购物网站:Ebuyer
2018/04/04 全球购物
New Balance法国官方网站:购买鞋子和服装
2019/09/01 全球购物
全球性的众包图形设计市场:DesignCrowd
2021/02/02 全球购物
小学教师师德承诺书
2014/05/23 职场文书
2015年商场工作总结
2015/04/27 职场文书
2015年工会工作总结范文
2015/07/23 职场文书
小学数学继续教育研修日志
2015/11/13 职场文书
股东合作协议书模板2篇
2019/11/05 职场文书
MySQL普通表如何转换成分区表
2022/05/30 MySQL