0

0

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

php中文网

php中文网

发布时间:2016-05-16 16:35:31

|

1237人浏览过

|

来源于php中文网

原创

温故而知新,可以为湿矣

  首先请大家记住这个 V8 的在线手册——http://izs.me/v8-docs/main.html。

  还记得上次的 building.gyp 文件吗?

复制代码 代码如下:

{
  "targets": [
    {
      "target_name": "addon",
      "sources": [ "addon.cc" ]
    }
  ]
}

   就像这样,举一反三,如果多几个 *.cc 文件的话就是这样的:
"sources": [ "addon.cc", "myexample.cc" ]

   上次我们把俩步骤分开了,实际上配置和编译可以放在一起的:
$ node-gyp configure build

   复习完了吗?没?!

  好的,那我们继续吧。

表番

立即学习C++免费学习笔记(深入)”;

函数参数

  现在我们终于要讲参数了呢。

  让我们设想有这样一个函数 add(a, b) 代表把 a 和 b 相加返回结果,所以先把函数外框写好:

复制代码 代码如下:

#include
using namespace v8;

Handle Add(const Arguments& args)
{
    HandleScope scope;

    //... 又来!
}

 Arguments

  这个就是函数的参数了。我们不妨先看看 v8 的官方手册参考。
 •int Length() const
 •Local operator[](int i) const
 
  其它的我们咱不关心,这两个可重要了!一个代表传入函数的参数个数,另一个中括号就是通过下标索引来访问第 n 个参数的。

  所以如上的需求,我们大致就可以理解为 args.Length() 为 2,args[0] 代表 a 以及 args[1] 代表 b 了。并且我们要判断这两个数的类型必须得是 Number。

  注意到没,中括号的索引操作符返回结果是一个 Local 也就是 Node.js 的所有类型基类。所以传进来的参数类型不定的,我们必须得自己判断是什么参数。这就关系到了这个 Value 类型的一些函数了。

 •IsArray()
