NodeJS学习笔记之FS文件模块

一,开篇分析

文件系统模块是一个简单包装的标准 POSIX 文件 I/O 操作方法集。可以通过调用 require("fs") 来获取该模块。文件系统模块中的所有方法均有异步和同步版本。

(1),文件系统模块中的异步方法需要一个完成时的回调函数作为最后一个传入形参。

(2),回调函数的构成由调用的异步方法所决定,通常情况下回调函数的第一个形参为返回的错误信息。

(3),如果异步操作执行正确并返回,该错误形参则为null或者undefined。如果使用的是同步版本的操作方法,一旦出现错误,会以通常的抛出错误的形式返回错误。

(4),可以用try和catch等语句来拦截错误并使程序继续进行。

我们先看一个简单的例子,读取文件("bb.txt"):

(1),建立文件"bb.txt“,如下内容(”大家好,我是大雄君!(*^__^*) 嘻嘻……“)。

(2),读取文件操作如下代码:

代码如下:

var fs = require("fs") ;
 fs.readFile("bb.txt","utf8",function (error,data){
     if(error) throw error ;
     console.log(data) ;
 }) ;

运行结果:

这里要注意的是:读取文件一定要设置编码,否则默认是 ”buffer“ 形式出现。

再看没设置的运行效果,区别还是很明显的。如下:

再来一个写操作,如下:

代码如下:

var fs = require("fs") ;
 var txt = "大家要好好学习NodeJS啊!!!" ;
 //写入文件
 fs.writeFile("bb.txt",txt,function (err) {
     if (err) throw err ;
     console.log("File Saved !"); //文件被保存
 }) ;

运行结果:

在列举一些常用的实例:

代码如下:

// 删除文件
fs.unlink('bb.txt', function(){
console.log('success') ;
}) ;
// 修改文件名称
fs.rename('bb.txt','bigbear.txt',function(err){
console.log('rename success') ;
});
// 查看文件状态
fs.stat('bb.txt', function(err, stat){
 console.log(stat);
});
// 判断文件是否存在
fs.exists('bb.txt', function( exists ){
   console.log( exists ) ;
}) ;

二,Fs与Stream之间的联系

"Stream" 具有异步的特性。我么可以将一个文件或一段内容分为未知个制定大小的 "chunk" 去读取,每读取到一个 "chunk" 我们就将他输出。直到文件读完。这就像 "http1.1" 种支持的 "Transfer-Encoding: chunked" 那样。 ("chunk"可以以任何的形式存在,NodeJS默认是以 "Buffer" 的形式存在,这样更高效)。NodeJS中的"Stream"具备Unix系统上的一个超级特性就是 ("pipe" ------ 管道)。

还记得 “Http模块那篇” 第一个NodeJS程序, "Hello,大熊!" 吗?我们基于那个小程序做一下修改,如下代码:

(1),建立“bb.html”

代码如下:

<html>
     <head>
         <style type="text/css">
             div {
                   margin-top: 50px;
                   width: 100%;
                    margin: 0px;
                   height:120px;
                   line-height:120px;
                    color:#fff;
                    font-size:22px;
                    background:#ff9900;
                   text-align: center;
             }
         </style>
     </head>
     <body>
         <div>Hello,大熊!</div>
     </body>
 </html>

(2),修改之前的程序如下:

代码如下:

var http = require('http') ;
 var fs = require("fs") ;
 var server = http.createServer(function(req,res){
     fs.readFile("bb.html","utf-8", function(err, data){
       if(err) {
           res.writeHead(500, {'Context-Type': 'text/plain'});
           res.end('specify file not exists! or server error!');
       }
       else{
         res.writeHead(200, {'Context-Type': 'text/html'});
         res.write(data);
         res.end();
       }
   })
 }) ;
 server.listen(8888) ;
 console.log("http server running on port 8888 ...") ;

以下是运行结果:

现在我们需要思考一下,如果我们要发送的不是一个单纯的文本文件而是超媒体文件比如说 Google 2014 IO 大会 的全程高清视频文件。mp4 格式。长度2个多小时1080p。

大概4个多GB。已知 "readFile" 的工作方式是将文件读取到内存。那么这么大一个文件显然是不能这么做的。那该怎么办呢?是之后就需要使用 stream 的来做。那么是这样的。

代码如下像这样:

代码如下:

fs.createReadStream(__dirname + '/vedio.mp4').pipe(res) ;

总结一下:

这些代码可以实现需要的功能,但是服务在发送文件数据之前需要缓存整个文件数据到内存,如果"bb.html"文件很
大并且并发量很大的话,会浪费很多内存。因为用户需要等到整个文件缓存到内存才能接受的文件数据,这样导致
用户体验相当不好。不过还好 "(req, res)" 两个参数都是Stream,这样我们可以用fs.createReadStream()代替"fs.readFile()"。

