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），最后强调：理解文件上传例子中的代码组织方式，不断重构，不断总结。
相关文章
npm install -g @vue/cli常见问题解决汇总
这篇文章主要给大家介绍了关于npm install -g @vue/cli常见问题解决的相关资料,文中通过实例代码将解决的方式介绍的非常详细,对遇到这个问题的朋友具有一定的参考学习价值,需要的朋友可以参考下2022-08-08
使用Node.js实现Clean Architecture方法示例详解
这篇文章主要为大家介绍了使用Node.js实现Clean Architecture方法示例详解，有需要的朋友可以借鉴参考下，希望能够有所帮助，祝大家多多进步，早日升职加薪2023-02-02
node的好处毋庸置疑，事件驱动，异步非阻塞I/O，以及处理高并发的能力深入人心，因此大家喜欢用node做一些小型后台服务或者作为中间层和其他服务配合完成一些大型应用场景。2021-06-06
这篇文章主要介绍了利用Docker设置Node.js的相关资料，文中通过示例代码介绍的非常详细，对大家的学习或者工作具有一定的参考学习价值，需要的朋友们下面随着小编来一起学习学习吧2018-11-11
Node.js使用officecrypto-tool实现读取加密的Excel和Word文档
这篇文章主要为大家详细介绍了Node.js如何使用officecrypto-tool实现读取加密的Excel和Word文档的功能,感兴趣的小伙伴可以跟随小编一起了解一下2023-09-09
随着node、react同构等技术越来越广泛地使用, 内存泄漏的事情时有发生,应当引起足够的重视，本文主要介绍了Node的内存泄露，对大家的学习或者工作具有一定的参考学习价值，需要的朋友们下面随着小编来一起学习学习吧2022-05-05
nodeJS（express4.x）+vue（vue-cli）构建前后端分离实例(带跨域)
这篇文章主要介绍了nodeJS（express4.x）+vue（vue-cli）构建前后端分离实例(带跨域) ，具有一定的参考价值，感兴趣的小伙伴们可以参考一下2017-07-07
我们常使用nvm来管理node.js的版本,这样就可以根据自己的需要来回切换node.js版本,下面这篇文章主要给大家介绍了关于node版本过高该如何将node版本降低的相关资料,需要的朋友可以参考下2023-01-01
这篇文章主要介绍了nodeJS中关于path.resolve()的用法，具有很好的参考价值，希望对大家有所帮助。如有错误或未考虑完全的地方，望不吝赐教2023-06-06
这篇文章主要介绍了nodejs log4js 使用详解,文中通过示例代码介绍的非常详细，对大家的学习或者工作具有一定的参考学习价值，需要的朋友们下面随着小编来一起学习学习吧2019-05-05
最新评论