Node-fs

Nodejs内置fs模块就是文件系统模块,负责读写文件
和所有其他JavaScript模块不同的是,fs模块同时提供了异步和同步的方法
'use strict'

回顾一下什么是异步方法,因为JavaScript的单线程模型,执行IO操作时,JavaScript无需等待,而是传入回调函数后,继续执行JavaScript代码,比如jQuery提供的getJSON()操作

$.getJSON('http://exmaple.com/ajax',function(data){
    console.log('IO结果返回后执行...');
});
console.log('不等待IO结果直接执行后续代码');

而同步的IO操作则需要等待函数返回:
根据网络耗时,函数将执行几十毫秒~几秒不等

var data = getJsonSync('http://exmaple.com/ajax');

同步操作的好处是代码简单,缺点是程序将等待IO操作,在等待时间内,无法响应其它任何事件。而异步读取不用等待IO操作,但代码较麻烦。

异步读文件

//按照JavaScript的标准,异步读取一个文本文件的代码如下

var fs = require('fs');
fs.readFile('sample.txt','utf-8',function(err,data){
    if (err) {
        console.log(err);
    } else {
        console.log(data);
    }
});

请注意,sample.txt文件必须在当前目录下,且文件编码为utf-8。
异步读取时,传入的回调函数接受两个参数,当正常读取时,err参数为null,data参数为读取到的字符串,
当发生错误时,err参数表示一个错误对象,data为undefined,这也是Node.js标准的回调函数:
第一个参数代表错误信息,第二个参数代表结果由于err是否为null就是判断是否出错的标志,所以通常的判读逻辑总是:

if (err) {
    //出错了
} else {
    //正常
}

如果我们读取的不是文本文件,而是二进制文件,怎么办
下面示例如何读取一张图片

var fs = require('fs');
fs.readFile('sample.png',function(err,data){
    if (err) {
        console.log(err);
    } else {
        console.log(data);
        console.log(data.length + 'bytes');
    }
});

当读取文件时,不传入文件编码,回调函数的data将返回一个Buffer对象,在Node.js中Buffer对象就是一个包含0个或任意个字节的数组注意和array不同
buffer对象可以和string做转换,例如,把一个buffer对象转换为string

        var text = data.toString('utf-8');
        console.log(text);

或者把一个string转换成buffer

var buf = new Buffer(text,'utf-8');
console.log(buf)

同步读取文件
同步读取的函数和异步函数相比多了一个Sync后缀,并且不接受回调函数,直接返回函数结果

var fs = require('fs');
var data = fs.readFileSync('sample.txt','utf-8');
console.log(data);

可见,原异步调用的回调函数的data被函数直接返回,函数名需要改为readFileSync,其它参数不变。
如果同步读取文件发生错误,则需要捕获错误

try {
    var data = fs.readFileSync('sample.txt','utf-8');
    console.log(data);
} catch (err) {
    //出错了
}

写文件

将数据写入文件是通过fs.writeFile()实现的

var fs = require('fs');
var data = 'Hello, Node.js';
fs.writeFile('output.txt',data,function(err){
    if (err) {
        console.log(err);
    } else {
        console.log('ok');
    }
})

writeFile()的参数依次为文件名,数据和回调函数,如果传入的数据时是string,则默认按照utf-8编码写入文本文件,如果传入的参数是Buffer,则写入的是二进制文件,回调函数只关心成功与否,因此只传入一个err参数
和readFile()类似,writeFile()也有一个同步方法,叫writeFileSync():

var fs = require('fs');
var data = 'Hello ,Node.js';
fs.writeFileSync('output.txt',data);

stat

如果我们要获取文件大小,创建时间等信息,可以使用fs.stat(),它返回一个stat对象,能告诉我们文件或者目录的详细信息

var fs = require('fs');
fs.stat('sample.txt',function(err,stat){
    if (err) {
        console.log(err);
    } else {
        //是否是文件
        console.log('isFile: ' + stat.isFile());
        //是否是目录
        console.log('isDirectory ' + stat.isDirectory());
        if (stat.isFile()) {
            //文件大小
            console.log(stat.size);;
            //创建时间 Data对象
            console.log(stat.birthtime);
            //修改时间 Data对象
            console.log(stat.mtime);
        }
    }
})

//stat()也有一个对应的同步函数statSync(),

你可能感兴趣的:(Node-fs)