三,实例

来一个文件上传的小栗子:

(1),建立“server.js”

代码如下:

var http = require('http');
 var url = require('url');
 function start(route, handler) {
     function onRequest (request, response) {
         var pathname = url.parse(request.url).pathname;
         // 路由到相应的业务逻辑
         route (pathname, handler, response, request);
     }
     http.createServer(onRequest).listen(3000);
     console.log('server is starting');
 }
 exports.start = start;

(2),建立“route.js”

代码如下:

function route (pathname, handler, response, request) {
     console.log('about to route a request for ' + pathname);
     if (typeof handler[pathname] === 'function') {
         return handler[pathname](response, request);
     } else {
         console.log('no request handler found for ' + pathname);
         response.writeHead(404, {'Content-Type': 'text/html'});
         response.write('404 Not Found!');
         response.end();
     }
 }
 exports.route = route;

(3),建立“requestHandler.js”

代码如下:

var querystring = require('querystring'),
    fs = require('fs'),
    formidable = require('formidable');
function start (response, request) {
    console.log('start module');
  var body = '<html>'+
      '<head>'+
      '<meta http-equiv="Content-Type" '+
      'content="text/html; charset=UTF-8" />'+
      '</head>'+
      '<body>'+
      '<form action="/upload" enctype="multipart/form-data" method="post">'+
      '<input type="file" name="upload" multiple="multiple">'+
      '<input type="submit" value="Submit text" />'+
      '</form>'+
      '</body>'+
      '</html>';
    response.writeHead(200, {'Content-Type': 'text/html'});
    response.write(body);
    response.end();
}
function upload (response, request) {
    console.log('upload module');
    var form = new formidable.IncomingForm();
    form.parse(request, function (error, fields, files) {
        fs.renameSync(files.upload.path, '/tmp/test.png');
        response.writeHead(200, {'Content-Type': 'text/html'});
        response.write('You\'ve sent: <br />');
        response.write('<img src="/show" />');
        response.end();
    });
}
function show (response, request) {
    console.log('show module');
    fs.readFile ('/tmp/test.png', 'binary', function (error, file) {
        if (error) {
            response.writeHead(200, {'Content-Type': 'text/html'});
            response.write(error);
            response.end();
        } else {
            response.writeHead(200, {'Content-Type': 'image/png'});
            response.write(file, 'binary');
            response.end();
        }
    });
}
exports.start = start;
exports.upload = upload;
exports.show= show;

(4),建立“index.js”

代码如下:

var server = require('./server');
 var router = require('./router');
 var requestHandler = require('./requestHandler');
 var formidable = require('formidable'); // require路径搜索算法??
 var handler = {};
 handler['/'] = requestHandler.start;
 handler['/start'] = requestHandler.start;
 handler['/upload'] = requestHandler.upload;
 handler['/show'] = requestHandler.show;
 server.start(router.route, handler);

四,总结一下

(1),理解 "Fs与Stream之间的联系" 。
(2),熟练使用 "FS" 相关的api。
(3),注意细节的把控,比如: 文件操作api同步方式与异步方式之间的处理细节。
(4),最后强调:理解文件上传例子中的代码组织方式,不断重构,不断总结。

时间: 2015-01-11

详解nodejs 文本操作模块-fs模块(二)

前一篇学习了文件的打开和关闭,文件操作总不能只包含打开和关闭吧,这里就开始文件的读写操作. fs模块方法 1:read和readSync方法 该方法,是从文件的指定位置处读取文件,一直读取到文件底部,然后江都区到的内容输出到一个缓存区,使用方法如下: fs.read(fd,buffer,offset,length,position,callback); 在read方法中,支持6个参数: fd参数,是文件描述符,是open方法的回调函数中获取到的,是一个数字. buffer,是一个buffer对象

详解nodejs 文本操作模块-fs模块(三)

下面继续nodejs的学习,在前两篇中,已经把文件操作的打开,关闭读写这两个最基本的功能进行了简单的说明,它们的强大之处,让我觉得知道这几种方法之后,基本上就可以随意的操作文件了,但是open,read,write等方法,需要操作的参数确实是有点多的,所以,基于让使用者更简单的完成读写操作,开发者们,继续给这些方法做了进一步的封装,也就是本文接下来将要说的readFile,和writeFile方法,当然也有他们的同步执行方法,只是篇幅有限,并且同步的方法和异步的方法,在内部实现和参数使用中,差别

基于node.js的fs核心模块读写文件操作(实例讲解)

