本文是对nodejs0.8.8版本的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章节