上一节:
下一节:

  Node.js 文件系统

  • 文件系统

    Node使用围绕标准POSIX函数的简单包装器来实现文件I/O。可以使用以下语法导入节点文件系统（fs）模块- 
    
var fs = require("fs")

  • 同步与异步

    fs模块中的每个方法都具有同步形式和异步形式。异步方法将最后一个参数作为完成函数回调，并将回调函数的第一个参数作为错误。最好使用异步方法而不是同步方法，因为前者在执行过程中从不阻塞程序，而后者则不会。
    创建一个名为input.txt的文本文件，其内容如下： 
    
abcdefghijklmnopqrstuvwxyz
    让我们用以下代码创建一个名为main.js的js文件- 
    
var fs = require("fs");

// 异步读文件
fs.readFile('input.txt', function (err, data) {
   if (err) {
      return console.error(err);
   }
   console.log("异步读取: " + data.toString());
});

// 同步读取
var data = fs.readFileSync('input.txt');
console.log("同步读取: " + data.toString());

console.log("程序结束");
    现在运行main.js以查看结果- 
    
$ node main.js
    验证输出。 
    
同步读取: abcdefghijklmnopqrstuvwxyz
程序结束
异步读取: abcdefghijklmnopqrstuvwxyz
    本章的以下各节提供了一组有关主要文件I/O方法的良好示例。

  • 打开文件

    以下是在异步模式下打开文件的方法的语法- 
    
fs.open(path, flags[, mode], callback)
    参数
    这是使用的参数的描述-
    • path - 这是文件名包含路径的字符串。
    • flags - 标志指示要打开的文件的行为。所有可能的值已在下面提到。
    • mode - 设置文件模式（权限和粘性位），但仅在创建文件时才设置。默认为0666，可读可写。
    • callback - 这是获取两个参数（err，fd）的回调函数。
    flag说明
    flag 说明
    r 打开文件进行读取。 如果文件不存在，则会发生异常。
    r+ 打开文件进行读写。 如果文件不存在，则会发生异常。
    rs 打开文件以同步模式读取。
    rs+ 打开文件进行读写，要求操作系统同步打开它。 请参阅有关“ rs”的注意事项，以谨慎使用它。
    w 打开文件进行写入。 文件已创建（如果不存在）或被截断（如果存在）。
    wx 类似于“w”，但如果路径存在则失败。
    w+ 打开文件进行读写。 文件已创建（如果不存在）或被截断（如果存在）。
    wx+ 类似于“w+”，但如果存在路径则失败。
    a 打开文件进行追加。 如果文件不存在，则创建该文件。
    ax 类似于“a”，但如果路径存在则失败。
    a+ 打开文件以进行读取和追加。 如果文件不存在，则创建该文件。
    ax+ 类似于“a+”，但如果路径存在则失败。
    示例
    让我们创建一个名为main.js的js文件，其中包含以下代码- 
    
var fs = require("fs");

console.log("写入一个已经存在的文件");
fs.writeFile('input.txt', '简单易学!', function(err) {
   if (err) {
      return console.error(err);
   }
   
   console.log("数据写入成功!");
   console.log("让我们读取新写入的数据");
   
   fs.readFile('input.txt', function (err, data) {
      if (err) {
         return console.error(err);
      }
      console.log("异步读取: " + data.toString());
   });
});
    现在运行main.js以查看结果- 
    
$ node main.js
    验证输出。 
    
写入一个已经存在的文件
数据写入成功!
让我们读取新写入的数据
异步读取: 简单易学!

  • 读取文件

    以下是从文件读取方法之一的语法- 
    
fs.read(fd, buffer, offset, length, position, callback)
    此方法将使用文件描述符读取文件。如果要使用文件名直接读取文件，则应使用另一种可用的方法。
    参数
    这是使用的参数的描述-
    • fd - 这是fs.open返回的文件描述符。
    • buffer - 这是数据将被写入的缓冲区。
    • offset - 这是缓冲区中开始写入的偏移量。
    • length - 这是一个整数，指定要读取的字节数。
    • position - 这是一个整数，指定从文件中开始读取的位置。如果position为null，将从当前文件位置读取数据。
    • callback - 这是获取三个参数（err，bytesRead，buffer）的回调函数。
    示例
    让我们创建一个名为main.js的js文件，其中包含以下代码- 
    
var fs = require("fs");
var buf = Buffer.alloc(1024);

console.log("要打开现有文件");
fs.open('input.txt', 'r+', function(err, fd) {
   if (err) {
      return console.error(err);
   }
   console.log("文件打开成功!");
   console.log("要读取文件");
   
   fs.read(fd, buf, 0, buf.length, 0, function(err, bytes){
      if (err){
         console.log(err);
      }
      console.log(bytes + " bytes 读取");
      
      // Print only read bytes to avoid junk.
      if(bytes > 0){
         console.log(buf.slice(0, bytes).toString());
      }
   });
});
    现在运行main.js以查看结果- 
    
$ node main.js
    验证输出。 
    
要打开现有文件
文件打开成功!
要读取文件
27 bytes 读取
abcdefghijklmnopqrstuvwxyz

  • 关闭文件

    以下是关闭打开的文件的语法- 
    
fs.close(fd, callback)
    参数
    这是使用的参数的描述-
    • fd - 这是通过文件fs.open()方法返回的文件描述符。
    • callback - 这是回调函数。除可能的异常外，没有参数提供给完成回调。
    示例
    让我们创建一个名为main.js的js文件，其中包含以下代码- 
    
var fs = require("fs");
var buf = Buffer.alloc(1024);

