Node.js的核心模块

Node.js的核心模块又一系列简洁而高效的库组成,为Node.js提供了最基本的api。

全局对象

Node.js 中的全局对象是 global,所有全局变量(除了global本身以外)都是global对象的属性。global最根本的作用是作为全局变量的宿主,全局对象满足以下几个条件:
- 变量是在最外层定义的
- 是全局对象的属性
- 是隐式定义的变量

util

util 是一个 Node.js 核心模块,提供常用函数的集合。

util.inherits

util.inherits(constructor, superConstructor)是一个实现对象间原型继承 的函数。示例如下:


var util = require("util"); function Base() { this.name = "XiongYu"; this.addr = "SiChuan"; this.sayHello = function () { console.log("Hello " + this.name + " form " + this.addr); } } Base.prototype.sayName = function () { console.log(this.name) }; function Sub() { this.name = "Sub" } util.inherits(Sub, Base); var objBase = new Base(); objBase.sayName(); objBase.sayHello(); console.log(objBase); console.log(); var objSub = new Sub(); objSub.sayName(); // objSub.sayHello(); console.log(objSub);

有下面三点需要说明:
- 这段代码十分简单,但是我们重要的是看到了一个十分惊讶的结果,obj被我们赋予了属性,就如同我们在C#中使用某个类的实例的时候一样。那么这个属性是怎么样产生的呢?关键语句:this.name=value。这句话就是进行一个属性的申明与赋值,这里,我们肯定会问到,this是什么?为什么可以使用this.x来进行申明与赋值属性呢?其实this代表的就是我们刚刚实例化出来的obj,就相当于我们使用obj去调用了构造函数A里面的属性、方法等等。

  • Base和一个继承自Base的Sub,Base有三个在构造函数内定义的属性和一个原型中定义的函数,通过 util.inherits实现继承
  • Sub仅仅继承了Base在原型中定义的函数,而构造函数内部创造的base属性和sayHello函数都没有被 Sub继承。如果执行objSub.sayHello(),就会报错:TypeError: objSub.sayHello is not a function

util.inspect

util.inspect(object,[showHidden],[depth],[colors])是一个将任意对象转换 为字符串的方法,通常用于调试和错误输出。它至少接受一个参数 object,即要转换的对象。
- showHidden 是一个可选参数,如果值为true,将会输出更多隐藏信息。
- depth 表示最大递归的层数,如果对象很复杂,你可以指定层数以控制输出信息的多 少。如果不指定depth,默认会递归2层,指定为 null 表示将不限递归层数完整遍历对象
- 如果color 值为 true,输出格式将会以 ANSI 颜色编码,通常用于在终端显示更漂亮 的效果。
- util.inspect并不会简单的把对象转换成字符串,就是对象定义了toString()方法也不行

事件驱动 events

Node.js的架构是事件方式的,evetns提供了唯一的接口。

事件发生器

events 模块只提供了一个对象: events.EventEmitter。EventEmitter 的核心就 是事件发射与事件监听器功能的封装。EventEmitter 的每个事件由一个事件名和若干个参 数组成,事件名是一个字符串,通常表达一定的语义。对于每个事件,EventEmitter 支持 若干个事件监听器。当事件发射时,注册到这个事件的事件监听器被依次调用,事件参数作 为回调函数参数传递。

var events = require("events")
var eventemitter = new events.EventEmitter();
//为事件mEvents注册监听
eventemitter.on("mEvents", function (args1, args2) {
    console.log('Hello this is first one', "first args:" + args1, "   ", "second args:" + args2);
});

eventemitter.on("mEvents", function (args1, args2) {
    console.log('Hello this is first one', "first args:" + args1, "   ", "second args:" + args2);
});


//移除指定事件的某个监听
var listener=function (args1, args2) {
    console.log('Hello this is third one', "first args:" + args1, "   ", "second args:" + args2);
};
eventemitter.on("mEvents",listener);



//发射事件
eventemitter.emit("mEvents", "第一个参数", "第二个参数");

首先,eventemitter为事件mEvents注册了两个监听器,然后发送了mEvents事件。之后前两个监听器先后都得到了执行。最后一个因为已经移除了,所以并没有得到执行。如果一处某个事件所有的监听,则可以使用eventemitter.removeAllListeners([event]);

error事件

EventEmitter 定义了一个特殊的事件 error,它包含了“错误”的语义,我们在遇到 异常的时候通常会发射error事件。当 error 被发射时,EventEmitter 规定如果没有响 应的监听器,Node.js 会把它当作异常,退出程序并打印调用栈。执行下面的程序就会发生错误:

var events=require("events");
var eventEmitter=new events.EventEmitter();
eventEmitter.emit("error");

错误信息为:

Error: Uncaught, unspecified "error" event. (undefined)

文件系统 fs

fs 模块是文件操作的封装,它提供了文件的读取、写入、更名、删除、遍历目录、链接等 POSIX 文件系统操作。

fs.readFile

fs.readFile(filename,[encoding],[callback(err,data)])是最简单的读取 文件的函数。它接受一个必选参数 filename,表示要读取的文件名。第二个参数 encoding 是可选的,表示文件的字符编码。callback 是回调函数,用于接收文件的内容。如果不指 定encoding,则callback就是第二个参数。如果指定了 encoding,data 是一个解析后的字符 串,否则 data 将会是以 Buffer 形式表示的二进制数据。

var fs=require("fs");

fs.readFile("./globolobject/safeandsound.txt","utf-8",function (data, error) {
    if(error)
        console.log(error);
    else
        console.log(data);
});

如果出现错误会打印出错误信息,否则会打印出文件内容。

HTTP 服务器与客户端

Node.js 标准库提供了 http 模块,其中封装了一个高效的 HTTP 服务器和一个简易的 HTTP 客户端。http.Server 是一个基于事件的 HTTP 服务器,它的核心由 Node.js 下层 C++ 部分实现,而接口由 JavaScript 封装,兼顾了高性能与简易性。http.request 则是一个 HTTP 客户端工具,用于向 HTTP 服务器发起请求,例如实现 Pingback1或者内容抓取。

HTTP 服务器

http.Server 是 http 模块中的 HTTP 服务器对象,用 Node.js 做的所有基于 HTTP 协 议的系统,如网站、社交应用甚至代理服务器,都是基于 http.Server 实现的。它提供了 一套封装级别很低的 API,仅仅是流控制和简单的消息解析,所有的高层功能都要通过它的 接口来实现。下面的代码可以实现一个简单的服务器:

http.Server

var http=require("http");
http.createServer(function (req, res) {
    res.writeHead(200, {'Content-Type': 'text/html'});
    res.write('<h1>Node.js</h1>');
    res.write('<img src="https://ss2.baidu.com/6ONYsjip0QIZ8tyhnq/it/u=950502116,2213091146&fm=58&u_exp_0=383468501,1879785736&fm_exp_0=86&bpow=1000&bpoh=1500"/>');

    res.end('<p>Hello HandSome</p>');
}).listen(1234);
console.log("服务器已经启动");

也可以这样写:


var http = require("http"); var server = new http.Server(); server.on("request", function (req, res) { res.writeHead(200, {'Content-Type': 'text/html'}); res.write('<h1>Node.js</h1>'); res.end('<p>Hello World</p>'); }).listen(12345)

http.ServerRequest

http.ServerRequest一般由http.Server的request事件发送,作为第一个参数传递,通常简称request或req。
http.ServerRequest的相关属性:

名称 说明
complete 客户端请求是否已经发送完成
httpVersion HTTP 协议版本,通常是 1.0 或 1.1
method HTTP 请求方法,如 GET、POST、PUT、DELETE 等
url 原始始的请求路径
headers HTTP 请求头
trailers HTTP 请求尾(不常见)
connection 当前 HTTP 连接套接字,为 net.Socket 的实例
socket connection 属性的别名
client client 属性的别名

获取GET请求内容

由于 GET 请求直接被嵌入在路径 中,URL是完整的请求路径,包括了 ? 后面的部分,因此你可以手动解析后面的内容作为 GET 请求的参数。

var http=require("http");
var url=require("url");
var util=require("util");
http.createServer(function (req, res) {
    res.writeHead(200, {'Content-Type': 'text/html'});
    res.write('<h1>Node.js</h1>');
    res.end(util.inspect(url.parse(req.url,true)));
}).listen(1234);
console.log("Server is ready on port 1234");

在浏览器输入http://localhost:1234/?username=xiongyu&age=20,页面上会打印出

Url { protocol: null, slashes: null, auth: null, host: null, port: null, hostname: null, hash: null, search: '?username=xiongyu&age=20', query: { username: 'xiongyu', age: '20' }, pathname: '/', path: '/?username=xiongyu&age=20', href: '/?username=xiongyu&age=20' }

通过 url.parse1,原始的 path 被解析为一个对象,其中 query 就是我们所谓的 GET 请求的内容,而路径则是 pathname。

