虽然现在大部分情况都是使用n-api来编写插件,但是底层毕竟是v8(和libuv),使用v8编写简单的插件,同时熟悉v8的使用。
本文介绍在写c++插件时,简单又常用的写法,其实本质上,写插件的难处在于底层的能力和对libuv、v8的了解。话不多说,直接看代码。
#include <node.h>
namespace demo {
using v8::FunctionCallbackInfo;
using v8::Isolate;
using v8::Local;
using v8::Object;
using v8::String;
using v8::Value;
using v8::FunctionTemplate;
using v8::Function;
using v8::Number;
using v8::MaybeLocal;
using v8::Context;
using v8::Int32;
static int seq;
// 定义一个工具函数,生成seq
void GenSeq(const FunctionCallbackInfo<Value>& args) {
Isolate* isolate = args.GetIsolate();
args.GetReturnValue().Set(Number::New(isolate, ++seq));
}
// 定义一个加法函数
void Add(const FunctionCallbackInfo<Value>& args) {
Isolate* isolate = args.GetIsolate();
int a = args[0].As<Int32>()->Value();
int b = args[1].As<Int32>()->Value();
args.GetReturnValue().Set(Number::New(isolate, a + b));
}
void Initialize(
Local<Object> exports,
Local<Value> module,
Local<Context> context
) {
Isolate* isolate = context->GetIsolate();
// 新建一个函数模版
Local<FunctionTemplate> func = FunctionTemplate::New(isolate);
// 新建一个字符串表示函数名
Local<String> zaylee = String::NewFromUtf8(isolate, "zaylee", v8::NewStringType::kNormal).ToLocalChecked();
// 设置函数名
func->SetClassName(zaylee);
// 设置原型属性
func->PrototypeTemplate()->Set(isolate, "protoField", Number::New(isolate, 1));
// 设置对象属性
func->InstanceTemplate()->Set(isolate, "instanceField", Number::New(isolate, 2));
func->InstanceTemplate()->Set(isolate, "add", FunctionTemplate::New(isolate, Add));
// 设置函数对象本身的属性
func->Set(isolate, "funcField", Number::New(isolate, 3));
// 根据函数模版创建一个函数
Local<Function> ret = func->GetFunction(context).ToLocalChecked();
Local<String> Demo = String::NewFromUtf8(isolate, "Demo", v8::NewStringType::kNormal).ToLocalChecked();
// 导出函数
exports->Set(context, Demo, ret).Check();
// 导出工具函数
NODE_SET_METHOD(exports, "genSeq", GenSeq);
}
NODE_MODULE_CONTEXT_AWARE(NODE_GYP_MODULE_NAME, Initialize)
} // namespace demo
写个测试例子
const { Demo, genSeq } = require('./build/Release/test.node');
const demo = new Demo();
console.log('demo对象:', demo, '\n');
console.log('原型属性:', demo.protoField, '\n');
console.log('执行add方法:', demo.add(1,2), '\n');
console.log('执行seq方法:', genSeq(), genSeq(), '\n');
最后编写编译配置
{
"targets": [
{
"target_name": "test",
"sources": [ "./test.cc" ]
}
]
}
看起来非常简单,大概的流程如下
1 npm install -g node-gyp
2 node-gyp configure
3 node-gyp build
4 node test.js
拓展nodejs的方式很多,插件是一种,直接修改内核也是一种,之前有介绍过如何修改内核,有兴趣的同学也可以看一下。