前言

我们以查找指定目录下的最大文件为例,感受从
回调函数 -> Promise -> Generator -> Async
异步处理方式的改变。

API 介绍

为了实现这个功能,我们需要用到几个 Nodejs 的 API,所以我们来简单介绍一下。

fs.readdir

readdir 方法用于读取目录,返回一个包含文件和目录的数组。

fs.stat

stat 方法的参数是一个文件或目录,它产生一个对象,该对象包含了该文件或目录的具体信息。此外,该对象还有一个 isFile() 方法可以判断正在处理的到底是一个文件,还是一个目录。

思路分析

我们基本的实现思路就是:

  1. 用 fs.readdir 获取指定目录的内容信息
  2. 循环遍历内容信息,使用 fs.stat 获取该文件或者目录的具体信息
  3. 将具体信息储存起来
  4. 当全部储存起来后,筛选其中的是文件的信息
  5. 遍历比较,找出最大文件
  6. 获取并返回最大文件

然后我们直接上代码吧。

回调函数

  1. var fs = require('fs');
  2. var path = require('path');
  3. function findLargest(dir, cb) {
  4. // 读取目录下的所有文件
  5. fs.readdir(dir, function(er, files) {
  6. if (er) return cb(er);
  7. var counter = files.length;
  8. var errored = false;
  9. var stats = [];
  10. files.forEach(function(file, index) {
  11. // 读取文件信息
  12. fs.stat(path.join(dir, file), function(er, stat) {
  13. if (errored) return;
  14. if (er) {
  15. errored = true;
  16. return cb(er);
  17. }
  18. stats[index] = stat;
  19. // 事先算好有多少个文件,读完 1 个文件信息,计数减 1,当为 0 时,说明读取完毕,此时执行最终的比较操作
  20. if (--counter == 0) {
  21. var largest = stats
  22. .filter(function(stat) { return stat.isFile() })
  23. .reduce(function(prev, next) {
  24. if (prev.size > next.size) return prev
  25. return next
  26. })
  27. cb(null, files[stats.indexOf(largest)])
  28. }
  29. })
  30. })
  31. })
  32. }

使用方式为:

  1. // 查找当前目录最大的文件
  2. findLargest('./', function(er, filename) {
  3. if (er) return console.error(er)
  4. console.log('largest file was:', filename)
  5. });

Promise

  1. var fs = require('fs');
  2. var path = require('path');
  3. var readDir = function(dir) {
  4. return new Promise(function(resolve, reject) {
  5. fs.readdir(dir, function(err, files) {
  6. if (err) reject(err);
  7. resolve(files)
  8. })
  9. })
  10. }
  11. var stat = function(path) {
  12. return new Promise(function(resolve, reject) {
  13. fs.stat(path, function(err, stat) {
  14. if (err) reject(err)
  15. resolve(stat)
  16. })
  17. })
  18. }
  19. function findLargest(dir) {
  20. return readDir(dir)
  21. .then(function(files) {
  22. let promises = files.map(file => stat(path.join(dir, file)))
  23. return Promise.all(promises).then(function(stats) {
  24. return { stats, files }
  25. })
  26. })
  27. .then(data => {
  28. let largest = data.stats
  29. .filter(function(stat) { return stat.isFile() })
  30. .reduce((prev, next) => {
  31. if (prev.size > next.size) return prev
  32. return next
  33. })
  34. return data.files[data.stats.indexOf(largest)]
  35. })
  36. }

使用方式为:

  1. findLargest('./')
  2. .then(function(filename) {
  3. console.log('largest file was:', filename);
  4. })
  5. .catch(function() {
  6. console.log(error);
  7. });

Generator

  1. var fs = require('fs');
  2. var path = require('path');
  3. var co = require('co')
  4. var readDir = function(dir) {
  5. return new Promise(function(resolve, reject) {
  6. fs.readdir(dir, function(err, files) {
  7. if (err) reject(err);
  8. resolve(files)
  9. })
  10. })
  11. }
  12. var stat = function(path) {
  13. return new Promise(function(resolve, reject) {
  14. fs.stat(path, function(err, stat) {
  15. if (err) reject(err)
  16. resolve(stat)
  17. })
  18. })
  19. }
  20. function* findLargest(dir) {
  21. var files = yield readDir(dir);
  22. var stats = yield files.map(function(file) {
  23. return stat(path.join(dir, file))
  24. })
  25. let largest = stats
  26. .filter(function(stat) { return stat.isFile() })
  27. .reduce((prev, next) => {
  28. if (prev.size > next.size) return prev
  29. return next
  30. })
  31. return files[stats.indexOf(largest)]
  32. }

使用方式为:

  1. co(findLargest, './')
  2. .then(function(filename) {
  3. console.log('largest file was:', filename);
  4. })
  5. .catch(function() {
  6. console.log(error);
  7. });

Async

  1. var fs = require('fs');
  2. var path = require('path');
  3. var readDir = function(dir) {
  4. return new Promise(function(resolve, reject) {
  5. fs.readdir(dir, function(err, files) {
  6. if (err) reject(err);
  7. resolve(files)
  8. })
  9. })
  10. }
  11. var stat = function(path) {
  12. return new Promise(function(resolve, reject) {
  13. fs.stat(path, function(err, stat) {
  14. if (err) reject(err)
  15. resolve(stat)
  16. })
  17. })
  18. }
  19. async function findLargest(dir) {
  20. var files = await readDir(dir);
  21. let promises = files.map(file => stat(path.join(dir, file)))
  22. var stats = await Promise.all(promises)
  23. let largest = stats
  24. .filter(function(stat) { return stat.isFile() })
  25. .reduce((prev, next) => {
  26. if (prev.size > next.size) return prev
  27. return next
  28. })
  29. return files[stats.indexOf(largest)]
  30. }

使用方式为:

  1. findLargest('./')
  2. .then(function(filename) {
  3. console.log('largest file was:', filename);
  4. })
  5. .catch(function() {
  6. console.log(error);
  7. });