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:
odejsassert.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)类库编写完成啦~
原文地址:https://www.cnblogs.com/erbingbing/p/6168804.html