DIV CSS 佈局教程網

用C/C++實現Node.js擴展模塊(二):函數參數與回調
編輯:關於JavaScript     

溫故而知新。首先請記住V8的在線手冊——https://izs.me/v8-docs/main.html。

還記得上次的binding.gyp文件嗎?

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

如果有幾個.cc文件,就這樣寫: "sources": [ "addon.cc", "myexample.cc" ]。上次我們把配置和編譯分開了,其實可以合在一起: $ node-gyp configure build。復習完畢,我們繼續。

函數參數

現在終於要講參數了。設想有一個add(a, b)函數,把a和b相加返回結果,先把函數外框寫好:

#include <node.h>
using namespace v8;

Handle<Value> Add(const Arguments& args)
{
    HandleScope scope;
    //... 又來!
}

Arguments。先看V8官方手冊的兩個重要方法:int Length() const 代表傳入函數的參數個數;Local<Value> operator[](int i) const 通過下標索引訪問第n個參數。

所以上述需求中,args.Length() 為2,args[0]代表a,args[1]代表b,且我們要判斷這兩個數必須是Number。注意中括號返回的是Local<Value>(所有類型的基類),所以傳入的參數類型不定,我們必須自己判斷。這就用到了Value類型的一批方法:IsArray()、IsBoolean()、IsDate()、IsFunction()、IsInt32()、IsNull()、IsNumber()、IsRegExp()、IsString()等等。

ThrowException。顧名思義就是拋出錯誤,執行後相當於在Node.js裡執行了一條throw()。比如:

ThrowException(Exception::TypeError(String::New("Wrong number of arguments")));

就相當於執行了 throw new TypeError("Wrong number of arguments");。

Undefined()。這是一個空值,當函數無返回值時用它代替。

動手實現

理解以上要點後,a + b的邏輯就很清晰了:

#include <node.h>
using namespace v8;

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

    // 允許傳入2個以上參數,但實際只用前兩個
    if(args.Length() < 2)
    {
        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());
    }

    Local<Number> num = Number::New(args[0]->NumberValue() + args[1]->NumberValue());
    return scope.Close(num);
}

最後把尾部的導出函數寫好:

void Init(Handle<Object> 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,這一章再來個回調函數的寫法。先寫好框架:

#include <node.h>
using namespace v8;

Handle<Value> RunCallback(const Arguments& args)
{
    HandleScope scope;
    // ... 噼裡啪啦噼裡啪啦
    return scope.Close(Undefined());
}

我們決定用法是這樣:func(function(msg){ console.log(msg); });,即它會給回調函數傳入一個字符串參數。

先有一個字符串。我們得讓這個字符串是通用類型的,因為Node.js代碼是弱類型的:

Local<Value>::New(String::New("hello world"));

關於Local<Value>。Local<T>實際上繼承自Handle<T>。Handle有兩種類型:Local Handle和Persistent Handle,前者生命週期在scope內,後者脫離scope、需手動調用Persistent::Dispose結束生命週期。也就是說Local Handle相當於在C++棧上分配對象,Persistent Handle相當於在堆上分配對象。

參數表。終端調用C/C++時這樣取命令行參數:

#include <stdio.h>

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

這裡argc是參數個數,argv[]是各個參數。調用Node.js回調函數時,V8也採用了類似方法:

V8EXPORT Local<Value> v8::Function::Call(Handle<Object> recv,
    int argc,
    Handle<Value> argv[]
);

後兩個參數好理解:一個是參數個數,一個是參數數組。至於第一個參數 Handle<Object> recv,StackOverflow上的解釋是:它和JS中的apply一樣,第一個參數會成為函數作用域內的this。也就是說它指定了被調用函數的this指針,用法跟JavaScript中的bind()、call()、apply()類似。

所以我們要做的就是把參數表建好,再傳給Call函數執行。

第一步,顯式轉換函數(本來是Object類型):

Local<Function> cb = Local<Function>::Cast(args[0]);

第二步,建立參數表(數組):

Local<Value> argv[argc] = { Local<Value>::New(String::New("hello world")) };

第三步,調用cb並把參數傳進去:

cb->Call(Context::GetCurrent()->Global(), 1, argv);

這裡 Context::GetCurrent()->Global() 表示獲取全局上下文作為函數的this;第二個參數是參數個數(C++裡數組長度需自己傳入一個數說明);最後一個參數就是剛建好的參數表。

完整代碼

#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)

寫學習筆記的過程中也漲了不少知識,比如那個Call函數參數的含義。希望這系列筆記對你有所幫助,我們下次再繼續深入。

XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved