nodejs 文件系统
nodejs访问文件系统
所有的文件系统的调用,都需要加载fs模块,即var fs=require('fs');
nodejs提供的fs模块几乎所有的功能都有两种形式选择:异步和同步,如异步的write()和同步的writeSync()
1.打开和关闭文件
打开文件:
fs.open(path,flags,[mode],callback)
fs.openSync(path,flags,[mode])
其中path参数指定文件系统的标准路径字符串,flags参数指定打开文件的模式,如读、写、追加等,可选的mode参数设置文件访问模式,默认为0666,表示可读且可写。
关闭文件:
fs.close(fd,callback)
fs.closeSync(fd)
一个简单的异步模式打开和关闭文件的例子
fs.open('myFile','w',function(err,fd){ if(!error){ fs.close(fd); } }
注意:回调函数被指定,并接收err和fd参数,fd参数是你可以用来读取或写入该文件的文件描述符。
2.写入文件
fs模块提供了四种方式将数据写入文件
(1)简单文件写入:
fs.writeFile(path,data,[options],callback)
fs.writeFileSync(path,data,[options])
其中,path参数指定文件的路径,可以是相对或绝对路径,data参数指定将被写入到文件中的String或Buffer对象,可选的options参数是一个对象,它可以包含定义字符串编码,以及打开文件时使用的模式和标志的encoding,mode和flag属性
一个简单的例子:
var fs=require('fs'); var config={ maxFiles:20, maxConnections:15, rootPath:'./routes' }; var configTxt=JSON.stringify(config); var options={ encoding:'utf8', flag:'w' }; fs.writeFile('config.text',configTxt,options,function(err){ if(err){ console.log('config write fail'); } else{ console.log('config write success'); } });
(2)同步和异步文件写入
fs.writeSync(fd,data,offset,length,position)
fs.write(fd,data,offset,length,position,callback)
其中,fd参数是openSync()或open()返回的文件描述符,data参数指定被写入文件中的String或Buffer对象,offset参数指定data参数中开始阅读的索引,如果你想从字符串或缓冲区的当前索引开始,这个值应该为null。lenght参数指定要写入的字节数,你可以指定null,表示一直写到数据缓冲区的末尾。
举一个异步写入文件的例子:
var fs=require('fs'); var fruitBow1=['apple','orange','banana']; function writeFruit(fd){ if(fruitBow1.length){ var fruit=fruitBow1.pop()+''; fs.write(fd,fruit,null,null,function(err,bytes){ if(err){ console.log('File write failed.'); }else{ console.log('write: %s %dbytes',fruit,bytes); writeFruit(fd); //反复调用,直到fruitBow1的length为0 } }); }else{ fs.close(fd); } } fs.open('fruit.txt','w',function(err,fd){ writeFruit(fd); });
(3)流式文件写入
往一个文件写入大量数据是,最好的方式之一是使用流,其中包括把文件作为一个Writeable流打开,Writeable流很容易实现,可以使用pipe()方法与Readable流链接,这也使得它很容易写来自Readable流(如HTTP请求)的数据。
若要将数据异步传送到文件,首先需要创建一个Writeable对象:
fs.createWriteStream(path,[options])
其中,path参数指定了文件的路径,可以是相对或绝对路径,可选的options参数是一个对象,它可以包含定义字符串编码以及打开文件时使用模式和标志的encoding,mode和flag属性。一旦打开Writeable文件流,就可以使用标准的流式write(buffer)方法写入它。
var fs=require('fs'); var grains=['wheat','rice','oats']; var options={encoding:'utf8',flag:'w'}; var fileWriteStream=fs.createWriteStream('grains.txt',options); fileWriteStream.on('close',function(){ console.log('file closed.'); }); while(grains.length){ var data=grains.pop()+' '; fileWriteStream.write(data); console.log('write: %s',data); } fileWriteStream.end();
三 读取文件
fs模块提供了四种不同的方法从文件中读取数据。
(1)简单文件读取:
fs.readFile(path,[options],callback)
fs.readFileSync(path,[options])
其中,path参数指定了文件的路径,可以是相对或绝对路径,可选的options参数是一个对象,它可以包含定义字符串编码以及打开文件时使用模式和标志的encoding,mode和flag属性。
举个例子:
var fs=require('fs'); var options={encoding:'utf8',flag:'r'}; fs.readFile('config.txt',options,function(err,data){ if(err){ console.log('Failes to open config File.'); }else{ console.log('config Loaded.'); var config=JSON.parse(data); console.log('Max Files: '+config.maxFiles); console.log('maxConnections: '+config.maxConnections); console.log('rootPath: '+config.rootPath); } });
(2)同步文件读取
fs.readSync(fd,buffer,offset,length,position)
(3)异步文件读取
fs.read(d,buffer,offset,length,position,callback)
(4)流式文件读取
首先要使用以下语法创建一个Readable流对象:fs.createReadStream(path,[options])
var fs=require('fs'); var options={encoding:'utf8',flag:'r'}; var fileReadStream=fs.createReadStream('grains.txt',options); fileReadStream.on('data',function(chunk){ console.log('Grains: %s',chunk); console.log('read %d bytes of data.',chunk.length); }); fileReadStream.on('close',function(){ console.log('file closed.'); });