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 相关文章推荐
windows系统下简单nodejs安装及环境配置
Jan 08 NodeJs
Nodejs进程管理模块forever详解
Jun 01 NodeJs
搭建简单的nodejs http服务器详解
Mar 09 NodeJs
详解nodejs微信公众号开发——2.自动回复
Apr 10 NodeJs
nodejs 终端打印进度条实例代码
Apr 22 NodeJs
nodejs中Express与Koa2对比分析
Feb 06 NodeJs
nodejs实现超简单生成二维码的方法
Mar 17 NodeJs
原生nodejs使用websocket代码分享
Apr 07 NodeJs
nodeJs爬虫的技术点总结
May 13 NodeJs
深入理解nodejs搭建静态服务器(实现命令行)
Feb 05 NodeJs
Nodejs + Websocket 指定发送及群聊的实现
Jan 09 NodeJs
NodeJs使用webpack打包项目的方法详解
Feb 28 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多种形式发送邮件(mail qmail邮件系统 phpmailer类)
2014/01/22 PHP
PHP连接MSSQL2008/2005数据库(SQLSRV)配置实例
2014/10/22 PHP
自制PHP框架之设计模式
2017/05/07 PHP
PC端微信扫码支付成功之后自动跳转php版代码
2017/07/07 PHP
PHP实现的简单在线计算器功能示例
2017/08/02 PHP
javascript中类的定义及其方式(《javascript高级程序设计》学习笔记)
2011/07/04 Javascript
Windows系统下使用Sublime搭建nodejs环境
2015/04/13 NodeJs
JS模式之简单的订阅者和发布者模式完整实例
2015/06/30 Javascript
jQuery实现图片渐入渐出切换展示效果
2015/08/15 Javascript
简述jQuery ajax的执行顺序
2016/01/05 Javascript
解析JavaScript中的字符串类型与字符编码支持
2016/06/24 Javascript
javascript数组常用方法汇总
2016/09/10 Javascript
数组Array的排序sort方法
2017/02/17 Javascript
Vue2学习笔记之请求数据交互vue-resource
2017/02/23 Javascript
详解require.js配置路径的用法和css的引入
2017/09/06 Javascript
使用store来优化React组件的方法
2017/10/23 Javascript
js实现下拉框二级联动
2018/12/04 Javascript
Vue开发Html5微信公众号的步骤
2019/04/11 Javascript
Bootstrap实现省市区三级联动(亲测可用)
2019/07/26 Javascript
小程序如何支持使用 async/await详解
2019/09/12 Javascript
[02:27]DOTA2英雄基础教程 莱恩
2014/01/17 DOTA
[00:57]深扒TI7聊天轮盘语音出处5
2017/05/11 DOTA
[01:59]深扒TI7聊天轮盘语音出处 1
2017/05/11 DOTA
Python中使用glob和rmtree删除目录子目录及所有文件的例子
2014/11/21 Python
Python中常用信号signal类型实例
2018/01/25 Python
详解Python解决抓取内容乱码问题(decode和encode解码)
2019/03/29 Python
如何在网站上添加谷歌定位信息
2016/04/16 HTML / CSS
深入探究HTML5的History API
2015/07/09 HTML / CSS
美国鞋类购物网站:Shiekh Shoes
2016/08/21 全球购物
孤独星球出版物:Lonely Planet Publications
2018/03/17 全球购物
丝芙兰新加坡官网:Sephora新加坡
2018/12/04 全球购物
女生节标语
2014/06/26 职场文书
大学团日活动新闻稿
2014/09/10 职场文书
2014个人四风对照检查材料思想汇报
2014/09/18 职场文书
2016年幼儿园庆六一开幕词
2016/03/04 职场文书
雄兵连:第三季先行图公开,天使恶魔联合,银河之力的新力量
2021/06/11 国漫