老鼠AI大米_Java全栈
老鼠AI大米_Java全栈

从暴力到 NAN 再到 NAPI——Node.js 原生模块开发方式变迁

前言

在 Node.js 开发领域中，原生 C++ 模块的开发一直是一个被人冷落的角落。但是实际上在必要的时候，用 C++ 进行 Node.js 的原生模块开发能有意想不到的好处。

  • 性能提升。很多情况下，使用 C++ 进行 Node.js 原生模块开发的性能会比纯 Node.js 开发要高，少数情况除外。

  • 开发成本节约。在一些即有的 C++ 代码上做封装，开发成本远远低于从零开始写 Node.js 代码。

  • Node.js 无法完成的工作。个别情况，开发者只能得到一个库的静态连接库或者动态链接库以及一堆 C++ 头文件，其余都是黑盒的，这种情况就不得不使用 C++ 进行模块开发了。

本文将从早期的 Node.js 开始，逐渐披露 Node.js 原生 C++ 模块开发方式的变迁。一直到最后，会比较详细地对 Node.js v8.x 新出的原生模块开发接口 N-API 做一次初步的尝试和解析，使得大家对 Node.js 原生 C++ 模块开发的固有印象（认为特别麻烦）有一个比较好的改观，让大家都来尝试一下 Node.js 原生 C++ 模块的开发。

不变应万变

虽然 Node.js 原生 C++ 模块开发方式有了很大的改变，但是有一些内容是不变的，至少到现在来说都是基本上没什么 Breaking 的变化。

原生模块本质

这就要从 Node.js 最本质的 C++ 模块开发讲起了。举个例子，我们在 Linux 下有一个合法的原生模块 ons.node，它其实是一个二进制文件，使用文本编辑器无法正常地看出什么鬼，直到我们遇到了二进制文件查看器。

ons.node 二进制内容

眼尖的同学会看到它的 Magic Number1 是 0x7F454C46，其按位的 ASCII 码代表的字符串是 ELF。于是答案呼之欲出，这就是一个 Linux 下的动态链接库文件。

事实上，不只是在 Linux 中。当一个 Node.js 的 C++ 模块在 OSX 下编译会得到一个后缀是 *.node 本质上是 *.dylib 的动态链接库；而在 Windows 下则会得到一个后缀是 *.node 本质上是 *.dll 的动态链接库。

这么一个模块在 Node.js 中被 require 的时候，是通过 process.dlopen() 对其进行引入的。我们来看一下 Node.js v6.9.4 的 DLOpen2 函数吧：

void DLOpen(const FunctionCallbackInfo& args) {
  Environment* env = Environment::GetCurrent(args);
  uv_lib_t lib;
 
  ...
 
  Local module = args[0]->ToObject(env->isolate());
  node::Utf8Value filename(env->isolate(), args[1]);
 
  // 使用 uv_dlopen 加载链接库
  const bool is_dlopen_error = uv_dlopen(*filename, &lib);
  node_module* const mp = modpending;
  modpending = nullptr;
 
  ...
 
  // 将加载的链接库句柄转移到 mp 上
  mp->nm_dso_handle = lib.handle;
  mp->nm_link = modlist_addon;
  modlist_addon = mp;
 
  Local exports_string = env->exports_string();
 
  // exports_string 其实就是 `"exports"`
  // 这句的意思是 `exports = module.exports`
  Local exports = module->Get(exports_string)->ToObject(env->isolate());
 
  if (mp->nm_context_register_func != nullptr) {
    mp->nm_context_register_func(exports, module, env->context(), mp->nm_priv);
  } else if (mp->nm_register_func != nullptr) {
    mp->nm_register_func(exports, module, mp->nm_priv);
  } else {
    uv_dlclose(&lib);
    env->ThrowError("Module has no declared entry point.");
    return;
  }
}
 
 
按照逻辑来讲，这个加载过程其实就是下面这样的。
 
 
     
  
  1. 通过 uv_dlopen 加载链接库。
    2.  
  
  2. 将加载的链接库挂到原生模块链表中去。
    3.  
  
  3. 通过 mp->nm_register_func() 初始化这个模块，并得到该有的 module 和 module.exports。
    4.  
 
 
 
流程走下来就跟这个流程图差不多。
 
 
 
  
 
   
  
   
 
  
 
  

    DLOpen 流程图 
  
 
 
 
 
node-gyp
 
 
这货是 Node.js 中编译原生模块用的。自从 Node.js v0.8 之后，它就跟 Node.js 黏上了，在此之前它的默认编译帮助包是 node-waf3，对于老 Noder 来说应该不会陌生的。
 
 
GYP
 
 
node-gyp 是基于 GYP4 的。它会识别包或者项目中的 binding.gyp5 文件，然后根据该配置文件生成各系统下能进行编译的项目，如 Windows 下生成 Visual Studio 项目文件（*.sln 等），Unix 下生成 Makefile。在生成这些项目文件之后，node-gyp 还能调用各系统的编译工具（如 GCC）来将项目进行编译，得到最后的动态链接库 *.node 文件。
 
 
 
  
从上面的描述中大家可以看到，Windows 下编译 C++ 原生模块是依赖 Visual Studio 的，这就是为什么大家在安装一些 Node.js 包的时候会需要你事先安装好 Vusual Studio 了。
 
  
事实上，对于并没有 Visual Studio 需求的同学们来说，它不是必须的，毕竟 node-gyp 只依赖它的编译器，而不是 IDE。想要精简化安装的同学可以直接访问 http://landinghub.visualstudi... 下载 Visual CPP Build Tools 安装，或者通过 $ npm install --global --production windows-build-tools 命令行的方式安装，就能得到你该得到的编译工具了。
 
 
 
 
说了那么多，让大家见识一下 binding.gyp 的基本结构吧。
 
 
# binding.gyp
 
{
  "targets": [{
    "target_name": "addon1",
    "sources": [ "1/addon.cc", "1/myobject.cc" ]
  }, {
    "target_name": "addon2",
    "sources": [ "2/addon.cc", "2/myobject.cc" ]
  }, {
    "target_name": "addon3",
    "sources": [ "3/addon.cc", "3/myobject.cc" ]
  }, {
    "target_name": "addon4",
    "sources": [ "4/addon.cc", "4/myobject.cc" ]
  }]
}

 
 
这段配置讲述了这么一个故事：
 
 
     
  
  • 定义了 4 个 C++ 原生模块。
    •  
  
  • 每个模块的源码分别是 */addon.cc 和 */myobject.cc。
    •  
  
  • 4 个模块名分别是 addon1 至 addon4。
    •  
  
  • 隐藏故事：通过正规途径编译好后，这些模块存在于 build/Release/addon.node* 中。
    •  
 
 
 
关于 GYP 配置文件的更多内容，大家可自行去官方文档观摩，在脚注中有 GYP 的链接。
 
 
做的事情
 
 
node-gyp 除了自身是基于 GYP 的之外，它还做了一些额外的事情。首先，在我们编译一个 C++ 原生扩展的时候，它会去指定目录下（通常是 ~/.node-gyp 目录下）搜我们当前 Node.js 版本的头文件和静态连接库文件，若不存在，它就会火急火燎跑去 Node.js 官网下载。
 
 
这是一个 Windows 下 node-gyp 下载的指定版本 Node.js 头文件和库文件的目录结构。
 
 
 
  
 
   
  
   
 
  
 
  

    Windows 下的 Node.js 头文件与库文件 
  
 
 
 
 
这个头文件目录会在 node-gyp 进行编译时，以 "include_dirs" 字段的形式合并进我们事先写好的 binding.gyp 中，总而言之，这里面的所有头文件能被直接 #include <>。
 
 
子命令
 
 
node-gyp 是一个命令行的程序，在安装好后能通过 $ node-gyp 直接运行它。它有一些子命令供大家使用。
 
 
     
  
  • $ node-gyp configure：通过当前目录的 binding.gyp 生成项目文件，如 Makefile 等；
    •  
  
  • $ node-gyp build：将当前项目进行构建编译，前置操作必须先 configure；
    •  
  
  • $ node-gyp clean：清理生成的构建文件以及输出目录，说白了就是把目录清理了；
    •  
  
  • $ node-gyp rebuild：相当于依次执行了 clean、configure 和 build；
    •  
  
  • $ node-gyp install：手动下载当前版本的 Node.js 的头文件和库文件到对应目录。
    •  
 
 
 
时代在召唤
 
 
 
  
第 N 套国际 Node.js 开发者原生 C++ 模块开发方式，时代在召唤。
 
 
 
 
除去前文中讲的一些不变的内容，还有很多内容是一直在变化的，虽然说用老旧的开发方式也是可以开发出能用的 C++ 原生模块，但是旧不如新。
 
 
而且，其实目前来说 node-gyp 的地位也有可能在未来进行变化。因为当年 Chromium 是通过 GYP 来管理它的构建配置的，现如今已经步入了 GN6 的殿堂，是否也意味着 node-gyp 有一天也会被可能叫做 node-gn 的东西给取代呢？
 
 
话不多说，先来看看沧海桑田的故事吧。
 
 
黑暗时代：node-waf
 
 
在 Node.js 0.8 之前，通常在开发 C++ 原生模块的时候，是通过 node-waf 构建的。当然彼 node-waf 不是现在在 NPM 仓库上能搜到的 node-waf 了，当年那个 node-waf 早就年久失修了。
 
 
这个东西使用一种叫 wscript 的文件来配置。自 Node.js 升上 0.8 之后，就自带了 node-gyp 的支持，从此就不再需要 wscript 了。
 
 
不过就是因为有这个青黄交接的时候，那段时间的各种使用 C++ 来开发 Node.js 原生扩展的包为了兼容 0.8 前后版本的 Node.js，通常都是 binding.gyp 和 wscript 共存的。
 
 
大家可以来看一下 node-mysql-libmysqlclient 这个包在当年相应时间段的时候的仓库文件。为了支持 node-gyp，有一个 binding.gyp 文件，然后还存留着 wscript 配置文件。
 
 
封建时代：暴力！暴力！暴力！
 
 
在早期的时候，Node.js 原生 C++ 模块开发方式是非常暴力的，直接使用其提供的原生模块开发头文件。
 
 
开发者直接深入到 Node.js 的各种 API，以及 Google V8 的 API。
 
 
举个最简单的例子，在几年前，你的 Node.js C++ 原生扩展代码可能是长这样的。
 
 
Handle Echo(const Arguments& args)
{
    HandleScope scope;
 
    if(args.Length() < 1)
    {
        ThrowException(
            Exception::TypeError(
                String::New("Wrong number of arguments.")));
        return scope.Close(Undefined());
    }
 
    return scope.Close(args[0]);
}
 
void Init(Handle exports)
{
    exports->Set(String::NewSymbol("echo"),
        FunctionTemplate::New(Echo)->GetFunction());
}
 
 
这是一个最简单的 echo 函数，返回传进来的参数。写作 JavaScript 相当于是这样的。
 
 
exports.echo = function() {
    if(arguments.length < 1)
        throw new Error("Wrong number of arguments.");
    return arguments[0];
};

 
 
遗憾的是，这样的代码如果发成一个包，你现在是无论如何无法安装的，除非你用的是 0.10.x 的 Node.js 版本。
 
 
为什么这么说呢，这段代码的确是在 Node.js 0.10.x 的时候可以用的。但是再往上升 Google V8 的大版本，这段代码就无法适用了，讲粗暴点就是没办法再编译通过了。
 
 
就拿 Node.js 6.x 版本的 Google V8 来说，函数声明的对比是这样的：
 
 
Handle Echo(const Arguments& args);    // 0.10.x
void Echo(FunctionCallbackInfo& args); // 6.x

 
 
事实上，根本不需要等到 6.x。上面的代码到 0.12 就已经无法再编译通过了。不只是函数声明的变化，连句柄作用域7的声明方式都变了。
 
 
如果要让它在 Node.js 6.x 下能编译，就需要改代码，就像这样。
 
 
void Echo(const FunctionCallbackInfo& args)
{
    Isolate* isolate = args.GetIsolate();
    if(args.Length() < 1)
    {
        isolate->ThrowException(
            Exception::TypeError(
                String::NewFromUtf8(isolate, "Wrong number of arguments.")));
        return;
    }
 
    args.GetReturnValue().Set(args[0]);
}
 
void Init(Local exports)
{
    NODE_SET_METHOD(exports, "echo", Echo);
}
 
 
也就是说，以黑暗时代的方式进行 Node.js 原生模块开发的时候，一个版本只能支持特定几个版本的 Node.js，一旦 Node.js 的底层 API 以及 Google V8 的 API 发生变化，而这些原生模块又依赖了变化了的 API 的话，包就作废了。除非包的维护者去支持新版的 API，不过这样依赖，老版 Node.js 下就又无法编译通过新版的包了。
 
 
这就很尴尬了。
 
 
城堡时代：Native Abstractions for Node.js
 
 
在经历了黑暗时代的尴尬局面之后，2013 年年中，一个救世主突然现世。
 
 
它的名字叫作 NAN，全称 Native Abstractions for Node.js，即 Node.js 原生模块抽象接口。
 
 
 
  
NAN 由 Rod Vagg 和 Benjamin Byholm 两手带大，记名在 GitHub 的 Rod Vagg 账号下。并且在 Node.js 与 io.js 黑历史的年代，这个在 GitHub 上面项目移到了 io.js 的组织下面；后来由于两家又重归于好，NAN 最终归属到了 nodejs 这个组织下面。
 
 
 
 
总之在 NAN 出现之后，Node.js 的原生开发方式进入了城堡时代，并且一直持续到现在，甚至可能会持续到好久之后。
 
 
说 NAN 是 Node.js 原生模块抽象接口可能还是有点抽象，那么讲明白点，它就是一堆宏判断。比如声明一个函数的时候，只需要通过下面的一个宏就可以了：
 
 
NAN_METHOD(Echo){}

 
 
NAN 的宏会判断当前编译时候的 Node.js 版本，根据不同版本的 Node.js 来展开不同的结果。这会儿就又会提到先前的两个函数声明对比了。
 
 
Handle Echo(const Arguments& args);    // 0.10.x
void Echo(FunctionCallbackInfo& args); // 6.x

 
 
NAN_METHOD 将会在不同版本的 Node.js 下被 NAN 展开成上面两个这样。
 
 
而且 NAN 可不只是提供了 NAN_METHOD 一个宏，它还有一坨一坨数不清的宏供开发者使用。
 
 
比如声明句柄作用域的 Nan::HandleScope、能黑盒调起 libuv8 进行事件循环上的异步操作的 Nan::AsyncWorker 等。
 
 
于是，在城堡时代，大家的 C++ 原生模块代码都差不多长这样。
 
 
NAN_METHOD(Echo)
{
    if(info.Length() < 1)
    {
        Nan::ThrowError("Wrong number of arguments.");
        return info.GetReturnValue().Set(Nan::Undefined());
    }
 
    info.GetReturnValue().Set(info[0]);
}
 
NAN_MODULE_INIT(InitAll)
{
    Nan::Set(
        target,
        Nan::New("echo").ToLocalChecked(),
        Nan::GetFunction(Nan::New(Echo)).ToLocalChecked());
}

 
 
这样做的好处就是，代码只需要随着 NAN 的升级做改变就好，它会帮你兼容各不同 Node.js 版本，使其在任意版本都能被编译使用。
 
 
 
  
即使是 NAN 这样的好物，也有自己的一个使命，使命之外的东西会被逐渐剥离。比如 0.10.x 和 0.12.x 等版本就应该要退出历史舞台了，NAN 会逐渐放弃对它们的兼容和支持。
 
 
 
 
帝国时代：符合 ABI 的 N-API
 
 
自从前几天 Node.js v8.0.0 发布之后，Node.js 推出了全新的用于开发 C++ 原生模块的接口，N-API。
 
 
 
  
据官方文档所述，它的发音就是一个单独的 N，加上 API，即四个英文字母单独发音。
 
 
 
 
这东西相较于先前三个时代有什么不同呢？为什么会是更进一步的帝国时代呢？
 
 
首先，我们知道，即使是在 NAN 的开发方式下，一次编写好的代码在不同版本的 Node.js 下也需要重新编译，否则版本不符的话 Node.js 无法正常载入一个 C++ 扩展。即一次编写，到处编译。
 
 
而 N-API 相较于 NAPI 来说，它把 Node.js 的所有底层数据结构全部黑盒化，抽象成 N-API 当中的接口。
 
 
不同版本的 Node.js 使用同样的接口，这些接口是稳定地 ABI 化的，即应用二进制接口（Application Binary Interface）。这使得在不同 Node.js 下，只要 ABI 的版本号一致，编译好的 C++ 扩展就可以直接使用，而不需要重新编译。事实上，在支持 N-API 接口的 Node.js 中，的确就指定了当前 Node.js 所使用的 ABI 版本。
 
 
为了使得以后的 C++ 扩展开发、维护更方便，N-API 致力于以下的几个目标：
 
 
     
  
  • 以 C 的风格提供稳定 ABI 接口；
    •  
  
  • 消除 Node.js 版本的差异；
    •  
  
  • 消除 JavaScript 引擎的差异（如 Google V8、Microsoft ChakraCore 等）。
    •  
 
 
 
而这些 API 主要就是用来创建和操作 JavaScript 的值了，我们就再也不用直接使用 Google V8 提供的数据类型了。毕竟在 NAN 中，就算我们有时候看不到 Google V8 的影子，实际上在宏展开后还是无数的 Google V8 数据结构。
 
 
为了达成上述隐藏的目标，N-API 的姿势就变成了这样：
 
 
     
  
  • 提供头文件 node_api.h；
    •  
  
  • 任何 N-API 调用都返回一个 napi_status 枚举，来表示这次调用成功与否；
    •  
  
  • N-API 的返回值由于被 napi_status 占坑了，所以真实返回值由传入的参数来继承，如传入一个指针让函数操作；
    •  
  
  • 所有 JavaScript 数据类型都被黑盒类型 napi_value 封装，不再是类似于 v8::Object、v8::Number 等类型；
    •  
  
  • 如果函数调用不成功，可以通过 napi_get_last_error_info 函数来获取最后一次出错的信息。
    •  
 
 
 
 
  
注意：哪怕是现在的 Node.js v8.x 版本，N-API 仍处于一个实验状态，个人认为还有非常长的一段路要走，所以大家在生产环境中还不必太过于激进，不过 N-API 依然是大势所趋；不过对于使用老版本的 Node.js 开发者来说，大家也不要着急，即使 N-API 是在 v8.x 才正式集成进 Node.js，在其它旧版本的 Node.js 中依然可以将 N-API 作为外挂式的头文件9中使用，只不过无法做到跨版本的特性，这只是它做的向后兼容的一个事情而已。
 
 
 
 
关于 N-API 一系列的函数可以访问它的文档了解更多详情，现在我们来点料儿让大家对 N-API 的印象不是那么抽象。
 
 
模块初始化
 
 
在封建时代和 NAN 所处的，模块的初始化是交给 Node.js 提供的宏来实现的。
 
 
NODE_MODULE(addon, Init)

 
 
而到了当前的 N-API，它就变成了 N-API 的一个宏了。
 
 
NAPI_MODULE(addon, Init)

 
 
相应地，这个初始化函数 Init 的写法也会有所改变。比如这是封建时代和 NAN 时代的两种不同写法：
 
 
// 暴力写法
void Init(Local exports) {
    NODE_SET_METHOD(exports, "echo", Echo);
}
 
// NAN 写法
NAN_MODULE_INIT(Init)
{
    Nan::Set(
        target,
        Nan::New("echo").ToLocalChecked(),
        Nan::GetFunction(Nan::New(Echo)).ToLocalChecked());
}
 
 
而到了 N-API 的时候，这个 Init 函数就该是这样的了。
 
 
void Init(napi_env env, napi_value exports, napi_value module, void* priv)
{
    napi_status status;
 
    // 用于设置 exports 对象的描述结构体
    napi_property_descriptor desc =
        { "echo", 0, Echo, 0, 0, 0, napi_default, 0 };
 
    // 把 "echo" 设置到 exports 去
    status = napi_define_properties(env, exports, 1, &desc);
}

 
 
 
  
napi_property_descriptor 是用于设置对象属性的描述结构体，它的声明如下：
 
 
 
 
typedef struct {
 const char* utf8name;
 napi_callback method;
 napi_callback getter;
 napi_callback setter;
 napi_value value;
 napi_property_attributes attributes;
 void* data;
} napi_property_descriptor;

 
 
那么上面 Init 函数中的 desc 意思就是，即将被挂在的对象下会挂一个叫 "echo" 的东西，它的函数是 Echo，其它的 getter、setter 等全是空指针，而属性则是 napi_default。
 
 
napi_property_attributes 除了 napi_default 之外，还有诸如只读、是否可枚举等属性。
 
 
函数声明
 
 
还记得之前的两种函数声明吗？第三次再搬过来。
 
 
Handle Echo(const Arguments& args);    // 0.10.x
void Echo(FunctionCallbackInfo& args); // 6.x

 
 
在 N-API 中，你不用再被告知需要有 C++ 基础，C 即可。因为在 N-API 里面，声明一个 Echo 是这样的：
 
 
napi_value Echo(napi_env env, napi_callback_info info)
{
    napi_status status;
 
    size_t argc = 1;
    napi_value argv[1];
    status = napi_get_cb_info(env, info, &argc, argv, 0, 0);
    if(status != napi_ok || argc < 1)
    {
        napi_throw_type_error(env, "Wrong number of arguments");
        return 0; // napi_value 实际上是一个指针，返回空指针表示无返回值
    }
 
    return argv[0];
}

 
 
 
  
重要：目前 8.0.0 和 8.1.0 版本的 Node.js 官方文档中，关于 N-API 的各种接口文档错误颇多，所以还是要以能使用的接口为准。
 
  
而且现在大家也有很多人正在帮忙一起修复文档。例如现在的 JavaScript 函数声明返回值其实是 napi_value，而官方文档上还是老旧的 void。又比如 ``napi_property_descriptor_desc结构体中，在utf8name之后还有一个napi_value` 的变量，而文档中却是没有的。
 
  
这也是为什么我前面强调目前来说 N-API 还处于试验阶段。毕竟 API 并没有完全稳定下来，还处于一个快速迭代的步伐中，文档的更新并未跟上代码的更新。至少在笔者写作的当前是这样的（现在日期 2017 年 6 月 9 日）。
 
 
 
 
上面代码分步解析。
 
 
     
  
  • 通过 napi_get_cb_info 获取当次函数请求的参数信息，包括参数数量和参数体（参数体以 napi_value 的数组形式体现）；
    •  
  
  •  
    看看解析有无出错（status 不等于 napi_ok）或者看看参数数量是否小于 1；
     
   
       
    
    • 若解析出错或者参数数量小于 1，通过 napi_throw_type_error 在 JavaScript 层抛出一个错误对象，并返回；
      •  
    
    • 若无错则继续进行；
      •  
   
     
    •  
  
  • 返回 argv[0]，即第一个参数。
    •  
 
 
 
Demo 完整代码
 
 
这里放上这个 Echo 样例的完整代码，大家可以拿回家试试看。
 
 
binding.gyp
 
 
{
  "targets": [{
    "target_name": "addon",
    "sources": [ "addon.cc" ],
    "cflags!": [ "-fno-exceptions" ],
    "cflags_cc!": [ "-fno-exceptions" ],
    "xcode_settings": {
      "GCC_ENABLE_CPP_EXCEPTIONS": "YES",
      "CLANG_CXX_LIBRARY": "libc++",
      "MACOSX_DEPLOYMENT_TARGET": "10.7"
    },
    "msvs_settings": {
      "VCCLCompilerTool": { "ExceptionHandling": 1 }
    }
  }]
}

 
 
addon.cc
 
 
#include 
 
napi_value Echo(napi_env env, napi_callback_info info)
{
    napi_status status;
 
    size_t argc = 1;
    napi_value argv[1];
    status = napi_get_cb_info(env, info, &argc, argv, 0, 0);
    if(status != napi_ok || argc < 1)
    {
        napi_throw_type_error(env, "Wrong number of arguments");
        status = napi_get_undefined(env, argv);
    }
 
    return argv[0];
}
 
void Init(napi_env env, napi_value exports, napi_value module, void* priv)
{
    napi_status status;
    napi_property_descriptor desc =
        { "echo", 0, Echo, 0, 0, 0, napi_default, 0 };
    status = napi_define_properties(env, exports, 1, &desc);
}
 
NAPI_MODULE(addon, Init)

 
 
乘风破浪
 
 
在完成了代码之后，大家赶紧试一下代码吧。
 
 
首先在 Node.js v8.x 下进行试验，把这两段代码分别放到同一个目录下，命名好后，执行这样的终端命令：
 
 
$ node-gyp rebuild
...
$ node --napi-modules
(node:52264) Warning: N-API is an experimental feature and could change at any time
> const addon = require("./build/Release/addon");
undefined
> addon.echo("2333");
'2333'
> addon.echo("蛋花汤?", "南瓜饼?");
'蛋花汤?'
> addon.echo();
TypeError: Wrong number of arguments
    at repl:1:7
    at ContextifyScript.Script.runInThisContext (vm.js:44:33)
    at REPLServer.defaultEval (repl.js:239:29)
    at bound (domain.js:301:14)
    at REPLServer.runBound [as eval] (domain.js:314:12)
    at REPLServer.onLine (repl.js:433:10)
    at emitOne (events.js:120:20)
    at REPLServer.emit (events.js:210:7)
    at REPLServer.Interface._onLine (readline.js:278:10)
    at REPLServer.Interface._line (readline.js:625:8)

 
 
 
  
注意：还是因为试验特性，目前在 Node.js v8.x 要加载和执行 N-API 的 C++ 扩展的话，在启动 node 的时候需要加上 --napi-modules 参数，表示这次执行要启用 N-API 特性。
 
 
 
 
效果显而易见，在刚启动 Node.js REPL 的时候，你会得到一个警告。
 
 
 
  
(node:52264) Warning: N-API is an experimental feature and could change at any time
 
 
 
 
表示它目前还不是特别稳定，但是值得我们展望未来。然后在我们 require() 扩展的时候，我们就得到了一个拥有 echo 函数的对象了。
 
 
我们尝试了三种调用方式。第一次是规规矩矩传入一个参数，echo 如期返回我们传入的参数 "2333"；第二次传入两个参数，echo 返回了第一个参数 "蛋花汤?"；最后一次我们没传任何参数，这个时候就走到了 C++ 扩展中判断函数参数数量失败的条件分支，就抛出了一个 Wrong number of arguments 的错误对象。
 
 
总之，它按照我们的预期跑起来了。并且代码里面并没有任何 Node.js 非 N-API 所暴露出来的数据结构和 V8 的数据结构——版本差异消除了。
 
 
接下来激动人心的时刻到了，如果读者是使用 nvm 来管理自己的 Node.js 版本的话，可以尝试着安装一个 8.1.0 的 Node.js 版本。
 
 
$ nvm install 8.1.0

 
 
在安装成功切换版本成功后，尝试着直接打开 Node.js RELP，忘掉再次编译刚才编译好的扩展这一步。（不过别忘了 --napi-module 参数）
 
 
把刚才用于测试的几句 JavaScript 代码再重复地输入——N-API 诚不我欺，居然还是能输出结果。这对于以前的暴力做法和 NAN 做法来说，无疑是非常大的一个进步。
 
 
向下兼容
 
 
至此，我希望大家还没有忘记 N-API 是自 Node.js 8.0 之后出的特性。所以之前 Demo 的代码并不能在 Node.js 8.0 之前的版本如期编译和运行。
 
 
辛辛苦苦写好的包，居然不能在 Node.js 6.x 下面跑，搞什么。
 
 
 
  
 
   
  
   
 
  
 
  

    当时我就不乐意了 
  
 
 
 
 
先别急着摔。文中之前也说了，有一个外挂式头文件的包，其包名是 node-addon-api。
 
 
我们就试着通过它来进行向下兼容吧。首先在我们刚才的源码目录把这个包给安装上。
 
 
$ npm install --save node-addon-api

 
 
 
  
还是由于快速迭代的原因，我不能保证这个包当前版本的时效性，不过我相信大家都有探索精神，在未来版本不符导致的 API 不符的问题应该都能解决。
 
 
 
 
然后，给我们的 binding.gyp 函数加点料，加两个字段，里面是两个指令展开。
 
 
"include_dirs": [ "
 
 
 和  开头的字符串在 GYP 中代表指令，表示它的值是后面的指令的执行结果。上面两条指令的返回结果分别是外挂式头文件的头文件搜索路径，以及外挂式 N-API 这个包编译成静态连接库供我们自己的包使用的依赖声明。
 
 
有了这两个字段后，就表示我们依赖了外挂式 N-API 头文件。而且它内部自带判断，如果版本已经达到了有 N-API 的要求，它的依赖就会是一个空依赖，即不依赖外挂式 N-API 编译的静态连接库。
 
 
也就是说，用了外挂式的 N-API，能自动适配 Node.js 8.x 和低版本。
 
 
于是这个 binding.gyp 现在看起来是这样子的。
 
 
{
  "targets": [{
    "target_name": "addon",
    "sources": [ "addon.cc" ],
    "cflags!": [ "-fno-exceptions" ],
    "cflags_cc!": [ "-fno-exceptions" ],
    "xcode_settings": {
      "GCC_ENABLE_CPP_EXCEPTIONS": "YES",
      "CLANG_CXX_LIBRARY": "libc++",
      "MACOSX_DEPLOYMENT_TARGET": "10.7"
    },
    "msvs_settings": {
      "VCCLCompilerTool": { "ExceptionHandling": 1 }
    },
    "include_dirs": [ "
 
 
至于源码层面，我们就不需要作任何修改。在 Node.js v6.x 下面试试看吧。同样是使用 node-gyp rebuild 进行编译。然后通过 Node.js REPL 进去测试。
 
 
具体的终端输出这里就不放出来了，相信经过实验的大家都得到了自己想要的结果。
 
 
小结
 
 
本次内容主要讲解了在 Node.js 领域中原生 C++ 模块开发的方式变迁。
 
 
     
  
  • 从 node-waf 到 node-gyp，这是构建工具的一个变迁，未来说不定会是 GN 或者其它的构建工具。
    •  
  
  • 从暴力写码，到 NAN 的出现，见证了 Node.js 社区的各种爱恨情仇，一直到现在的新生儿 N-API，为原生 C++ 模块的开发输送了新鲜的血液。
    •  
 
 
 
目前的中坚力量仍然是 NAN 的开发方式，甚至我猜测是否未来有可能 NAN 会提供关于 N-API 的各种宏封装，使其彻底消除版本差异，包括 ABI 版本上的差异。当然这种 ABI 版本差异导致的需要多次编译问题应该还是存在的，这里指的是一次编码的差异。
 
 
在大家跟着本文对 N-API 进行了一次浅尝辄止的尝试之后，希望能对当下仍然处于实验状态的 N-API 充满了希冀，并对现在存在的各种坑处以包容的心态。
 
 
毕竟，Node.js loves you all。
 
 
参考资料
 
 
     
  
  • 「Consider moving from gyp to gn」：https://github.com/nodejs/nod...
    •  
  
  • 「Getting Started with Embedding · v8/v8 Wiki」：https://github.com/v8/v8/wiki...
    •  
  
  • 「Drop support for v0.10 and v0.12?」：https://github.com/nodejs/nan...
    •  
  
  • 「Node Loves Rust」：https://cnodejs.org/topic/593...
    •  
  
  • 「N-API | Node.js v8.0.0 Documentation」：https://nodejs.org/docs/v8.0....
    •  
  
  • 「doc: fix out of date sections in n-api doc」：https://github.com/nodejs/nod...
    •  
 
 
 
 
 
     
  
  1. 用于定义某种文件类型的特殊标识，详见 https://en.wikipedia.org/wiki... ↩
    2.  
  
  2. 代码参见 https://github.com/nodejs/nod... ↩
    3.  
  
  3. 年久失修，当前 NPM 上搜索到的 node-waf 已经不是当年的了，不过这个是 Waf 的官方仓库 https://github.com/waf-projec...。 ↩
    4.  
  
  4. 全称 Generate Your Projects，是谷歌开发的一套构建系统，未尽事宜详询 https://gyp.gsrc.io。 ↩
    5.  
  
  5. GYP 的配置文件的后缀就是 *.gyp 或者 *.gypi 等，是个类 JSON 文件。 ↩
    6.  
  
  6. GN 是谷歌开发的相较于 GYP 更新更快的一套构建工具，可以参考 https://chromium.googlesource... ↩
    7.  
  
  7. 让垃圾回收机制来管理 JavaScript 对象生命周期的一种类，即 HandleScope，在我的新书中将会有详解。 ↩
    8.  
  
  8. Node.js 的异步事件循环支撑者，详询 http://www.libuv.org/ ↩
    9.  
 
 

                            
                        
                    
                    
                    

                    
                    
                    

                
                

                    
                

            
        
    
    

        
你可能感兴趣的:(从暴力到 NAN 再到 NAPI——Node.js 原生模块开发方式变迁)

        

            

                
    
                    
  • 机器学习与深度学习间关系与区别
                        ℒℴѵℯ心·动ꦿ໊ོ꫞
人工智能学习深度学习python
                        
    一、机器学习概述定义机器学习（MachineLearning,ML）是一种通过数据驱动的方法，利用统计学和计算算法来训练模型，使计算机能够从数据中学习并自动进行预测或决策。机器学习通过分析大量数据样本，识别其中的模式和规律，从而对新的数据进行判断。其核心在于通过训练过程，让模型不断优化和提升其预测准确性。主要类型1.监督学习（SupervisedLearning）监督学习是指在训练数据集中包含输入
    
                    
    • 
                    
  • android系统selinux中添加新属性property
                        辉色投像

                        
    1.定位/android/system/sepolicy/private/property_contexts声明属性开头：persist.charge声明属性类型：u:object_r:system_prop:s0图12.定位到android/system/sepolicy/public/domain.te删除neverallow{domain-init}default_prop:property
    
                    
    • 
                    
  • 铭刻于星（四十二）
                        随风至

                        
    69夜晚，绍敏同学做完功课后，看了眼房外，没听到动静才敢从书包的夹层里拿出那个心形纸团。折痕压得很深，都有些旧了，想来是已经写好很久了。绍敏同学慢慢地、轻轻地捏开折叠处，待到全部拆开后，又反复抚平纸张，然后仔细地一字字默看。只是开头的三个字是第一次看到，让她心漏跳了几拍。“亲爱的绍敏：从四年级的时候，我就喜欢你了，但是我一直不敢说，怕影响你学习。六年级的时候听说有人跟你表白，你接受了，我很难过，但
    
                    
    • 
                    
  • 底层逆袭到底有多难，不甘平凡的你准备好了吗？让吴起给你说说
                        造命者说

                        
    底层逆袭到底有多难，不甘平凡的你准备好了吗？让吴起给你说说我叫吴起，生于公元前440年的战国初期，正是群雄并起、天下纷争不断的时候。后人说我是军事家、政治家、改革家，是兵家代表人物。评价我一生历仕鲁、魏、楚三国，通晓兵家、法家、儒家三家思想，在内政军事上都有极高的成就。周安王二十一年（公元前381年），因变法得罪守旧贵族，被人乱箭射死。我出生在卫国一个“家累万金”的富有家庭，从年轻时候起就不甘平凡
    
                    
    • 
                    
  • 想家
                        爆米花机

                        
    也许不同于大家对家乡的思念，我对家乡甚至是疯狂的不舍。还未踏出车站就感觉到幸福，我享受这里的夕阳、这里的浓烈柴火味、这里每一口家常菜。我是宅女，我贪恋家的安逸。刚刚踏出大学校门，初出茅庐，无法适应每年只能国庆和春节回家。我焦虑、失眠、无端发脾气，是无法适应工作的节奏，是无法接受我将一步步离开家乡的事实。我不想承认自己胸无大志，选择再次踏上征程。图片发自App
    
                    
    • 
                    
  • 【iOS】MVC设计模式
                        Magnetic_h
iosmvc设计模式objective-c学习ui
                        
    MVC前言如何设计一个程序的结构，这是一门专门的学问，叫做"架构模式"（architecturalpattern），属于编程的方法论。MVC模式就是架构模式的一种。它是Apple官方推荐的App开发架构，也是一般开发者最先遇到、最经典的架构。MVC各层controller层Controller/ViewController/VC（控制器）负责协调Model和View，处理大部分逻辑它将数据从Mod
    
                    
    • 
                    
  • element实现动态路由+面包屑
                        软件技术NINI
vue案例vue.js前端
                        
    el-breadcrumb是ElementUI组件库中的一个面包屑导航组件，它用于显示当前页面的路径，帮助用户快速理解和导航到应用的各个部分。在Vue.js项目中，如果你已经安装了ElementUI，就可以很方便地使用el-breadcrumb组件。以下是一个基本的使用示例：安装ElementUI（如果你还没有安装的话）:你可以通过npm或yarn来安装ElementUI。bash复制代码npmi
    
                    
    • 
                    
  • 2021年12月19日，春蕾教育集团团建活动感受——黄晓丹
                        黄错错加油

                        
    感受:1.从陌生到熟悉的过程。游戏环节让我们在轻松的氛围中得到了锻炼，也增长了不少知识。2.游戏过程中，我们贡献的是个人力量，展现的是团队的力量。它磨合的往往不止是工作的熟悉，更是观念上契合度的贴近。3.这和工作是一样的道理。在各自的岗位上，每个人摆正自己的位置、各司其职充分发挥才能，并团结一致劲往一处使，才能实现最大的成功。新知:1.团队精神需要不断地创新。过去，人们把创新看作是冒风险，现在人们
    
                    
    • 
                    
  • 爬山后遗症
                        璃绛

                        
    爬山，攀登，一步一步走向制高点，是一种挑战。成功抵达是一种无法言语的快乐，在山顶吹吹风，看看风景，这是从未有过的体验。然而，爬山一时爽，下山腿打颤，颠簸的路，一路向下走，腿部力量不够，走起来抖到不行，停不下来了！第二天必定腿疼，浑身酸痛，坐立难安！
    
                    
    • 
                    
  • 《策划经理回忆录之二》
                        路基雅虎

                        
    话说三年变六年，飘了，飘了……眨眼，2013年5月，老吴回到了他的家乡——油城从新开启他的工作幻想症生涯。很庆幸，这是一家很有追求，同时敢于尝试的，且实力不容低调的新星房企——金源置业(前身泰源置业)更值得庆幸的是第一个盘就是油城十路的标杆之一:金源盛世。2013年5月，到2015年11月，两年的陪伴，迎来了一场大爆发。2000个筹，5万/筹，直接回笼1个亿！！！这……让我开始认真审视这座看似五线
    
                    
    • 
                    
  • Long类型前后端数据不一致
                        igotyback
前端
                        
    响应给前端的数据浏览器控制台中response中看到的Long类型的数据是正常的到前端数据不一致前后端数据类型不匹配是一个常见问题，尤其是当后端使用Java的Long类型（64位）与前端JavaScript的Number类型（最大安全整数为2^53-1，即16位）进行数据交互时，很容易出现精度丢失的问题。这是因为JavaScript中的Number类型无法安全地表示超过16位的整数。为了解决这个问
    
                    
    • 
                    
  • 30天风格练习-DAY2
                        黄希夷

                        
    Day2（重义）在一个周日/一周的最后一天，我来到位于市中心/市区繁华地带的一家购物中心/商场，中心内人很多/熙熙攘攘。我注意到/看见一个独行/孤身一人的年轻女孩/，留着一头引人注目/长过腰际的头发，上身穿一件暗红色/比正红色更深的衣服/穿在身体上的东西。走下扶梯的时候，她摔倒了/跌向地面，在她正要站起来/让身体离开地面的时候，过长/超过一般人长度的头发被支撑身体/躯干的手掌压/按在下面，她赶紧用
    
                    
    • 
                    
  • 消息中间件有哪些常见类型
                        xmh-sxh-1314
java
                        
    消息中间件根据其设计理念和用途，可以大致分为以下几种常见类型：点对点消息队列（Point-to-PointMessagingQueues）：在这种模型中，消息被发送到特定的队列中，消费者从队列中取出并处理消息。队列中的消息只能被一个消费者消费，消费后即被删除。常见的实现包括IBM的MQSeries、RabbitMQ的部分使用场景等。适用于任务分发、负载均衡等场景。发布/订阅消息模型（Pub/Sub
    
                    
    • 
                    
  • 三大师传
                        beca酱

                        
    巴尔扎克的作品被誉为“法国社会的一面镜子”。文学大师维克多·雨果对巴尔扎克的评价是：“在最伟大的人物中间，巴尔扎克是名列前茅者；在最优秀的人物中间，巴尔扎克是佼佼者之一。”一个原本寂寂无名的小人物，从地中海的某个海岛上，只身一人来到巴黎，没有朋友，也没有名望。作为一个一文不名的外乡人，凭着赤手空拳赢得了巴黎，征服了整个法兰西，并且赢得了世界。这个人就是十九世纪法国伟大的军事家、政治家，法兰西第一帝
    
                    
    • 
                    
  • 开心
                        蒋泳频

                        
    从无比抗拒来上课到接受，感动，收获～看着波哥成长，晶晶幸福笑容满面。感觉自己做的事情很有意义，很开心！还有3个感召目标就是还有三个有缘人，哈哈。明天感召去明日计划：8：30-11：00小公益11：00-21点上班，感召图片发自App图片发自App图片发自App
    
                    
    • 
                    
  • 回溯 Leetcode 332 重新安排行程
                        mmaerd
Leetcode刷题学习记录leetcode算法职场和发展
                        
    重新安排行程Leetcode332学习记录自代码随想录给你一份航线列表tickets，其中tickets[i]=[fromi,toi]表示飞机出发和降落的机场地点。请你对该行程进行重新规划排序。所有这些机票都属于一个从JFK（肯尼迪国际机场）出发的先生，所以该行程必须从JFK开始。如果存在多种有效的行程，请你按字典排序返回最小的行程组合。例如，行程[“JFK”,“LGA”]与[“JFK”,“LGB
    
                    
    • 
                    
  • 每日一题——第八十四题
                        互联网打工人no1
C语言程序设计每日一练c语言
                        
    题目：编写函数1、输入10个职工的姓名和职工号2、按照职工由大到小顺序排列，姓名顺序也随之调整3、要求输入一个职工号，用折半查找法找出该职工的姓名#define_CRT_SECURE_NO_WARNINGS#include#include#defineMAX_EMPLOYEES10typedefstruct{intid;charname[50];}Empolyee;voidinputEmploye
    
                    
    • 
                    
  • 每日一题——第八十二题
                        互联网打工人no1
C语言程序设计每日一练c语言
                        
    题目：将一个控制台输入的字符串中的所有元音字母复制到另一字符串中#include#include#include#include#defineMAX_INPUT1024boolisVowel(charp);intmain(){charinput[MAX_INPUT];charoutput[MAX_INPUT];printf("请输入一串字符串：\n");fgets(input,sizeof(inp
    
                    
    • 
                    
  • 《庄子.达生9》
                        钱江潮369

                        
    【原文】孔子观于吕梁，县水三十仞，流沫四十里，鼋鼍鱼鳖之所不能游也。见一丈夫游之，以为有苦而欲死也，使弟子并流而拯之。数百步而出，被发行歌而游于塘下。孔子从而问焉，曰：“吾以子为鬼，察子则人也。请问，‘蹈水有道乎’”曰：“亡，吾无道。吾始乎故，长乎性，成乎命。与齐俱入，与汩偕出，从水之道而不为私焉。此吾所以蹈之也。”孔子曰：“何谓始乎故，长乎性，成乎命？”曰：“吾生于陵而安于陵，故也；长于水而安于
    
                    
    • 
                    
  • 腾讯云技术深度探索：构建高效云原生微服务架构
                        我的运维人生
云原生架构腾讯云运维开发技术共享
                        
    腾讯云技术深度探索：构建高效云原生微服务架构在当今快速发展的技术环境中，云原生技术已成为企业数字化转型的关键驱动力。腾讯云作为行业领先的云服务提供商，不断推出创新的产品和技术，助力企业构建高效、可扩展的云原生微服务架构。本文将深入探讨腾讯云在微服务领域的最新进展，并通过一个实际案例展示如何在腾讯云平台上构建云原生应用。腾讯云微服务架构概览腾讯云微服务架构基于云原生理念，旨在帮助企业快速实现应用的容
    
                    
    • 
                    
  • 2019-12-22-22:30
                        涓涓1016

                        
    今天是冬至，写下我的日更，是因为这两天的学习真的是能量的满满，让我看到了自己，未来另外一种可能性，也让我看到了这两年这几年的过程中我所接受那些痛苦的来源。一切的根源和痛苦都来自于人生，家庭，而你的原生家庭，你的爸爸和妈妈，是因为你这个灵魂在那一刻选择他们作为你的爸爸和妈妈来的，所以你得接受他，你得接纳他，他就是因为他的存在而给你的学习和成长带来这些痛苦，那其实是你必然要经历的这个过程，当你去接纳的
    
                    
    • 
                    
  • 第四天旅游线路预览——从换乘中心到喀纳斯湖
                        陟彼高冈yu
基于Googleearthstudio的旅游规划和预览旅游
                        
    第四天：从贾登峪到喀纳斯风景区入口，晚上住宿贾登峪；换乘中心有4路车，喀纳斯①号车，去喀纳斯湖，路程时长约5分钟；将上面的的行程安排进行动态展示，具体步骤见”Googleearthstudio进行动态轨迹显示制作过程“、“Googleearthstudio入门教程”和“Googleearthstudio进阶教程“相关内容，得到行程如下所示：Day4-2-480p
    
                    
    • 
                    
  • Python教程：一文了解使用Python处理XPath
                        旦莫
Python进阶python开发语言
                        
    目录1.环境准备1.1安装lxml1.2验证安装2.XPath基础2.1什么是XPath？2.2XPath语法2.3示例XML文档3.使用lxml解析XML3.1解析XML文档3.2查看解析结果4.XPath查询4.1基本路径查询4.2使用属性查询4.3查询多个节点5.XPath的高级用法5.1使用逻辑运算符5.2使用函数6.实战案例6.1从网页抓取数据6.1.1安装Requests库6.1.2代
    
                    
    • 
                    
  • 从鸡肉高汤到记忆的魔法再到有效提示的艺术
                        步子哥
人工智能
                        
    还记得小时候那些天马行空的白日梦吗？也许只要按下键盘上的某个神奇组合，电脑就会发出滴滴的声响，一个隐藏的世界突然在你眼前展开，让你获得超凡的能力，摆脱平凡的生活。这听起来像是玩过太多电子游戏的幻想，但实际上，间隔重复系统给人的感觉惊人地相似。在最佳状态下，这些系统就像魔法一样神奇。本文将以一个看似平凡的鸡肉高汤食谱为例，深入浅出地探讨如何编写有效的间隔重复提示，让你像掌握烹饪技巧一样轻松地掌握记忆
    
                    
    • 
                    
  • 谁家酒器最绝唱，藏在酒厂人未知？景阳冈酒厂先秦藏品大揭秘
                        李虓酒评论

                        
    文/王赛时中国的酒器酒具历史久远，举世闻名。从北京的故宫博物院、中国国家博物馆，到世界各国的大型博物馆，都以能够收藏中国古代酒具而夸耀。但很少有人知道，在山东阳谷景阳冈酒厂，默默地收藏了两千件中国酒器。这些酒器，就封藏在景阳冈的酒道馆里。其中有一些青铜酒器，一睡就是三、四千年，堪称无声国宝，堪作无字史书！今天，我将引领诸位首先窥视一下景阳冈酒道馆的9件先秦藏品，你自己来说震撼不震撼。提示：这只是景
    
                    
    • 
                    
  • 下载github patch到本地
                        小米人er
我的博客gitpatch
                        
    以下是几种从GitHub上下载以.patch结尾的补丁文件的方法：通过浏览器直接下载打开包含该.patch文件的GitHub仓库。在仓库的文件列表中找到对应的.patch文件。点击该文件，浏览器会显示文件的内容，在页面的右上角通常会有一个“Raw”按钮，点击它可以获取原始文件内容。然后在浏览器中使用快捷键（如Ctrl+S或者Command+S）将原始文件保存到本地，选择保存的文件名并确保后缀为.p
    
                    
    • 
                    
  • 18-115 一切思考不能有效转化为行动，都TM是扯淡！
                        成长时间线

                        
    7月25号写了一篇关于为什么会断更如此严重的反思，然而，之后日更仅仅维持了一周，又出现了这次更严重的现象。从8月2号到昨天8月6号，5天！又是5天没有更文！虽然这次断更时间和上次一样，那为什么说这次更严重？因为上次之后就分析了问题的原因，以及应该如何解决，按理说应该会好转，然而，没过几天严重断更的现象再次出现，想想，经过反思，问题依然没有解决与改变，这让我有些担忧。到底是哪里出了问题，难道我就真的
    
                    
    • 
                    
  • 山东大学小树林支教调研团青青仓木队——翟晓楠
                        山东大学青青仓木队

                        
    过了半年，又一次启程，又一次回到支教的初心之地。比起上一次的试探与不安，我更多了一丝稳重与熟练。心境、处境也都随着半个学期的过去而变得不同，半个学期中，身体上的，心理上的，太多的逆境让我变得步履维艰，曲曲折折，弯弯绕绕，我仿佛打不起精神，没有胃口，没有动力。感觉走的不顺畅的时候，支教这个旅程，给了我力量。自告奋勇承担起队长这一职务的我，从组织时的复杂和困难的经历，协调各种问题，从无到有，和校长和队
    
                    
    • 
                    
  • 《中华小厨师》单行VS爱藏：姜是老的辣，书是新的好
                        cicoky

                        
    《汉书·郦食其传》有曰：“王者以民为天，而民以食为天。”自古以来，吃饱饭是每一个人的基本要求，而吃好饭却是每一个人的最终追求。于是，厨师这一职业孕育而生，其渊源之久，甚至可追溯到4000年前的奴隶时代。职业本身无贵贱，但职业能力却有高低之分。所以一家餐馆生意好不好，厨师的水平决定一切，而站在所有厨师顶端的就被称之为“特级厨师”。今天要说的就是一个关于“特级厨师刘昴星”的故事。连载历程1995年第4
    
                    
    • 
                    
  • 拥有断舍离的心态，过精简生活--《断舍离》读书笔记
                        爱吃丸子的小樱桃

                        
    不知不觉间房间里的东西越来越多，虽然摆放整齐，但也时常会觉得空间逼仄，令人心生烦闷。抱着断舍离的态度，我开始阅读《断舍离》这本书，希望从书中能找到一些有效的方法，帮助我实现空间、物品上的断舍离。《断舍离》是日本作家山下英子通过自己的经历、思考和实践总结而成的，整体内涵也从刚开始的私人生活哲学的“断舍离”升华成了“人生实践哲学”，接着又成为每个人都能实行的“改变人生的断舍离”，从“哲学”逐渐升华成“
    
                    
    • 
                                
  • 设计模式介绍
                                    tntxia
设计模式
                                    
    设计模式来源于土木工程师 克里斯托弗 亚历山大（http://en.wikipedia.org/wiki/Christopher_Alexander）的早期作品。他经常发表一些作品，内容是总结他在解决设计问题方面的经验，以及这些知识与城市和建筑模式之间有何关联。有一天，亚历山大突然发现，重复使用这些模式可以让某些设计构造取得我们期望的最佳效果。 
 
亚历山大与萨拉-石川佳纯和穆雷 西乐弗斯坦合作
    
                                
    • 
                                
  • android高级组件使用(一)
                                    百合不是茶
androidRatingBarSpinner
                                    
    1、自动完成文本框（AutoCompleteTextView） 
 
 AutoCompleteTextView从EditText派生出来，实际上也是一个文本编辑框，但它比普通编辑框多一个功能：当用户输入一个字符后，自动完成文本框会显示一个下拉菜单，供用户从中选择，当用户选择某个菜单项之后，AutoCompleteTextView按用户选择自动填写该文本框。 
 使用AutoCompleteTex
    
                                
    • 
                                
  • [网络与通讯]路由器市场大有潜力可挖掘
                                    comsci
网络
                                    
       
       如果国内的电子厂商和计算机设备厂商觉得手机市场已经有点饱和了,那么可以考虑一下交换机和路由器市场的进入问题..... 
 
       这方面的技术和知识,目前处在一个开放型的状态,有利于各类小型电子企业进入 
 
 &nbs
    
                                
    • 
                                
  • 自写简单Redis内存统计shell
                                    商人shang
Linux shell统计Redis内存
                                    
    #!/bin/bash
address="192.168.150.128:6666,192.168.150.128:6666"  
hosts=(${address//,/ })  

sfile="staticts.log"

for hostitem in ${hosts[@]}  
do  
    ipport=(${hostitem
    
                                
    • 
                                
  • 单例模式(饿汉 vs懒汉)
                                    oloz
单例模式
                                    
    package 单例模式;
/*
 * 应用场景:保证在整个应用之中某个对象的实例只有一个
 * 单例模式种的《 懒汉模式》  
 * */
public class Singleton {
	
	//01 将构造方法私有化，外界就无法用new Singleton()的方式获得实例
	private Singleton(){};
	
	//02 申明类得唯一实例
	priva
    
                                
    • 
                                
  • springMvc json支持
                                    杨白白
json springmvc
                                    
    1.Spring mvc处理json需要使用jackson的类库，因此需要先引入jackson包 
 
 
2在spring mvc中解析输入为json格式的数据:使用@RequestBody来设置输入 
 

@RequestMapping("helloJson")
public @ResponseBody
    JsonTest helloJson() {
   
    
                                
    • 
                                
  • android播放，掃描添加本地音頻文件
                                    小桔子

                                    
            最近幾乎沒有什麽事情，繼續鼓搗我的小東西。想在項目中加入一個簡易的音樂播放器功能，就像華為p6桌面上那麼大小的音樂播放器。用過天天動聽或者QQ音樂播放器的人都知道，可已通過本地掃描添加歌曲。不知道他們是怎麼實現的，我覺得應該掃描設備上的所有文件，過濾出音頻文件，每個文件實例化為一個實體，記錄文件名、路徑、歌手、類型、大小等信息。具體算法思想，
    
                                
    • 
                                
  • oracle常用命令
                                    aichenglong
oracledba常用命令
                                    
    1 创建临时表空间 
create temporary tablespace user_temp  
tempfile 'D:\oracle\oradata\Oracle9i\user_temp.dbf' 
size 50m  
autoextend on  
next 50m maxsize 20480m  
extent management local
    
                                
    • 
                                
  • 25个Eclipse插件
                                    AILIKES
eclipse插件
                                    
    提高代码质量的插件1. FindBugsFindBugs可以帮你找到Java代码中的bug，它使用Lesser GNU Public License的自由软件许可。2. CheckstyleCheckstyle插件可以集成到Eclipse IDE中去，能确保Java代码遵循标准代码样式。3. ECLemmaECLemma是一款拥有Eclipse Public License许可的免费工具，它提供了
    
                                
    • 
                                
  • Spring MVC拦截器+注解方式实现防止表单重复提交
                                    baalwolf
spring mvc
                                    
    原理：在新建页面中Session保存token随机码，当保存时验证，通过后删除，当再次点击保存时由于服务器端的Session中已经不存在了，所有无法验证通过。      
1.新建注解： 
     
?       1   2   3   4   5   6   7   8   9   10   11   12   13   14   15   16   17   18   
    
                                
    • 
                                
  • 《Javascript高级程序设计(第3版)》闭包理解
                                    bijian1013
JavaScript
                                    
    “闭包是指有权访问另一个函数作用域中的变量的函数。”--《Javascript高级程序设计(第3版)》 
  
      看以下代码： 
<script type="text/javascript">
    function outer() {
        var i = 10;
        return f
    
                                
    • 
                                
  • AngularJS Module类的方法
                                    bijian1013
JavaScriptAngularJSModule
                                    
            AngularJS中的Module类负责定义应用如何启动，它还可以通过声明的方式定义应用中的各个片段。我们来看看它是如何实现这些功能的。 
一.Main方法在哪里 
        如果你是从Java或者Python编程语言转过来的，那么你可能很想知道AngularJS里面的main方法在哪里？这个把所
    
                                
    • 
                                
  • [Maven学习笔记七]Maven插件和目标
                                    bit1129
maven插件
                                    
    插件(plugin)和目标(goal) 
Maven，就其本质而言，是一个插件执行框架，Maven的每个目标的执行逻辑都是由插件来完成的，一个插件可以有1个或者几个目标，比如maven-compiler-plugin插件包含compile和testCompile，即maven-compiler-plugin提供了源代码编译和测试源代码编译的两个目标 
  
使用插件和目标使得我们可以干预
    
                                
    • 
                                
  • 【Hadoop八】Yarn的资源调度策略
                                    bit1129
hadoop
                                    
    1. Hadoop的三种调度策略 
Hadoop提供了3中作业调用的策略， 
 
 FIFO Scheduler 
 Fair Scheduler 
 Capacity Scheduler 
 
以上三种调度算法，在Hadoop MR1中就引入了，在Yarn中对它们进行了改进和完善.Fair和Capacity Scheduler用于多用户共享的资源调度 
  2. 多用户资源共享的调度 
    
                                
    • 
                                
  • Nginx使用Linux内存加速静态文件访问
                                    ronin47

                                    
    Nginx是一个非常出色的静态资源web服务器。如果你嫌它还不够快，可以把放在磁盘中的文件，映射到内存中，减少高并发下的磁盘IO。 
先做几个假设。nginx.conf中所配置站点的路径是/home/wwwroot/res，站点所对应文件原始存储路径：/opt/web/res 
shell脚本非常简单，思路就是拷贝资源文件到内存中，然后在把网站的静态文件链接指向到内存中即可。具体如下：      
    
                                
    • 
                                
  • 关于Unity3D中的Shader的知识
                                    brotherlamp
unityunity资料unity教程unity视频unity自学
                                    
    首先先解释下Unity3D的Shader，Unity里面的Shaders是使用一种叫ShaderLab的语言编写的，它同微软的FX文件或者NVIDIA的CgFX有些类似。传统意义上的vertex shader和pixel shader还是使用标准的Cg/HLSL 编程语言编写的。因此Unity文档里面的Shader，都是指用ShaderLab编写的代码，然后我们来看下Unity3D自带的60多个S
    
                                
    • 
                                
  • CopyOnWriteArrayList vs ArrayList
                                    bylijinnan
java
                                    
    package com.ljn.base;

import java.util.ArrayList;
import java.util.Iterator;
import java.util.List;
import java.util.concurrent.CopyOnWriteArrayList;

/**
 * 总述：
 * 1.ArrayListi不是线程安全的，CopyO
    
                                
    • 
                                
  • 内存中栈和堆的区别
                                    chicony
内存
                                    
      
1、内存分配方面： 
 
    堆：一般由程序员分配释放， 若程序员不释放，程序结束时可能由OS回收 。注意它与数据结构中的堆是两回事，分配方式是类似于链表。可能用到的关键字如下：new、malloc、delete、free等等。 
 
    栈：由编译器(Compiler)自动分配释放，存放函数的参数值，局部变量的值等。其操作方式类似于数据结构中
    
                                
    • 
                                
  • 回答一位网友对Scala的提问
                                    chenchao051
scalamap
                                    
    本来准备在私信里直接回复了，但是发现不太方便，就简要回答在这里。  问题 写道   对于scala的简洁十分佩服，但又觉得比较晦涩，例如一例，Map("a" -> List(11,111)).flatMap(_._2)，可否说下最后那个函数做了什么，真正在开发的时候也会如此简洁？谢谢  
   先回答一点，在实际使用中，Scala毫无疑问就是这么简单。
    
                                
    • 
                                
  • mysql 取每组前几条记录
                                    daizj
mysql分组最大值最小值每组三条记录
                                    
    一、对分组的记录取前N条记录：例如：取每组的前3条最大的记录    1.用子查询：   SELECT * FROM tableName a  WHERE 3>   (SELECT COUNT(*) FROM  tableName b WHERE b.id=a.id AND b.cnt>a. cnt)   ORDER BY a.id,a.account DE
    
                                
    • 
                                
  • HTTP深入浅出 http请求
                                    dcj3sjt126com
http
                                    
        HTTP(HyperText Transfer Protocol)是一套计算机通过网络进行通信的规则。计算机专家设计出HTTP，使HTTP客户（如Web浏览器）能够从HTTP服务器(Web服务器)请求信息和服务，HTTP目前协议的版本是1.1.HTTP是一种无状态的协议，无状态是指Web浏览器和Web服务器之间不需要建立持久的连接，这意味着当一个客户端向服务器端发出请求，然后We
    
                                
    • 
                                
  • 判断MySQL记录是否存在方法比较
                                    dcj3sjt126com
mysql
                                    
    把数据写入到数据库的时，常常会碰到先要检测要插入的记录是否存在，然后决定是否要写入。 
　　我这里总结了判断记录是否存在的常用方法： 
　　sql语句：  select   count ( * )  from  tablename;  
　　然后读取count(*)的值判断记录是否存在。对于这种方法性能上有些浪费，我们只是想判断记录记录是否存在，没有必要全部都查出来。
    
                                
    • 
                                
  • 对HTML XML的一点认识
                                    e200702084
htmlxml
                                    
    感谢http://www.w3school.com.cn提供的资料 
HTML 文档中的每个成分都是一个节点。 
节点 
根据 DOM，HTML 文档中的每个成分都是一个节点。 
 
DOM 是这样规定的： 
 
整个文档是一个文档节点 
每个 HTML 标签是一个元素节点 
包含在 HTML 元素中的文本是文本节点 
每一个 HTML 属性是一个属性节点 
注释属于注释节点 
Node 层次 

    
                                
    • 
                                
  • jquery分页插件
                                    genaiwei
jqueryWeb前端分页插件
                                    
    //jquery页码控件// 创建一个闭包    (function($) {      // 插件的定义      $.fn.pageTool = function(options) {          var totalPa
    
                                
    • 
                                
  • Mybatis与Ibatis对照入门于学习
                                    Josh_Persistence
mybatisibatis区别联系
                                    
    一、为什么使用IBatis/Mybatis 
        对于从事 Java EE 的开发人员来说，iBatis 是一个再熟悉不过的持久层框架了，在 Hibernate、JPA 这样的一站式对象 / 关系映射（O/R Mapping）解决方案盛行之前，iBaits 基本是持久层框架的不二选择。即使在持久层框架层出不穷的今天，iBatis 凭借着易学易用、
    
                                
    • 
                                
  • C中怎样合理决定使用那种整数类型？
                                    秋风扫落叶
c数据类型
                                    
    如果需要大数值(大于32767或小于32767), 使用long 型。 否则, 如果空间很重要 (如有大数组或很多结构), 使用 short 型。 除此之外, 就使用 int 型。 如果严格定义的溢出特征很重要而负值无关紧要, 或者你希望在操作二进制位和字节时避免符号扩展的问题, 请使用对应的无符号类型。 但是, 要注意在表达式中混用有符号和无符号值的情况。 
  
 &nbs
    
                                
    • 
                                
  • maven问题
                                    zhb8015
maven问题
                                    
      
问题1： 
Eclipse 中 新建maven项目 无法添加src/main/java 问题 
   eclipse创建maevn web项目，在选择maven_archetype_web原型后，默认只有src/main/resources这个Source Floder。 
    按照maven目录结构，添加src/main/ja
    
                                
    • 
                                
  • (二)androidpn-server tomcat版源码解析之--push消息处理
                                    spjich
javaandrodipn推送
                                    
    在 (一)androidpn-server tomcat版源码解析之--项目启动这篇中，已经描述了整个推送服务器的启动过程，并且把握到了消息的入口即XmppIoHandler这个类，今天我将继续往下分析下面的核心代码，主要分为3大块，链接创建，消息的发送，链接关闭。 
先贴一段XmppIoHandler的部分代码 
/**
     * Invoked from an I/O proc
    
                                
    • 
                                
  • 用js中的formData类型解决ajax提交表单时文件不能被serialize方法序列化的问题
                                    中华好儿孙
JavaScriptAjaxWeb上传文件FormData
                                    
    
var formData = new FormData($("#inputFileForm")[0]);
$.ajax({
		type:'post',
		url:webRoot+"/electronicContractUrl/webapp/uploadfile",
		data:formData,
		async: false,
		ca
    
                                
    • 
                                
  • mybatis常用jdbcType数据类型
                                    ysj5125094
mybatismapperjdbcType
                                    
      
MyBatis 通过包含的jdbcType
类型 
BIT         FLOAT      CHAR          
    
                                
    •