nodeJS入门例子一—插件（Addons）

插件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。