当前位置: 首页 > 工具软件 > ws-node-demo > 使用案例 >

Node - fs(文件系统)

成浩漫
2023-12-01

什么是fs(文件系统)

  • file system
  • 在Node中,与文件的交互是非常重要的,服务器的本质就是将本地的文件发送给远程的客户端
  • Node通过fs模块来和文件系统进行交互
  • 该模块提供了一些标准文件访问API来打开,读取,写入文件,以及其他的交互
  • Node中使用fs模块,const fs = require('fs')

fs中的同步和异步

  • fs模块中的所有操作都有两种操作形式,即同步和异步
  • 同步文件系统会阻塞系统的执行,也就是除非操作完成,否则代码不会往下继续执行了
  • 异步文件系统不会阻塞程序的执行,而是在操作完成是,通过回调函数将结果返回

fs的使用

文件写入

  • 手动操作的步骤

    1. 打开文件

      • 同步:fs.openSync(path[, flags[, mode]])
        • path:要打开的文件的路径
        • flags:打开文件要做的操作类型(下面会详细介绍有多一些操作类型)
          • r:只读的
          • w:可写的
          • a: 追加
        • mode:可选值,是设置文件的操作权限,一般不传
        • 该方法会返回一个文件的描述符作为结果,我们可以通过该描述符来对文件进行各种操作
      • 异步:fs.open(path[, flags[, mode]], callback)
        • callback:两个返回参数
          • err:错误对象,如果没有就是null
          • fa:文件的描述符
    2. 向文件中写入内容

      • 同步:fs.writeSync(fd, string[, position[, encoding]])
        • fd:文件的描述符,需要传递要写入的描述符
        • string:要写入的内容
        • position:一般不写,表示写入的起始位置
        • encoding:一般不写,表示编码,默认utf-8
      • 异步:fs.write(fd, string[, position[, encoding]], callback)
    3. 保存并关闭文件

      • fs.closeSync(fd)
        • fd:要关闭文件的描述符
      • fs.close(fd[, callback])
    // 同步写入文件
    
    const fs = require('fs')
    // 打开文件
    let fd = fs.openSync('demo.txt','w')
    // 写入文件
    fs.writeSync(fd, "仙剑奇侠传三")
    // 关闭文件
    fs.closeSync(fd)
    
    // 异步写入文件
    
    const fs = require('fs')
    
    // 打开文件
    fs.open('demo2.txt','w',function(err,fd) {
        if(!err) {
             // 写入文件
            fs.write(fd,'爱情公寓',function(err) {
                if(!err) {
                    console.log('写入成功')
                }
                // 关闭文件
                fs.close(fd,function(err) {
                    if(!err) {
                        console.log('已保存并关闭文件')
                    }
                })
            })
        }else{
            console.log('出错了')
        }
    })
    
  • 简单文件写入

    • 同步:fs.writeFileSync(file, data[, options])
    • 异步:fs.writeFile(file, data[, options], callback)
      • file:要操作的文件的路径
      • data:要写入的数据
      • options:可选,可以对写入进行一些设置,是一个对象,有三个值
        • encoding:编码。默认 ‘utf8’
        • mode:文件权限。默认 0o666
        • flag:文件只读还是可写。默认 ‘w’ (下面会详细介绍有多一些操作类型)
      • callback:当写入完成以后,执行
    // 简单文件写入
    
    const fs = require('fs')
    
    // 异步
    fs.writeFile('demo3.txt','景天和雪见',function(err) {
        if(!err){
            console.log('写入成功')
        }
    })
    // 同步
    fs.writeFileSync('demo4.txt','紫萱和徐长卿')    
    
  • 流式文件写入

    • 同步,异步,简单文件写入都不适合大文件写入,所以有了流式文件写入
    • 用法:创建一个可写流,fs.createWriteStream(path[, options])
    // 流式文件写入
    
    const fs = require('fs')
    
    // 创建一个可写流
    let ws = fs.createWriteStream('demo.txt')
    // 通过ws想文件中输出内容
    ws.write("通过可写流写入的内容")
    // 关闭流,不能用ws.close(),不然文件传不完
    ws.end()
    
  • flag: 文件操作类型有哪些

    • r:读取文件,文件不存在则出现异常
    • r+:读写文件,文件不存在则出现异常
    • rs:在同步模式下打开文件用于读取
    • rs+:在同步模式下打开文件用于读写
    • w:打开文件用于写操作,如果不存在则创建,如果存在则截断,截断即覆盖全部
    • wx:打开文件用于写操作,如果存在则打开失败
    • w+: 打开文件用于读写,如果不存在则创建,如果存在则截断
    • wx+:打开文件用于读写,如果存在则打开失败
    • a:打开文件用于追加,如果不存在则创建
    • ax:打开文件用于追加,如果路径存在则失败
    • a+:打开文件进行读取和最佳,如果不存在则创建
    • ax+:打开文件进行读取和追加,如果路径存在则失败

文件读取

  • 简单文件读取
    • 同步:fs.readFileSync(path[, options])
    • 异步:fs.readFile(path[, options], callback)
      • callback(err,data)
        • err:错误对象
        • data:读取到的数据,是一个Buffer,为什么是Buffer呢?因为读取到的不一定是字符串,可能是图片,音频等。Buffer的通用性更高。字符串的话可以用toString读取数据
    // 简单文件读取
    
    const fs = require('fs')
    
    fs.readFile('demo.txt',function(err,data) {
        if(!err) {
            console.log(data)
            console.log(data.toString())
        }
    })
    
  • 流式文件读取
    • 同样适用于大文件
    • 用法:fs.createReadStream(path[, options])
    // 流式读取文件
    
    const fs = require('fs')
    
    // 创建一个可读流
    let rs = fs.createReadStream('demo.txt')
    // 读取可读流中的数据,必须要可读流绑定一个data事件,data事件绑定完毕,他会自动读取数据
    rs.on('data',function(data) {
        console.log(data)
        console.log(data.toString())
    })
    
    // 如果我们想把读取到数据写到另一个文件当中
    let ws = fs.createWriteStream('demo1.txt')
    // 使用pipe(管道),会直接输入到ws中
    rs.pipe(ws)
    
 类似资料: