Node.js API 初解读(一)
Node.JS API 初解读
Version: NodeJs v6.2.0
一、 Assert
1、简介
Assert模块主要用于断言。如果表达式不符合预期,就抛出一个错误。
该模块用于编写程序的单元测试用例,通过require(‘assert’)调用。
2、函数
assert(value[, message])
assert.ok(value[, message])
3、例子
// assert.js
const assert = require('assert');
const add = function(a, b) {
return a + b;
};
const expected = add(1, 2);
assert(expected === 1, '预期1+2 = 3');
4、运行例子
node assert.js
-------------------------------
throw new assert.AssertionError({
^
AssertionError: 预期1+2 = 3
at Object.<anonymous> (D:\0\nodejs\assert.js:8:1)
at Module._compile (module.js:541:32)
...
-------------------------------
二、Buffer
1、简介
JavaScript 语言自身只有字符串数据类型,没有二进制数据类型。
但在处理像TCP流或文件流时,必须使用到二进制数据。
因此在 Node.js中,定义了一个 Buffer 类,该类用来创建一个专门存放二进制数据的缓存区。
注意: 因为 Buffer 类 属于 node 的 全局构造函数。 全局那么自然就不要每次的require了,直接使用
像使用 JS 构造函数那样 实例化
1.1缓存区
这里我们详细的介绍下 缓存区的作用
buffer 有缓冲的功能,可以提高读写效率, 减少系统调用。
比如你写一个文件, 直接写 写一个字节访问一次硬盘 对硬盘来讲很伤的。
然后你用buffer之后, 是一次写入10000个字节 写入同样的内容, 你访问硬盘的次数少了
硬盘折寿就没那么严重, 而且访问硬盘的次数少的话, 调用系统api的次数也少了。 整个效率就提高了
2、函数
new Buffer(10);
3、例子
// buffer.js
const buf = new Buffer(10);
console.log(buf);
4、运行例子
node buffer.js
----------------------------
<Buffer 05 00 00 00 01 00 00 00 00 00>
三、 Addons
1、简介
Addons 是 属于nodejs 的一个 扩展插件。当node某些默认的 api 已经不能够满足你的开发需求的时候, 你就可以通过Addons 来开发出你想要的 扩展插件。
2、函数
在编写node 的插件的过程中需要 了解一些 nodeJs 提供的一些 主要类库(这里理解成开发插件常会用的 API )
这里我们着重介绍四个 类库 ( 2.1 - 2.4 )
>2.1
V8 JavaScript,C++类库,作为JavaScript的接口类,主要用于创建对象、调用方法等功能。大部分功能在头文件v8.h (在node文件夹下的路径为deps/v8/include/v8.h)
>2.2
libuv 基于C的事件循环库,当需要等待的文件描述符可读时,等待定时器,或者等到接受信号时,会调用libuv的接口,也可以说,任何I/O操作,都需要调用libuv库
>2.3
内部Node的库,可以通过node::ObjectWrap来调用Node.js内部的库。
>2.4
其他的一些类库同样可以在deps/ 中找到
// 我们希望能够开发一个简单的类库 如下使用方式
module.exports.hello = function() { return 'world'; };
3、例子
C/C++
#include <node.h>
#include <v8.h>
using namespace v8;
Handle<Value> Method(const Arguments& args) {
HandleScope scope;
return scope.Close(String::New("world"));
}
void init(Handle<Object> exports) {
exports->Set(String::NewSymbol("hello"),
FunctionTemplate::New(Method)->GetFunction());
}
NODE_MODULE(hello, init)
//请注意:所有的Node Addons 必须通过以下初始化代码导出
void Initialize (Handle<Object> exports);
NODE_MODULE(module_name, Initialize)
4、运行例子
var addon = require('./build/Release/hello');
console.log(addon.hello()); // 'world'
// 最终输出 world 就算你最简单的 Addons (hello world)类库编写完成啦~