Node.js 文件系统

一、引入文件系统

• Node.js 提供一组类似 UNIX（POSIX）标准的文件操作API。 Node 导入文件系统模块(fs)语法如下所示：
• var fs = require(“fs”)

二、异步和同步

• Node.js 文件系统（fs 模块）模块中的方法均有异步和同步版本，例如读取文件内容的函数有异步的 fs.readFile() 和同步的 fs.readFileSync()。
  异步的方法函数最后一个参数为回调函数，回调函数的第一个参数包含了错误信息(error)。
• 建议大家使用异步方法，比起同步，异步方法性能更高，速度更快，而且没有阻塞。
• 文件系统当中存在两种方法，同步和异步(常用)

异步读取

// 引入fs文件系统模块
const fs=require("fs");
const http=require("http");
const host="localhost";
const port=80;
let app=http.createServer((req,res)=>{
   let path=req.url;
   if(path!=="/favicon.ico"){
       res.writeHead(200,{"Content-Type":"text/html;charset=utf-8"});
       // 异步读取
       // 三个参数，文件的路径、设置编码(读写方式)、回调函数
       fs.readFile("./text/笔记.txt",['utf-8','r+'],(err,data)=>{
           if(err)
           {
               throw err;
           }
           // 直接把buffer转成文本
           // 写出文本
           res.write(data.toString());
           // 结束响应
           res.end();
       });
   }
});
app.listen(port,host,()=>{
   console.log(`http://${host}:${port}`);
})

同步读取

       // 同步读取
       let data=fs.readFileSync("./text/笔记.txt",['utf-8','r+']);
       // 写出文本
       res.write(data.toString());
       // 结束响应
       res.end();

三、文件打开

• 语法
• 以下为在异步模式下打开文件的语法格式：
• fs.open(path, flags[, mode], callback)
• 参数
• (1)path - 文件的路径。
• (2)flags - 文件打开的行为。具体值详见下文。
• (3)mode - 设置文件模式(权限)，文件创建默认权限为 0666(可读，可写)。
• (4)callback - 回调函数，带有两个参数如：callback(err, fd)。
• flags 参数可以是以下值：

Flag	描述
r	以读取模式打开文件。如果文件不存在抛出异常。
r+	以读写模式打开文件。如果文件不存在抛出异常。
rs	以同步的方式读取文件。
rs+	以同步的方式读取和写入文件。
w	以写入模式打开文件，如果文件不存在则创建。
wx	类似 ‘w’，但是如果文件路径存在，则文件写入失败。
w+	以读写模式打开文件，如果文件不存在则创建。
wx+	类似 ‘w+’， 但是如果文件路径存在，则文件读写失败。
a	以追加模式打开文件，如果文件不存在则创建。
ax	类似 ‘a’， 但是如果文件路径存在，则文件追加失败。
a+	以读取追加模式打开文件，如果文件不存在则创建。
ax+	类似 ‘a+’， 但是如果文件路径存在，则文件读取追加失败。

       // 打开文件
       fs.open("./text/笔记.txt",'r+',(err,fd)=>{
           if(err)
           {
               throw err;
           }
           console.log(fd);
           res.end();
       })

四、获取文件信息

• 语法
• 以下为通过异步模式获取文件信息的语法格式：
• fs.stat(path, callback)
• 参数
• (1)path - 文件路径。
• (2)callback - 回调函数，带有两个参数如：(err, stats), stats 是 fs.Stats 对象。
• (3)fs.stat(path)执行后，会将stats类的实例返回给其回调函数。可以通过stats类中的提供方法判断文件的相关属性。
• stats类中的方法有：

方法	描述
stats.isFile()	如果是文件返回 true，否则返回 false。
stats.isDirectory()	如果是目录返回 true，否则返回 false。
stats.isBlockDevice()	如果是块设备返回 true，否则返回 false。
stats.isCharacterDevice()	如果是字符设备返回 true，否则返回 false。
stats.isSymbolicLink()	如果是软链接返回 true，否则返回 false。
stats.isFIFO()	如果是FIFO，返回true，否则返回 false。FIFO是UNIX中的一种特殊类型的命令管道。
stats.isSocket()	如果是 Socket 返回 true，否则返回 false。

		// 获取文件的信息
       fs.stat('./text',(err,stat)=>{
           if(err)
           {
               throw err;
           }
           console.log(stat);
           console.log(stat.isFile());//false
           console.log(stat.isDirectory());//true
       });
       res.end();

五、写入文件

覆盖式写入

• 语法
• 以下为异步模式下写入文件的语法格式：
• fs.writeFile(file, data[, options], callback)
• writeFile 直接打开文件默认是 w 模式，所以如果文件存在，该方法写入的内容会覆盖旧的文件内容。
• 参数
• file - 文件名或文件描述符。
• data - 要写入文件的数据，可以是 String(字符串) 或 Buffer(缓冲) 对象。
• options - 该参数是一个对象，包含 {encoding, mode, flag}。默认编码为 utf8, 模式为 0666 ， flag 为 ‘w’
• callback - 回调函数，回调函数只包含错误信息参数(err)，在写入失败时返回。

       let query=url.parse(path,true).query;
       let str=query.txt;
       fs.writeFile("./text/a.txt",str,['w'],(err)=>{
           if(err)
           {
               console.log("写入失败");
               throw err;
           }
           console.log("写入成功！");
       });
       res.end();