node.js 里fs模块 常用的功能 实现文件的读写 目录的操作 - 同步和异步共存 ,有异步不用同步 - fs.readFile 都不能读取比运行内存大的文件,如果文件偏大也不会使用readFile方法 - 文件大分流读取,stream - 引入fs模块 - let fs=require('fs') 同步读取文件 -fs.readFileSync('路径',utf8); let result=fs.readFileSync('./1.txt','utf8'); 异步读取文件,用参数err捕获

详解nodejs 文本操作模块-fs模块(四)

在前文中,提到了一个概念,就是当我在读取文件时,我需要知道这个文件的数据量的大小,而在readFile的源码中,是使用的fa.fstat方法,获取到了文件的相关数据,而对于使用fstat获取到的一个对象中,所包含的属性和方法代表的具体含义,前文中并没有涉及,本篇就看下,这个State对象中,包含的数据都有哪些,并且他们分别代表的含义是什么. 方法集合 方法集合,不是说的State对象中包含的方法集合,而是说,在调用哪些API时,返回的值时一个State的实例,比如,在fstate就是其中之一.

详解nodejs 文本操作模块-fs模块(一)

JS的安全性问题,就决定了JS想要取操作数据库操作文件是不可实现的,而Nodejs作为服务端的JS,如果依然不能操作文件,那么又如何称之为服务端语言呢,所以在Nodejs中,提供了一个fs(File System)模块,以实现文件及目录的读写操作. 写在前面 Nodejs的一大优势就在于,支持异步调用,不管是在读取数据库,还是在读取文件时,都可以使用异步的方式进行处理,这样就可以处理高并发的情况,从本篇开始,开始对Nodejs的fs模块中,一些重要的API,结合源码,进行一些说明学习. fs模块

详解nodejs 文本操作模块-fs模块(五)

fs模块是一个比较庞大的模块,在前面也介绍了该模块中最核心的一点东西,虽然核心的这点东西,在整个fs模块中占据的比例比较小,但是如果只是我们平常使用的话,基本已经够用了,其他的一些方法,属于能力提升时需要学习的的内容了,所以在后面就不再继续了,本篇属于fs模块中的最后一篇,也不是把fs模块中的其他API都给一一列举出来,这里再说最后一个我看来很重要的方法,监听文件或者目录的的方法watchFile. 概总 这里之所以在最后把这个watchFile方法写入到这里,是因为在前端的一个流行的构建工具g

详解Python文本操作相关模块

详解Python文本操作相关模块 linecache--通过使用缓存在内部尝试优化以达到高效从任何文件中读出任何行. 主要方法: linecache.getline(filename, lineno[, module_globals]):获取指定行的内容 linecache.clearcache():清除缓存 linecache.checkcache([filename]):检查缓存的有效性 dircache--定义了一个函数,使用缓存读取目录列表.使用目录的mtime来实现缓存失效.此外还定义

详解nodeJs文件系统(fs)与流(stream)

一.简介 本文将介绍node.js文件系统(fs)和流(stream)的一些API已经参数使用情况. 二.目录 文件系统将介绍以下方法: 1.fs.readFile 2.fs.writeFile 3.fs.open 4.fs.read 5.fs.stat 6.fs.close 7.fs.mkdir 8.fs.rmdir 9.fs.readdir 10.fs.unlink stream流的四种类型readable,writable,duplex,transform以及stream对象的事件. 三.

详解python 3.6 安装json 模块(simplejson)

JSON 相关概念: 序列化(Serialization):将对象的状态信息转换为可以存储或可以通过网络传输的过程,传输的格式可以是JSON,XML等.反序列化就是从存储区域(JSON,XML)读取反序列化对象的状态,重新创建该对象. JSON(Java Script Object Notation):一种轻量级数据交互格式,相对于XML而言更简单,也易于阅读和编写,机器也方便解析和生成,Json是JavaScript中的一个子集. python2.6版本开始加入了JSON模块,python的j

详解nodeJS中读写文件方法的区别

导言:nodejs中所有与文件相关的操作都在fs模块中,而读写操作又是我们会经常用到的操作,nodejs的fs模块针对读操作为我们提供了readFile,read, createReadStream三个方法,针对写操作为我们提供了writeFile,write, createWriteStream三个方法,下面分析一下它们的区别: 一.readFile和writeFile 1.readFile方法是将要读取的文件内容完整读入缓存区,再从该缓存区中读取文件内容,具体操作如下: fs.readFil

详解Nodejs get获取远程服务器接口数据

本文实例为大家分享了Nodejs get获取远程服务器接口数据的具体代码,供大家参考,具体内容如下 1.GET模块:_get.js /** * Created by jinx on 7/7/17. */ var http = require('http'); module.exports = { /** * 测试获取所有的区域 * / locations: function (cb) { http.get('http://wx.xx.com/locations', function (res)