•IsBoolean()
•IsDate()
•IsFunction()
•IsInt32()
•IsNativeError()
•IsNull()
•IsNumber()
•IsRegExp()
•IsString()
•...
 
  我就不一一列举了,剩下的自己看文档。。:.゚ヽ(*´∀`)ノ゚.:。

ThrowException

  这个是我们等下要用到的一个函数。具体在 v8 文档中可以找到。

  顾名思义,就是抛出错误啦。执行这个语句之后,相当于在 Node.js 本地文件中执行了一条 throw() 语句一样。比如说:
ThrowException(Exception::TypeError(String::New("Wrong number of arguments")));

   就相当于执行了一条 Node.js 的:
throw new TypeError("Wrong number of arguments");

 Undefined()

  这个函数呢也在文档里面。

  具体就是一个空值,因为有些函数并不需要返回什么具体的值,或者说没有返回值,这个时候就需要用 Undefined() 来代替了。

动手吧骚年!

  在理解了以上的几个要点之后,我相信你们很快就能写出 a + b 的逻辑了,我就把 Node.js 官方手册的代码抄过来给你们过一遍就算完事了:

复制代码 代码如下:

#include
using namespace v8;

Handle Add(const Arguments& args)
{
    HandleScope scope;

    // 代表了可以传入 2 个以上的参数,但实际上我们只用前两个
    if(args.Length()     {
        // 抛出错误
        ThrowException(Exception::TypeError(String::New("Wrong number of arguments")));

        // 返回空值
        return scope.Close(Undefined());
    }

    // 若前两个参数其中一个不是数字的话
    if(!args[0]->IsNumber() || !args[1]->IsNumber())
    {
        // 抛出错误并返回空值
        ThrowException(Exception::TypeError(String::New("Wrong arguments")));
        return scope.Close(Undefined());
    }

    // 具体参考 v8 文档
    //     http://izs.me/v8-docs/classv8_1_1Value.html#a6eac2b07dced58f1761bbfd53bf0e366)
    // 的 `NumberValue` 函数
    Local num = Number::New(args[0]->NumberValue() + args[1]->NumberValue());

    return scope.Close(num);
}

   函数大功告成!

  最后把尾部的导出函数给写好就 OK 了。

复制代码 代码如下:

void Init(Handle exports)
{
    exports->Set(String::NewSymbol("add"),
        FunctionTemplate::New(Add)->GetFunction());
}

NODE_MODULE(addon, Init)


   等你编译好之后,我们就能这样用了:

复制代码 代码如下:
var addon = require('./build/Release/addon');
console.log(addon.add(1, 1) + "b");

   你会看到一个 2b !✧。٩(ˊᗜˋ)و✧*。

回调函数

  上一章我们只讲了个 Hello world,这一章阿婆主就良心发现一下,再来个回调函数的写法。

  惯例我们先写好框架:

蓝色商务公司网站(XDcms内核)1.0
蓝色商务公司网站(XDcms内核)1.0

本系统使用的是XDcms内核,在原来基础上做来相应修改 前台修改调用数据,可以使用{loop catid=栏目ID}{/loop}方式调用 主要功能: A、内容管理模型,自定义字段,更方便扩展功能。自带模型:单页模型、新闻模型、产品模型、招聘模型 B、栏目自定义,便于内容管理 C、内容模块化,二次开发更便捷。自带模块:幻灯片、QQ客服、友情链接、自定义表单(在线留言、简历管理) D、模板管理,后台

下载
复制代码 代码如下:

#include
using namespace v8;

Handle RunCallback(const Arguments& args)
{
  HandleScope scope;

  // ... 噼里啪啦噼里啪啦

  return scope.Close(Undefined());
}

   然后我们决定它的用法是这样的:
func(function(msg) {
    console.log(msg);
});

   即它会给回调函数传入一个参数,我们设想它是一个字符串,然后我们可以 console.log() 出来看。

首先你要有一个字符串系列

  废话不多说,先给它一个字符串喂饱了再说吧。(√ ζ ε:)

  不过我们得让这个字符串是通用类型的,因为 Node.js 代码是弱类型的。
Local::New(String::New("hello world"));

   什么?你问我什么是 Local

  那我稍稍讲一下吧,参考自这里和V8参考文档。

  如文档所示,Local 实际上继承自 Handle,我记得上一章已经讲过 Handle 这个东西了。

  然后下面就是讲 Local 了。


Handle 有两种类型, Local Handle 和 Persistent Handle ,类型分别是 Local : Handle 和 Persistent : Handle ,前者和 Handle 没有区别生存周期都在 scope 内。而后者的生命周期脱离 scope ,你需要手动调用 Persistent::Dispose 结束其生命周期。也就是说 Local Handle 相当于在 C++`在栈上分配对象而 Persistent Handle 相当于 C++ 在堆上分配对象。
 
然后你要有个参数表系列

  终端命令行调用 C/C++ 之后怎么取命令行参数?

复制代码 代码如下:

#include

void main(int argc, char* argv[])
{
    // ...
}

   对了,这里的 argc 就是命令行参数个数,argv[] 就是各个参数了。那么调用 Node.js 的回调函数,v8 也采用了类似的方法:

复制代码 代码如下:
V8EXPORT Local v8::Function::Call(Handlerecv,
    int argc,
    Handle argv[]
);

 ~~QAQ 卡在了 Handle recv 了!!!明天继续写。~~
 
  好吧,新的一天开始了我感觉我充满了力量。(∩^o^)⊃━☆゚.*・。

  经过我多方面求证(SegmentFault和StackOverflow以及一个扣扣群),终于解决了上面这个函数仨参数的意思。

  后面两个参数就不多说了,一个是参数个数,另一个就是一个参数的数组了。至于第一个参数 Handle recv,StackOverflow 仁兄的解释是这样的:


It is the same as apply in JS. In JS, you do

复制代码 代码如下:

var context = ...;
cb.apply(context, [ ...args...]);

 The object passed as the first argument becomes this within the function scope. More documentation on MDN. If you don't know JS well, you can read more about JS's this here: http://unschooled.org/2012/03/understanding-javascript-this/
 
—— 摘自 StackOverflow

  总之其作用就是指定了被调用函数的 this 指针。这个 Call 的用法就跟 JavaScript 中的 bind()、call()、apply() 类似。

  所以我们要做的事情就是先把参数表建好,然后传入这个 Call 函数供其执行。

  第一步,显示转换函数,因为本来是 Object 类型:
Local cb = Local::Cast(args[0]);

   第二步,建立参数表(数组):
Local argv[argc] = { Local::New(String::New("hello world")) };

 最后调用函数系列

  调用 cb ,把参数传进去:
cb->Call(Context::GetCurrent()->Global(), 1, argv);

   这里第一个参数 Context::GetCurrent()->Global() 所代表的意思就是获取全局上下文作为函数的 this;第二个参数就是参数表中的个数(毕竟虽然 Node.js 的数组是有长度属性的,但是 C++ 里面数组的长度实际上系统是不知道的,还得你自己传进一个数来说明数组长度);最后一个参数就是刚才我们建立好的参数表了。

终章之结束文件系列

  相信这一步大家已经轻车熟路了吧,就是把函数写好,然后放进导出函数里面,最后申明一下。

  我就直接放出代码吧,或者直接跑去 Node.js 的文档看也行。

复制代码 代码如下:

#include
using namespace v8;

Handle RunCallback(const Arguments& args)
{
    HandleScope scope;
    Local cb = Local::Cast(args[0]);
    const unsigned argc = 1;
    Local argv[argc] = { Local::New(String::New("hello world")) };
    cb->Call(Context::GetCurrent()->Global(), argc, argv);

    return scope.Close(Undefined());
}

void Init(Handle exports, Handle module)
{
    module->Set(String::NewSymbol("exports"),
        FunctionTemplate::New(RunCallback)->GetFunction());
}

NODE_MODULE(addon, Init)

   Well done! 最后剩下的步骤就自己去吧。至于 Js 里面这么调用这个函数,我在之前已经提到过了。

番外

  嘛嘛,我感觉我的学习笔记写得越来越奔放了求破~

  今天就先写到这里吧,写学习笔记的过程中我又涨姿势了,比如说那个 Call 函数的参数意义。

  如果你们觉得本系列学习笔记对你们还有帮助的话,就来和我一起搞基吧么么哒~Σ>―(〃°ω°〃)♡→

热门AI工具

更多
DeepSeek
DeepSeek

幻方量化公司旗下的开源大模型平台

豆包大模型
豆包大模型

字节跳动自主研发的一系列大型语言模型

通义千问
通义千问

阿里巴巴推出的全能AI助手

腾讯元宝
腾讯元宝

腾讯混元平台推出的AI助手

文心一言
文心一言

文心一言是百度开发的AI聊天机器人,通过对话可以生成各种形式的内容。

讯飞写作
讯飞写作

基于讯飞星火大模型的AI写作工具,可以快速生成新闻稿件、品宣文案、工作总结、心得体会等各种文文稿

即梦AI
即梦AI

一站式AI创作平台,免费AI图片和视频生成。

ChatGPT
ChatGPT

最最强大的AI聊天机器人程序,ChatGPT不单是聊天机器人,还能进行撰写邮件、视频脚本、文案、翻译、代码等任务。

相关专题

更多
Python 序列化
Python 序列化

本专题整合了python序列化、反序列化相关内容,阅读专题下面的文章了解更多详细内容。

0

2026.02.02

AO3官网入口与中文阅读设置 AO3网页版使用与访问
AO3官网入口与中文阅读设置 AO3网页版使用与访问

本专题围绕 Archive of Our Own(AO3)官网入口展开,系统整理 AO3 最新可用官网地址、网页版访问方式、正确打开链接的方法,并详细讲解 AO3 中文界面设置、阅读语言切换及基础使用流程,帮助用户稳定访问 AO3 官网,高效完成中文阅读与作品浏览。

91

2026.02.02

主流快递单号查询入口 实时物流进度一站式追踪专题
主流快递单号查询入口 实时物流进度一站式追踪专题

本专题聚合极兔快递、京东快递、中通快递、圆通快递、韵达快递等主流物流平台的单号查询与运单追踪内容,重点解决单号查询、手机号查物流、官网入口直达、包裹进度实时追踪等高频问题,帮助用户快速获取最新物流状态,提升查件效率与使用体验。

27

2026.02.02

Golang WebAssembly(WASM)开发入门
Golang WebAssembly(WASM)开发入门

本专题系统讲解 Golang 在 WebAssembly(WASM)开发中的实践方法,涵盖 WASM 基础原理、Go 编译到 WASM 的流程、与 JavaScript 的交互方式、性能与体积优化,以及典型应用场景(如前端计算、跨平台模块)。帮助开发者掌握 Go 在新一代 Web 技术栈中的应用能力。

11

2026.02.02

PHP Swoole 高性能服务开发
PHP Swoole 高性能服务开发

本专题聚焦 PHP Swoole 扩展在高性能服务端开发中的应用,系统讲解协程模型、异步IO、TCP/HTTP/WebSocket服务器、进程与任务管理、常驻内存架构设计。通过实战案例,帮助开发者掌握 使用 PHP 构建高并发、低延迟服务端应用的工程化能力。

5

2026.02.02

Java JNI 与本地代码交互实战
Java JNI 与本地代码交互实战

本专题系统讲解 Java 通过 JNI 调用 C/C++ 本地代码的核心机制,涵盖 JNI 基本原理、数据类型映射、内存管理、异常处理、性能优化策略以及典型应用场景(如高性能计算、底层库封装)。通过实战示例,帮助开发者掌握 Java 与本地代码混合开发的完整流程。

5

2026.02.02

go语言 注释编码
go语言 注释编码

本专题整合了go语言注释、注释规范等等内容,阅读专题下面的文章了解更多详细内容。

62

2026.01.31

go语言 math包
go语言 math包

本专题整合了go语言math包相关内容,阅读专题下面的文章了解更多详细内容。

55

2026.01.31

go语言输入函数
go语言输入函数

本专题整合了go语言输入相关教程内容,阅读专题下面的文章了解更多详细内容。

27

2026.01.31

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
C# 教程
C# 教程

共94课时 | 8.3万人学习

C 教程
C 教程

共75课时 | 4.4万人学习

C++教程
C++教程

共115课时 | 15.5万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号