NodeJS学习笔记之FS文件模块


Posted in NodeJs onJanuary 13, 2015

一,开篇分析

文件系统模块是一个简单包装的标准 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) ;

 }) ;

运行结果:

NodeJS学习笔记之FS文件模块

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

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

NodeJS学习笔记之FS文件模块

再来一个写操作,如下:

 var fs = require("fs") ;

 var txt = "大家要好好学习NodeJS啊!!!" ;

 //写入文件

 fs.writeFile("bb.txt",txt,function (err) {

     if (err) throw err ;

     console.log("File Saved !"); //文件被保存

 }) ;

运行结果:

NodeJS学习笔记之FS文件模块

在列举一些常用的实例:

// 删除文件

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 ...") ;

以下是运行结果:

NodeJS学习笔记之FS文件模块

现在我们需要思考一下,如果我们要发送的不是一个单纯的文本文件而是超媒体文件比如说 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),最后强调:理解文件上传例子中的代码组织方式,不断重构,不断总结。

NodeJs 相关文章推荐
nodejs的require模块(文件模块/核心模块)及路径介绍
Jan 14 NodeJs
Nodejs sublime text 3安装与配置
Jun 19 NodeJs
NodeJS学习笔记之(Url,QueryString,Path)模块
Jan 13 NodeJs
NodeJS处理Express中异步错误
Mar 26 NodeJs
nodejs个人博客开发第三步 载入页面
Apr 12 NodeJs
NodeJS服务器实现gzip压缩的示例代码
Oct 12 NodeJs
NodeJS搭建HTTP服务器的实现步骤
Oct 12 NodeJs
NodeJS 将文件夹按照存放路径变成一个对应的JSON的方法
Oct 17 NodeJs
NodeJs crypto加密制作token的实现代码
Nov 15 NodeJs
nodejs各种姿势断点调试的方法
Jun 18 NodeJs
nodejs中的异步编程知识点详解
Jan 17 NodeJs
node快速搭建后台的实现步骤
Feb 18 NodeJs
NodeJS学习笔记之Http模块
Jan 13 #NodeJs
Nodejs学习笔记之Stream模块
Jan 13 #NodeJs
Nodejs学习笔记之NET模块
Jan 13 #NodeJs
Nodejs学习笔记之Global Objects全局对象
Jan 13 #NodeJs
Nodejs为什么选择javascript为载体语言
Jan 13 #NodeJs
NodeJS中Buffer模块详解
Jan 07 #NodeJs
Nodejs中读取中文文件编码问题、发送邮件和定时任务实例
Jan 01 #NodeJs
You might like
php 各种应用乱码问题的解决方法
2010/05/09 PHP
php中使用key,value,current,next和prev函数遍历数组的方法
2015/03/17 PHP
Yii中Model(模型)的创建及使用方法
2015/12/28 PHP
PHP根据树的前序遍历和中序遍历构造树并输出后序遍历的方法
2017/11/10 PHP
javascript 函数式编程
2007/08/16 Javascript
JQuery中的ready函数冲突的解决方法
2010/05/17 Javascript
jquery封装的对话框简单实现
2013/07/21 Javascript
js动态添加表格数据使用insertRow和insertCell实现
2014/05/22 Javascript
js设置document.domain实现跨域的注意点分析
2015/05/21 Javascript
jquery.gridrotator实现响应式图片展示画廊效果
2015/06/23 Javascript
jquery可定制的在线UEditor编辑器
2015/11/17 Javascript
详解javascript跨浏览器事件处理程序
2016/03/27 Javascript
jQuery插件easyUI实现通过JS显示Dialog的方法
2016/09/16 Javascript
基于bootstrap-datetimepicker.js不支持IE8的快速解决方法
2016/11/07 Javascript
JQuery 动态生成Table表格实例代码
2016/12/02 Javascript
ES6中Math对象的部分扩展
2017/02/20 Javascript
详解Vuejs2.0 如何利用proxyTable实现跨域请求
2017/08/03 Javascript
SVG实现时钟效果
2018/07/17 Javascript
mpvue跳转页面及注意事项
2018/08/03 Javascript
12个提高JavaScript技能的概念(小结)
2019/05/09 Javascript
[59:36]2018DOTA2亚洲邀请赛 4.3 突围赛 Secret vs VG 第二场
2018/04/04 DOTA
Python获取apk文件URL地址实例
2013/11/01 Python
用Python逐行分析文件方法
2019/01/28 Python
Pytorch Tensor基本数学运算详解
2019/12/30 Python
浅析pip安装第三方库及pycharm中导入第三方库的问题
2020/03/10 Python
python的help函数如何使用
2020/06/11 Python
Django Form常用功能及代码示例
2020/10/13 Python
REISS美国官网:伦敦最受欢迎的时尚品牌
2019/08/16 全球购物
什么是聚集索引和非聚集索引
2012/01/17 面试题
公务员年总结的自我评价
2013/10/25 职场文书
硅酸盐工业控制专业应届生求职信
2013/11/02 职场文书
一名毕业生的自我鉴定
2013/12/04 职场文书
关于诚信的活动方案
2014/08/18 职场文书
纪律教育学习心得体会
2014/09/02 职场文书
公司合并协议书范本
2014/09/30 职场文书
教师群众路线心得体会
2014/11/04 职场文书