追加写入

• 语法
• fs.appendFile(filename, data[, options], callback)
• 异步追加文件内容。

		fs.appendFile('./data/a.txt',"\n赵佳敏",(err)=>{
           if(err){
               throw err;
           }
           console.log("写入成功！");
       })
       res.end();

六、读取文件

• 语法
• 以下为异步模式下读取文件的语法格式：
• fs.read(fd, buffer, offset, length, position, callback)
• 该方法使用了文件描述符来读取文件。
• 参数
• (1)fd - 通过 fs.open() 方法返回的文件描述符。
• (2)buffer - 数据写入的缓冲区。
• (3)offset - 缓冲区写入的写入偏移量。
• (4)length - 要从文件中读取的字节数。
• (5)position - 文件读取的起始位置，如果 position 的值为 null，则会从当前文件指针的位置读取。
• (6)callback - 回调函数，有三个参数err, bytesRead, buffer，err 为错误信息， bytesRead 表示读取的字节数，buffer 为缓冲区对象。

       let buff=Buffer.alloc(1024);
       fs.open("./text/A.txt",(err,fd)=>{
           if(err)
           {
               throw err;
           }
           // 参数1.读取的文件 2.读取的值放到缓冲池 3.读取的字节长度 4.文件的哪个位置开始读取
           fs.read(fd,buff,0,1024,0,(err,bytes,buffer)=>{
               if(err)
               {
                   throw err;
               }
               console.log("读取的字节",bytes);//6
               console.log(buffer);
               console.log(buff);
           });
           res.end();

七、关闭文件

• 语法
• 以下为异步模式下关闭文件的语法格式：
• fs.close(fd, callback)
• 该方法使用了文件描述符来读取文件。
• 参数
• (1)fd - 通过 fs.open() 方法返回的文件描述符。
• (2)callback - 回调函数，没有参数。

		// 关闭文件
       fs.open("./text/a.txt",'r+',(err,fd)=>{
           if(err){
               throw err;
           }
           console.log("文件已经打开");
           // 文件关闭
           fs.close(fd,()=>{
               console.log("关闭成功！");
           });
       });
       res.end();

八、创建目录

• 语法
• 以下为创建目录的语法格式：
• fs.mkdir(path[, options], callback)
• 参数
• (1)path - 文件路径。
• (2)options 参数可以是：
• a.recursive - 是否以递归的方式创建目录，默认为 false。
• b.mode - 设置目录权限，默认为 0777。
• (3)callback - 回调函数，没有参数。

// 创建目录
       let QQ="1455372";
       fs.mkdir(`./text/${QQ}`,()=>{
           console.log("目录创建成功！");
       });
       res.end();

九、删除文件

• 语法
• fs.unlink(path, callback)
• 参数
• (1)path - 文件路径。
• (2)callback - 回调函数，没有参数。

		// 删除文件
       // 写入一个文件
       fs.writeFile("./text/b.txt","文件",(err)=>{
           if(err){
               throw err;
           }
           console.log("写入文件成功！");
       });
       setTimeout(function(){
           fs.unlink("./text/b.txt",()=>{
               console.log("删除成功！");
           })
       },3000);
       res.end();

十、读取目录

• 语法
• fs.readdir(path, callback)
• 参数
• (1)path - 文件路径。
• (2)callback - 回调函数，回调函数带有两个参数err, files，err 为错误信息，files 为 目录下的文件数组列表。

		// 读取目录
       let path="./text";
       fs.readdir(path,(err,files)=>{
           if(err)
           {
               throw err;
           }
           console.log(files);
           // 检测里面的文件类型
           files.forEach((item)=>{
               fs.stat(`${path}/${item}`,(err,stat)=>{
                   if(err){
                       throw err;
                   }
                   console.log(item+"是文件"+stat.isFile());
                   console.log(item+"是目录"+stat.isDirectory());
               })
           })
       });
       res.end();

十一、删除目录

• 必须保证要删除的目录下不能存在文件或者目录
• 语法
• fs.rmdir(path, callback)
• 参数
• (1)path - 文件路径。
• (2)callback - 回调函数，没有参数。

		// 删除目录
       // 但是必须保证要删除的目录下不能存在文件或者目录
       fs.rmdir("./text/1455372",(err)=>{
           if(err)
           {
               throw err;
           }
           console.log("删除目录成功！");
       });
       res.end();

十二、重命名

• 语法
• fs.rename(oldPath, newPath, callback)
• 异步 rename().回调函数没有参数，但可能抛出异常。

		// 重命名
       fs.rename('./text','./data',(err)=>{
           if(err){
               throw err;
           }
           console.log("命名成功！");
       })
       res.end();

十三、检测文件路径

• 语法
• fs.exists(path, callback)
• 检测给定的路径是否存在。

		// 检测文件路径
       fs.exists("./data/info",(exit)=>{
           if(exit){
               console.log("文件路径存在");
           }
           else{
               console.log("文件路径不存在");
           }    
       })
       res.end();