获取 POST 请求内容

示例:


var http = require("http"); var util = require("util"); var querystring = require("querystring"); http.createServer(function (req, res) { var post = ""; req.on("data", function (chunk) { post += chunk; }); req.on("end",function () { post=querystring.parse(post); res.write(util.inspect(post,true)); res.end(util.inspect(post,true)) }) }).listen(1234); console.log("Server is ready on port 1234");

http.ServerResponse

http.ServerResponse 是返回给客户端的信息,决定了用户最终能看到的结果。它也是由 http.Server的request事件发送的,作为第二个参数传递,一般简称为 response 或 res。
http.ServerResponse 有三个重要的成员函数,用于返回响应头、响应内容以及结束 请求。
- response.writeHead(statusCode, [headers]):向请求的客户端发送响应头。 statusCode 是 HTTP 状态码,如 200 (请求成功)、404 (未找到)等。headers 是一个类似关联数组的对象,表示响应头的每个属性。该函数在一个请求内最多只 能调用一次,如果不调用,则会自动生成一个响应头。
- response.write(data, [encoding]):向请求的客户端发送响应内容。data 是 一个 Buffer 或字符串,表示要发送的内容。如果 data 是字符串,那么需要指定 encoding 来说明它的编码方式,默认是 utf-8。在 response.end 调用之前, response.write 可以被多次调用。
- response.end([data], [encoding]):结束响应,告知客户端所有发送已经完 成。当所有要返回的内容发送完毕的时候,该函数 必须 被调用一次。它接受两个可 选参数,意义和 response.write 相同。如果不调用该函数,客户端将永远处于 等待状态。

HTTP客户端

http 模块提供了两个函数 http.request 和 http.get,功能是作为客户端向 HTTP 服务器发起请求。

  • http.request(options, callback) 发起 HTTP 请求。接受两个参数,option 是 一个类似关联数组的对象,表示请求的参数,callback 是请求的回调函数。option 常用的参数如下所示。
    • host :请求网站的域名或 IP 地址。
    • port :请求网站的端口,默认 80。
    • method :请求方法,默认是 GET。
    • path :请求的相对于根的路径,默认是“/”。QueryString 应该包含在其中。例如 /search?query=byvoid。
    • headers :一个关联数组对象,为请求头的内容。
    • callback 传递一个参数,为http.ClientResponse的实例。 http.request 返回一个http.ClientRequest的实例。

POST示例代码:

var http = require("http");
var querystring = require("querystring");

//参数
var contents = querystring.stringify({
    usernmae: "xiongyu",
    email: "ixiongyu@gmai.com"
});

var options = {
    host: "www.ixiongyu.com",//千万不能加http 加了是错的
    path: "/shop/test",
    method: 'POST',
    headers: {
        'Content-Type': 'application/x-www-form-urlencoded',
        'Content-Length': contents.length
    }
};

var req = http.request(options, function (res) {
    res.setEncoding('utf8');
    res.on("data", function (data) {
        console.log(data);
    });
    res.on("error",function (error) {
        console.log(error);
    });
});

req.write(contents);
req.end();

host那里不能加http,加了是错的!错的!错的!

GET示例代码:

var http = require('http');
http.get({host: 'www.ixiongyu.com'}, function(res) { res.setEncoding('utf8');
res.on('data', function (data) {
           console.log(data);
         });
});

http.ClientRequest

http.ClientRequest 是由 http.request 或 http.get 返回产生的对象,表示一个已经产生而且正在进行中的 HTTP 请求。它提供一个 response 事件,即 http.request 或 http.get 第二个参数指定的回调函数的绑定对象。http.ClientRequest 像 http.ServerResponse 一样也提供了 write 和 end 函 数,用于向服务器发送请求体,通常用于 POST、PUT 等操作。所有写结束以后必须调用 end 函数以通知服务器,否则请求无效。http.ClientRequest 还提供了以下函数。
- request.abort():终止正在发送的请求。
- request.setTimeout(timeout, [callback]):设置请求超时时间,timeout 为毫秒数。当请求超时以后,callback 将会被调用。

http.ClientResponse

http.ClientResponse 与 http.ServerRequest 相似,提供了三个事件 data、end和 close,分别在数据到达、传输结束和连接结束时触发,其中 data 事件传递一个参数 chunk,表示接收到的数据。

One thought on “Node.js的核心模块

发表评论

电子邮件地址不会被公开。 必填项已用*标注