Node.js中的文件系统

Node.js 使用fs(File System)模块来操作文件,文件系统模块有两种不同的方法,分别是同步方法和异步方法。

同步和异步

Node.js 文件系统模块中的方法均有异步和同步版本,如同步读取文件内容的fs.readFileSync()方法,异步读取文件内容的fs.readFile()方法。

异步方法函数最后一个参数为回调函数,回调函数的第一个参数包含了错误信息。

在大型系统中,建议使用异步方法,同步方法将会导致进程被锁死。比起同步方法,异步方法性能更高、速度更快、而且没有阻塞。

示例:

假设有如下文件test.txt:

学互联网工作技能,上侠课岛!
同步读取文件

synchronization.js内容如下:

var fs = require("fs");
var data = fs.readFileSync('test.txt');
console.log("同步读取文件内容为:\n" + data.toString());
console.log("程序执行完毕");

启动文件:

>node synchronization.js
同步读取文件内容为:
学互联网工作技能,上侠课岛!
程序执行完毕
异步读取文件

asynchronous.js内容如下:

var fs = require("fs")
fs.readFile('test.txt', function(err,data){
    if(err){
        return console.error(err);
    }
    console.log("异步读取文件内容为:\n"+data.toString());
});
console.log("程序执行完毕");

启动文件:

>node asynchronous.js
程序执行完毕
异步读取文件内容为:
学互联网工作技能,上侠课岛!

文件系统模块的使用

要使用文件系统模块,可以使用require()方法:

var fs = require('fs');

打开文件操作

在异步模式下打开文件的语法为:

fs.open(path, flags[, mode], callback)

path -- 文件路径
flags -- 文件打开行为
mode -- 文件模式
callback -- 回调函数,带有两个参数:err和fd
示例:
var fs = require("fs");
console.log("准备打开文件")
fs.open('test.txt', 'r+', function(err, fd) {
   if (err) {
       return console.error(err);
   }
  console.log("文件打开成功!");     
});

启动文件:

> node openfile.js
准备打开文件
文件打开成功!

读取文件操作

异步模式下读取文件的语法为:

fs.read(fd, buffer, offset, length, position, callback)

fd -- 文件描述符
buffer -- 数据写入的缓冲区
offset -- 缓冲区写入的写入偏移量
length -- 要从文件中读取的字节数
position -- 文件读取的起始位置,如值为null,则会从当前文件指针的位置读取
callback -- 回调函数,带有三个参数:err错误信息、bytesRead读取的字节数、buffer缓冲区对象
示例:
var fs = require("fs");
var buf = new Buffer.alloc(1024);
console.log("准备打开文件");
fs.open('test.txt', 'r+', function(err, fd){
    if(err){
        return console.error(err);
    }
    console.log("文件打开成功!\n");

    console.log("开始读取文件!");
    fs.read(fd, buf, 0, buf.length, 0, function(err,bytes){
        if(err){
            console.log(err);
        }
        console.log("总共有读取了" + bytes + "个字节");

        if(bytes > 0){
            console.log("读取的内容为:" + "\n" + buf.slice(0, bytes).toString());
        }
    });
});

启动文件:

>node readfile.js
准备打开文件
文件打开成功!

开始读取文件!
总共有读取了42个字节
读取的内容为:
学互联网工作技能,上侠课岛!

写入文件操作

异步模式下写入文件的语法为:

fs.writeFile(file, data[, options], callback)

file -- 文件名或文件描述符
data -- 要写入文件的数据,可以是 String(字符串) 或 Buffer(缓冲) 对象
options -- 该参数是一个对象,包含 {encoding, mode, flag}。默认编码为utf8,模式为 0666,flag为'w'
callback -- 回调函数,回调函数只包含错误信息参数(err),在写入失败时返回
示例:
var fs = require("fs");
console.log("准备写入文件");
fs.writeFile('write.txt', '这里是要写入的数据内容',  function(err){
    if (err) {
        return console.error(err);
    }
    console.log("数据写入成功!");
});

启动文件,write.txt中成功被写内容:

> node writefile.js
准备写入文件
数据写入成功!

关闭文件操作

异步模式下关闭文件的语法为:

fs.close(fd, callback)

fd -- 通过fs.open()方法返回的文件描述符
callback -- 回调函数,没有参数
示例:
var fs = require("fs");
console.log("准备开文件")
fs.open('test.txt', 'r+', function(err, fd) {
   if (err) {
       return console.error(err);
   }
  console.log("文件打开成功!\n");     

  //关闭文件
  console.log("准备关闭文件");    
  fs.close(fd,function(err){
    if(err) {
        console.log(err);
    }
    console.log('文件关闭成功!');
  });
});

启动文件:

> node close.js
准备开文件
文件打开成功!

准备关闭文件
文件关闭成功!

文件模块方法参考手册

方法 描述
fs.rename(oldPath, newPath, callback) 异步 rename(),回调函数没有参数,但可能抛出异常
fs.ftruncate(fd, len, callback) 异步 ftruncate(),回调函数没有参数,但可能抛出异常
fs.ftruncateSync(fd, len) 同步 ftruncate()
fs.truncate(path, len, callback) 异步 truncate(),回调函数没有参数,但可能抛出异常
fs.truncateSync(path, len) 同步 truncate()
fs.chown(path, uid, gid, callback) 异步 chown(),回调函数没有参数,但可能抛出异常
fs.chownSync(path, uid, gid) 同步 chown()
fs.fchown(fd, uid, gid, callback) 异步 fchown(),回调函数没有参数,但可能抛出异常
fs.fchownSync(fd, uid, gid) 同步 fchown()
fs.lchown(path, uid, gid, callback) 异步 lchown(),回调函数没有参数,但可能抛出异常
fs.lchownSync(path, uid, gid) 同步 lchown()
fs.chmod(path, mode, callback) 异步 chmod(),回调函数没有参数,但可能抛出异常。
fs.chmodSync(path, mode) 同步 chmod()
fs.fchmod(fd, mode, callback) 异步 fchmod(),回调函数没有参数,但可能抛出异常
fs.fchmodSync(fd, mode) 同步 fchmod()
fs.lchmod(path, mode, callback) 异步 lchmod().回调函数没有参数,但可能抛出异常。Only available on Mac OS X
fs.lchmodSync(path, mode) 同步 lchmod()
fs.stat(path, callback) 异步 stat(). 回调函数有两个参数 err, stats,stats 是 fs.Stats 对象
fs.lstat(path, callback) 异步 lstat(). 回调函数有两个参数 err, stats,stats 是 fs.Stats 对象
fs.fstat(fd, callback) 异步 fstat(). 回调函数有两个参数 err, stats,stats 是 fs.Stats 对象
fs.statSync(path) 同步 stat(). 返回 fs.Stats 的实例
fs.lstatSync(path) 同步 lstat(). 返回 fs.Stats 的实例
fs.fstatSync(fd) 同步 fstat(). 返回 fs.Stats 的实例
fs.link(srcpath, dstpath, callback) 异步 link().回调函数没有参数,但可能抛出异常
fs.linkSync(srcpath, dstpath) 同步 link()
fs.symlink(srcpath, dstpath[, type], callback) 异步 symlink().回调函数没有参数,但可能抛出异常。 type 参数可以设置为 'dir', 'file', 或 'junction' (默认为 'file')
fs.symlinkSync(srcpath, dstpath[, type]) 同步 symlink().
fs.readlink(path, callback) 异步 readlink(). 回调函数有两个参数 err, linkString
fs.realpath(path[, cache], callback) 异步 realpath(). 回调函数有两个参数 err, resolvedPath
fs.realpathSync(path[, cache]) 同步 realpath()。返回绝对路径
fs.unlink(path, callback) 异步 unlink(),回调函数没有参数,但可能抛出异常
fs.unlinkSync(path) 同步 unlink().
*fs.rmdir(path, callback) 异步 rmdir(),回调函数没有参数,但可能抛出异常
fs.rmdirSync(path) 同步 rmdir().
fs.mkdir(path[, mode], callback) S异步 mkdir(2),回调函数没有参数,但可能抛出异常。 访问权限默认为 0777
fs.mkdirSync(path[, mode]) 同步 mkdir().
fs.readdir(path, callback) 异步 readdir(3),读取目录的内容
fs.readdirSync(path) 同步 readdir(),文件数组列表
fs.close(fd, callback) 异步 close(),回调函数没有参数,但可能抛出异常
fs.closeSync(fd) 同步 close().
fs.open(path, flags[, mode], callback) 异步打开文件。
fs.openSync(path, flags[, mode]) 同步 version of fs.open().
fs.utimes(path, atime, mtime, callback)
fs.utimesSync(path, atime, mtime) 修改文件时间戳,文件通过指定的文件路径。
fs.futimes(fd, atime, mtime, callback)
fs.futimesSync(fd, atime, mtime) 修改文件时间戳,通过文件描述符指定。
fs.fsync(fd, callback) 异步 fsync.回调函数没有参数,但可能抛出异常。
fs.fsyncSync(fd) 同步 fsync.
fs.write(fd, buffer, offset, length[, position], callback) 将缓冲区内容写入到通过文件描述符指定的文件。
fs.write(fd, data[, position[, encoding]], callback) 通过文件描述符 fd 写入文件内容。
fs.writeSync(fd, buffer, offset, length[, position]) 同步版的 fs.write()。
fs.writeSync(fd, data[, position[, encoding]]) 同步版的 fs.write().
fs.read(fd, buffer, offset, length, position, callback) 通过文件描述符 fd 读取文件内容。
fs.readSync(fd, buffer, offset, length, position) 同步版的 fs.read.
fs.readFile(filename[, options], callback) 异步读取文件内容。
fs.readFileSync(filename[, options])
fs.writeFile(filename, data[, options], callback) 异步写入文件内容。
fs.writeFileSync(filename, data[, options]) 同步版的 fs.writeFile。
fs.appendFile(filename, data[, options], callback) 异步追加文件内容。
fs.appendFileSync(filename, data[, options]) The 同步 version of fs.appendFile.
fs.watchFile(filename[, options], listener) 查看文件的修改。
fs.unwatchFile(filename[, listener]) 停止查看 filename 的修改。
fs.watch(filename) 查看 filename 的修改,filename 可以是文件或目录。返回 fs.FSWatcher 对象。
fs.exists(path, callback) 检测给定的路径是否存在。
fs.existsSync(path) 同步版的 fs.exists.
fs.access(path[, mode], callback) 测试指定路径用户权限。
fs.accessSync(path[, mode]) 同步版的 fs.access。
fs.createReadStream(path[, options]) 返回ReadStream 对象。
fs.createWriteStream(path[, options]) 返回 WriteStream 对象。
fs.symlink(srcpath, dstpath[, type], callback) 异步 symlink().回调函数没有参数,但可能抛出异常。

更多可看:https://www.9xkd.com/

你可能感兴趣的:(Node.js中的文件系统)