console.log("要打开现有文件");
fs.open('input.txt', 'r+', function(err, fd) {
   if (err) {
      return console.error(err);
   }
   console.log("文件已成功打开！");
   console.log("要读取文件");
   
   fs.read(fd, buf, 0, buf.length, 0, function(err, bytes) {
      if (err) {
         console.log(err);
      }

      // Print only read bytes to avoid junk.
      if(bytes > 0) {
         console.log(buf.slice(0, bytes).toString());
      }

      // Close the opened file.
      fs.close(fd, function(err) {
         if (err) {
            console.log(err);
         } 
         console.log("文件已成功关闭。");
      });
   });
});
    现在运行main.js以查看结果- 
    
$ node main.js
    验证输出。 
    
要打开现有文件
文件已成功打开！
要读取文件
abcdefghijklmnopqrstuvwxyz

文件已成功关闭。

  • 截断文件

    以下是截断打开的文件的方法的语法- 
    
fs.ftruncate(fd, len, callback)
    参数
    这是使用的参数的描述-
    • fd - 这是fs.open返回的文件描述符。
    • len - 这是文件的长度，之后将被截断。
    • callback - 这是回调函数。除可能的异常外，没有参数提供给完成回调。
    示例
    让我们创建一个名为main.js的js文件，其中包含以下代码- 
    
var fs = require("fs");
var buf = Buffer.alloc(1024);

console.log("要打开现有文件");
fs.open('input.txt', 'r+', function(err, fd) {
   if (err) {
      return console.error(err);
   }
   console.log("文件已成功打开！");
   console.log("要在10个字节后截断文件");
   
   // Truncate the opened file.
   fs.ftruncate(fd, 10, function(err) {
      if (err) {
         console.log(err);
      } 
      console.log("文件被成功截断。");
      console.log("要读取相同的文件"); 
      
      fs.read(fd, buf, 0, buf.length, 0, function(err, bytes){
         if (err) {
            console.log(err);
         }

         // Print only read bytes to avoid junk.
         if(bytes > 0) {
            console.log(buf.slice(0, bytes).toString());
         }

         // Close the opened file.
         fs.close(fd, function(err) {
            if (err) {
               console.log(err);
            } 
            console.log("文件已成功关闭。");
         });
      });
   });
});
    现在运行main.js以查看结果- 
    
$ node main.js
    验证输出。 
    
要打开现有文件
文件已成功打开！
要在10个字节后截断文件
文件被成功截断。
要读取相同的文件
abcdefghij
文件已成功关闭。

  • 删除文件

    以下是删除文件的方法的语法- 
    
fs.unlink(path, callback)
    参数
    这是使用的参数的描述-
    • path-这是包含路径的文件名。
    • callback-这是回调函数。除可能的异常外，没有参数提供给完成回调。
    示例
    让我们创建一个名为main.js的js文件，其中包含以下代码- 
    
var fs = require("fs");

console.log("删除一个存在的文件");
fs.unlink('input.txt', function(err) {
   if (err) {
      return console.error(err);
   }
   console.log("文件删除成功!");
});
    现在运行main.js以查看结果- 
    
$ node main.js
    验证输出。 
    
删除一个存在的文件
文件删除成功!

  • 创建文件夹

    以下是创建目录的方法的语法- 
    
fs.mkdir(path[, mode], callback)
    参数
    这是使用的参数的描述-
    • path-这是目录名称，包括路径。
    • mode -这是要设置的目录权限。默认为0777
    • callback-这是回调函数。除可能的异常外，没有参数提供给完成回调。
    示例
    让我们创建一个名为main.js的js文件，其中包含以下代码- 
    
var fs = require("fs");

console.log("创建目录 ./test");
fs.mkdir('test1',function(err) {
   if (err) {
      return console.error(err);
   }
   console.log("目录创建成功！");
});
    现在运行main.js以查看结果- 
    
$ node main.js
    验证输出。 
    
创建目录 ./test
目录创建成功！

  • 读取文件夹

    以下是读取目录的方法的语法- 
    
fs.readdir(path, callback)
    参数
    这是使用的参数的描述-
    • path-这是目录名称，包括路径。
    • callback-这是回调函数，它获取两个参数（err，files），其中files是目录中文件名的数组，不包括“.”和“..”。
    示例
    让我们创建一个名为main.js的js文件，其中包含以下代码-（在test1下面创建了三个文件1.txt，2.txt，3.txt） 
    
var fs = require("fs");

console.log("读取文件夹 ./test1");
fs.readdir("test1/",function(err, files) {
   if (err) {
      return console.error(err);
   }
   files.forEach( function (file) {
      console.log( file );
   });
});
    现在运行main.js以查看结果- 
    
$ node main.js
    验证输出。 
    
读取文件夹 ./test1
1.txt
2.txt
3.txt

  • 删除文件夹

    以下是删除目录的方法的语法- 
    
fs.rmdir(path, callback)
    参数
    这是使用的参数的描述-
    • path-这是目录名称，包括路径。
    • callback-这是回调函数。除可能的异常外，没有参数提供给完成回调。
    示例
    让我们创建一个名为main.js的js文件，其中包含以下代码- 
    
var fs = require("fs");

console.log("删除目录 test1");
fs.rmdir("test1/",function(err) {
   if (err) {
      return console.error(err);
   }
   console.log("删除成功 ./test1");
 
});
    现在运行main.js以查看结果- 
    
$ node main.js
    验证输出。 
    
删除目录 test1
删除成功 ./test1
    提示：删除目录，要先删除目录下所有的文件，只有空目录才能删除。
上一节:
下一节: