一起读nodejs(一)----概览和全局对象(Synopsis &Global Objects)

ezeke

　　本文是对nodejs0.8.9版本的api开发手册解读.nodejs网址
　　   概览(synopsis)
　　一个简单的用node写的 web server的例子,用来输出"hello world":

var http = require('http');
http.createServer(function (request, response) {
response.writeHead(200, {'Content-Type': 'text/plain'});
response.end('Hello World\n');
}).listen(8124);
console.log('Server running at http://127.0.0.1:8124/');
　　为了运行这个服务,需要把这段代码放入一个example.js的文件里,然后用下面的代码来执行它.windows下需要用cmd进入example.js所在目录执行

> node example.js
Server running at http://127.0.0.1:8124/
　　这个文档里的例子都可以这样简单的运行起来.
　　

　　全局对象(global objects)
　　这些对象在所有的模块中可见,其中一些对象不是真正的全局对象scope,而是模块scope,这些对象会被标注出来.
　　global:对象类型,全局命名空间对象

在浏览器中,最高级别的作用域是global scope,这意味着如果你在global scope 中使用var 定义一个变量,这个变量将会被定义成global scope.但是在node里是不一样的,最高级别的scope不是global scope,在一个module里 用var定义个变量,这个变量只是在这个module的scope里.

process:对象类型

process对象详见process章节

console:对象类型

常用于打印到stdout和stderr,详见stdio章节

Calss:Buffer :function类型

常用于处理二进制数据,详见buffer章节

require():方法类型

为了获取必须的modules,详见Modules章节,require不是真正的全局对象scope,而是内置于每个module 中.

require.resolve()

使用内置的require()机制来查询本地的module,但是不加载这个module,只是返回resolved到的文件名称

require.cache:对象类型

当module被require()方法加载之后,会被缓存到cache对象当中.通过删除一个key value ,可以让下次require()方法重新加载这个module

require.extensions:数组类型

通知require方法如何处理确定的文件扩展.看例子

把文件后缀为sjs的扩展当作整成的js文件来处理:
require.extensions['.sjs'] = require.extensions['.js'];
编写你自己的扩展处理:
require.extensions['.sjs'] = function(module, filename) {
var content = fs.readFileSync(filename, 'utf8');
// Parse the file content and give to module.exports
module.exports = content;
};
_filename:字符串对象


代表当前正在执行代码所在文件的名称.是当前代码文件的绝对路径.对一个主程序来说,在命令行中使用同一个文件名不是不需的.如果在一个module里面,_filename的值是这个module文件的路径.

例子:在/user/mjr下运行node example.js:
console.log(__filename);
// /Users/mjr/example.js
_filename不是真正的全局对象scope,而是内置于每个module 中.


_dirname:字符串类型

当前执行脚本所在的目录,

例子:在/user/mjr下运行node example.js:
console.log(__dirname);
// /Users/mjr
_dirname不是真正的全局对象scope,而是内置于每个module 中.


module:对象类型

代表当前module的一个索引,尤其是module.exports和exports是同一对象.module不是真正的全局对象scope,而是内置于每个module 中.详见module sysem章节

exports

将一个独享共享与当前所有的module实例下,包括require()获取的module.module.exports和exports是同一对象.exports不是真正的全局对象scope,而是内置于每个module 中.详见:module system章节 和module章节

setTimeOut(cb,ms)

在ms毫秒后运行回调函数cb,实际的延迟依赖于外部的因素,例如:操作系统定时器的间隔粒度和系统加载.

ms设置的范围必须在1~2147483647之间,如果超出范围超时时间,将会被设置成1毫秒,通俗的说就是一个定时器不能超过24.8天.

返回一个代表定时器的不透明的值.

clearTimeOut(t)

停止一个先前用setTimeOut()创建的定时器,先前设置的回调函数不会被执行.

setInterval(cb,ms)

每过ms毫秒,就重复的执行一次回调函数cb,注意这个internval实际上可能会发生变化依赖于外部的因素,例如:操作系统定时器的间隔粒度和系统加载.它绝对不会在小于ms毫秒的情况下执行,只有可能比ms更长.

ms这是的范围必须在1~2147483647之间,如果超出范围超时时间,将会被设置成1毫秒,通俗的说就是一个定时器不能超过24.8天.
返回一个代表定时器的不透明的值.


　　clearInterval(t)
　　停止一个先前用setInterval()创建的定时器,先前设置的回调函数不会被执行.
　　以上的定时器函数是global变量,详见:timers章节