node.js插件Addons入门例子

发布时间:2019-08-02编辑:脚本学堂
本文介绍了node.js插件Addons入门例子,插件Addons实现教程,需要的朋友参考下。

node.js 插件Addons
插件是链接的动态对象。可以提供c和c++的包(libraries)。API比较复杂,涉及到的一些包(libraries)的知识如下:
V8 javascript,一个C++包(library)。用于JavaScript调用的接口:创建对象,调用函数等。文档描述主要在v8.h文件中(在源码目录deps/v8/include/v8.h)。
libuv,C事件驱动包。任何时间等待一个文件的描述变得可读,等待一个定时器,或者是等待接收一个信号都需要调用libuv的接口。也就是说,任何I/O操作都需要调用libyv。
Node内部包,尤为重要的是以后将常取得的node::ObjectWrap 类 。
其他。在deps/查看其他一些可用的插件。

Node 静态编译所有的依赖成可执行的。当编译模块时,需要注意链接到这些中的包(libraries)。

简单插件为例子:
 

复制代码 代码示例:
exports.hello = function() { return 'world'; };
//为得到创建的hello.cc:
#include <node.h>
#include <v8.h>

使用命名空间 v8;
 

复制代码 代码示例:

Handle<Value> Method(const Arguments& args) {
  HandleScope scope;
  return scope.Close(String::New("world"));
}

void init(Handle<Object> target) {
  NODE_SET_METHOD(target, "hello", Method);
}
 

NODE_MODULE(hello, init)
注意,所有的node插件必须有一个初始函数的外置(export an initialization function)。
void Initialize (Handle<Object> target);
NODE_MODULE(module_name, Initialize)

这里在NODE_MODULE后没有分号,因为这不是一个函数(参阅 node.h)。
module_name必须与最后的二进制文件名相匹配(去掉.node后缀)。
源码构建成 hello.node,二进制插件。为此用莽蛇(python)创建一个叫wscript的文件,内容如下:
 

复制代码 代码示例:

srcdir = '.'
blddir = 'build'
VERSION = '0.0.1'

def set_options(opt):
  opt.tool_options('compiler_cxx')

def configure(conf):
  conf.check_tool('compiler_cxx')
  conf.check_tool('node_addon')

def build(bld):
  obj = bld.new_task_gen('cxx', 'shlib', 'node_addon')
  obj.target = 'hello'
  obj.source = 'hello.cc'
 

运行node-waf配置构建,将创建一个build/default/hello.node文件,这就是我们的插件。
node-waf是一个 WAF 基于莽蛇(python)的构建系统。node-waf 为我们提供方便的应用。
现在可以在node项目中使用这个二进制插件了。

在hello.js中指出请求构建的模块:
 

复制代码 代码示例:
var addon = require('./build/Release/hello');
console.log(addon.hello()); // 'world'


这是所有关于插件的信息文档。

例子https://github.com/ry/node_postgres