用C/C++來實現(xiàn) Node.js 的模塊（二）
溫故而知新，可以為濕矣
首先請大家記住這個 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
復習完了嗎？沒？！
好的，那我們繼續(xù)吧。
表番
函數(shù)參數(shù)
現(xiàn)在我們終于要講參數(shù)了呢。
讓我們設想有這樣一個函數(shù) add(a, b) 代表把 a 和 b 相加返回結果，所以先把函數(shù)外框寫好：
#include <node.h>
using namespace v8;
Handle<Value> Add(const Arguments& args)
{
HandleScope scope;
//... 又來！
}
Arguments
這個就是函數(shù)的參數(shù)了。我們不妨先看看 v8 的官方手冊參考。
•int Length() const
•Local<Value> operator[](int i) const
其它的我們咱不關心，這兩個可重要了！一個代表傳入函數(shù)的參數(shù)個數(shù)，另一個中括號就是通過下標索引來訪問第 n 個參數(shù)的。
所以如上的需求，我們大致就可以理解為 args.Length() 為 2，args[0] 代表 a 以及 args[1] 代表 b 了。并且我們要判斷這兩個數(shù)的類型必須得是 Number。
注意到?jīng)]，中括號的索引操作符返回結果是一個 Local<Value> 也就是 Node.js 的所有類型基類。所以傳進來的參數(shù)類型不定的，我們必須得自己判斷是什么參數(shù)。這就關系到了這個 Value 類型的一些函數(shù)了。
•IsArray()
•IsBoolean()
•IsDate()
•IsFunction()
•IsInt32()
•IsNativeError()
•IsNull()
•IsNumber()
•IsRegExp()
•IsString()
•...
我就不一一列舉了，剩下的自己看文檔。｡:.ﾟヽ(*´∀`)ﾉﾟ.:｡
ThrowException
這個是我們等下要用到的一個函數(shù)。具體在 v8 文檔中可以找到。
顧名思義，就是拋出錯誤啦。執(zhí)行這個語句之后，相當于在 Node.js 本地文件中執(zhí)行了一條 throw() 語句一樣。比如說：
ThrowException(Exception::TypeError(String::New("Wrong number of arguments")));
就相當于執(zhí)行了一條 Node.js 的：
throw new TypeError("Wrong number of arguments");
Undefined()
這個函數(shù)呢也在文檔里面。
具體就是一個空值，因為有些函數(shù)并不需要返回什么具體的值，或者說沒有返回值，這個時候就需要用 Undefined() 來代替了。
動手吧騷年！
在理解了以上的幾個要點之后，我相信你們很快就能寫出 a + b 的邏輯了，我就把 Node.js 官方手冊的代碼抄過來給你們過一遍就算完事了：
#include <node.h>
using namespace v8;
Handle<Value> Add(const Arguments& args)
{
HandleScope scope;
// 代表了可以傳入 2 個以上的參數(shù)，但實際上我們只用前兩個
if(args.Length() < 2)
{
// 拋出錯誤
ThrowException(Exception::TypeError(String::New("Wrong number of arguments")));
// 返回空值
return scope.Close(Undefined());
}
// 若前兩個參數(shù)其中一個不是數(shù)字的話
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` 函數(shù)
Local<Number> num = Number::New(args[0]->NumberValue() + args[1]->NumberValue());
return scope.Close(num);
}
函數(shù)大功告成！
最后把尾部的導出函數(shù)給寫好就 OK 了。
void Init(Handle<Object> exports)
{
exports->Set(String::NewSymbol("add"),
FunctionTemplate::New(Add)->GetFunction());
}
NODE_MODULE(addon, Init)
等你編譯好之后，我們就能這樣用了：
console.log(addon.add(1, 1) + "b");
你會看到一個 2b ！✧｡٩(ˊᗜˋ)و✧*｡
回調函數(shù)
上一章我們只講了個 Hello world，這一章阿婆主就良心發(fā)現(xiàn)一下，再來個回調函數(shù)的寫法。
慣例我們先寫好框架：
#include <node.h>
using namespace v8;
Handle<Value> RunCallback(const Arguments& args)
{
HandleScope scope;
// ... 噼里啪啦噼里啪啦
return scope.Close(Undefined());
}
然后我們決定它的用法是這樣的：
func(function(msg) {
console.log(msg);
});
即它會給回調函數(shù)傳入一個參數(shù)，我們設想它是一個字符串，然后我們可以 console.log() 出來看。
首先你要有一個字符串系列
廢話不多說，先給它一個字符串喂飽了再說吧。(√ ζ ε:)
不過我們得讓這個字符串是通用類型的，因為 Node.js 代碼是弱類型的。
Local<Value>::New(String::New("hello world"));
什么？你問我什么是 Local<Value>？
那我稍稍講一下吧，參考自這里和V8參考文檔。
如文檔所示，Local<T> 實際上繼承自 Handle<T>，我記得上一章已經(jīng)講過 Handle<T> 這個東西了。
然后下面就是講 Local 了。
Handle 有兩種類型， Local Handle 和 Persistent Handle ，類型分別是 Local<T> : Handle<T> 和 Persistent<T> : Handle<T> ，前者和 Handle<T> 沒有區(qū)別生存周期都在 scope 內(nèi)。而后者的生命周期脫離 scope ，你需要手動調用 Persistent::Dispose 結束其生命周期。也就是說 Local Handle 相當于在 C++`在棧上分配對象而 Persistent Handle 相當于 C++ 在堆上分配對象。
然后你要有個參數(shù)表系列
終端命令行調用 C/C++ 之后怎么取命令行參數(shù)？
#include <stdio.h>
void main(int argc, char* argv[])
{
// ...
}
對了，這里的 argc 就是命令行參數(shù)個數(shù)，argv[] 就是各個參數(shù)了。那么調用 Node.js 的回調函數(shù)，v8 也采用了類似的方法：
int argc,
Handle<Value> argv[]
);
~~QAQ 卡在了 Handle<Object> recv 了?。?！明天繼續(xù)寫。~~
好吧，新的一天開始了我感覺我充滿了力量。(∩^o^)⊃━☆ﾟ.*･｡
經(jīng)過我多方面求證（SegmentFault和StackOverflow以及一個扣扣群），終于解決了上面這個函數(shù)仨參數(shù)的意思。
后面兩個參數(shù)就不多說了，一個是參數(shù)個數(shù)，另一個就是一個參數(shù)的數(shù)組了。至于第一個參數(shù) Handle<Object> 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
總之其作用就是指定了被調用函數(shù)的 this 指針。這個 Call 的用法就跟 JavaScript 中的 bind()、call()、apply() 類似。
所以我們要做的事情就是先把參數(shù)表建好，然后傳入這個 Call 函數(shù)供其執(zhí)行。
第一步，顯示轉換函數(shù)，因為本來是 Object 類型：
Local<Function> cb = Local<Function>::Cast(args[0]);
第二步，建立參數(shù)表（數(shù)組）：
Local<Value> argv[argc] = { Local<Value>::New(String::New("hello world")) };
最后調用函數(shù)系列
調用 cb ，把參數(shù)傳進去：
cb->Call(Context::GetCurrent()->Global(), 1, argv);
這里第一個參數(shù) Context::GetCurrent()->Global() 所代表的意思就是獲取全局上下文作為函數(shù)的 this；第二個參數(shù)就是參數(shù)表中的個數(shù)（畢竟雖然 Node.js 的數(shù)組是有長度屬性的，但是 C++ 里面數(shù)組的長度實際上系統(tǒng)是不知道的，還得你自己傳進一個數(shù)來說明數(shù)組長度）；最后一個參數(shù)就是剛才我們建立好的參數(shù)表了。
終章之結束文件系列
相信這一步大家已經(jīng)輕車熟路了吧，就是把函數(shù)寫好，然后放進導出函數(shù)里面，最后申明一下。
我就直接放出代碼吧，或者直接跑去 Node.js 的文檔看也行。
#include <node.h>
using namespace v8;
Handle<Value> RunCallback(const Arguments& args)
{
HandleScope scope;
Local<Function> cb = Local<Function>::Cast(args[0]);
const unsigned argc = 1;
Local<Value> argv[argc] = { Local<Value>::New(String::New("hello world")) };
cb->Call(Context::GetCurrent()->Global(), argc, argv);
return scope.Close(Undefined());
}
void Init(Handle<Object> exports, Handle<Object> module)
{
module->Set(String::NewSymbol("exports"),
FunctionTemplate::New(RunCallback)->GetFunction());
}
NODE_MODULE(addon, Init)
Well done! 最后剩下的步驟就自己去吧。至于 Js 里面這么調用這個函數(shù)，我在之前已經(jīng)提到過了。
番外
嘛嘛，我感覺我的學習筆記寫得越來越奔放了求破～
今天就先寫到這里吧，寫學習筆記的過程中我又漲姿勢了，比如說那個 Call 函數(shù)的參數(shù)意義。
如果你們覺得本系列學習筆記對你們還有幫助的話，就來和我一起搞基吧么么噠～Σ>―(〃°ω°〃)♡→
相關文章
這篇文章主要介紹了Koa2微信公眾號開發(fā)之消息管理，這一節(jié)我們就來看看公眾號的消息管理。并實現(xiàn)一個自動回復功能，具有一定的參考價值，感興趣的小伙伴們可以參考一下2018-05-05
任務（Tasks）是grunt的核心概念，你所做的很多工作比如資源合并（concat）、壓縮（uglify）都是在配置任務。 每次grunt運行的時候，你指定的一個或多個任務也在運行，如果你沒有指定任務，那么一個默認名為“default”的任務將自動運行。2014-06-06
本篇文章主要介紹了詳解用node搭建簡單的靜態(tài)資源管理器，主要用node的fs模塊，自己手寫一個簡單的靜態(tài)資源管理器。有興趣的可以了解一下2017-08-08
async/await與promise（nodejs中的異步操作問題）
這篇文章主要介紹了async/await與promise（nodejs中的異步操作問題）,非常不錯，具有參考借鑒價值，需要的朋友可以參考下2017-03-03
這篇文章主要介紹了Nodejs如何解決跨域(CORS)問題，具有很好的參考價值，希望對大家有所幫助。如有錯誤或未考慮完全的地方，望不吝賜教2023-01-01
解決Node.js使用MySQL出現(xiàn)connect ECONNREFUSED 127.0.0.1:3306的問題
這篇文章主要介紹了解決Node.js使用MySQL出現(xiàn)connect ECONNREFUSED 127.0.0.1:3306報錯的相關資料，文中將問題描述的很清楚，解決的方法也介紹的很完整，需要的朋友可以參考借鑒，下面來一起看看吧。2017-03-03
Node.js實現(xiàn)批量替換文件內(nèi)容示例
這篇文章主要為大家介紹了Node.js實現(xiàn)批量替換文件內(nèi)容示例,有需要的朋友可以借鑒參考下,希望能夠有所幫助,祝大家多多進步,早日升職加薪2023-08-08
Node.js與Sails ~項目結構與Mvc實現(xiàn)及日志機制
Sails是一個Node.js的中間架構，很方便的幫助我們搭建web應用程序。還有node.js與Sails日志機制在本文中也講到了，需要的朋友可以一起學習下2015-10-10
零基礎搭建Node.js、Express、Ejs、Mongodb服務器及應用開發(fā)入門
這篇文章主要介紹了零基礎搭建Node.js、Express、Ejs、Mongodb服務器及應用開發(fā)入門,本文在windows8系統(tǒng)下完成本教程,其它系統(tǒng)也可參考,需要的朋友可以參考下2014-12-12
這篇文章主要給大家介紹了關于如何使node也支持從url加載一個module的相關資料，文中通過示例代碼將實現(xiàn)的方法介紹非常詳細，對大家的學習或者工作具有一定的參考學習價值，需要的朋友們下面來一起看看吧2018-06-06