node.js api解读之file system模块皇牌天下投注网:

来源:http://www.prospettivedarte.com 作者:计算机教程 人气:187 发布时间:2019-05-10
摘要:流程图如下: fs.rename(path1, path2, [callback]),fs.renameSync(path1, path2) 重命名某个文件,前者异步调用,后者同步调用。除非回调函数执行过程出现了异常,否则不会传递任何参数。例如: 重回

  流程图如下:皇牌天下投注网 1

fs.rename(path1, path2, [callback]),fs.renameSync(path1, path2)
重命名某个文件,前者异步调用,后者同步调用。除非回调函数执行过程出现了异常,否则不会传递任何参数。 例如:

重回DescriptionFilePlugin

var fs=require('fs');
fs.rename('D:/test.js','D:/test1.js',function(err){
    if(err){
       console.log(err);  
    }else{
       console.log('renamed complete');
     }
})

  上一节最后进入relative事件流,注入地点如下:

fs.truncate(fd,len,[callback]),fs.trucateSync(fd,len)
异步调用截断某个文件,如果执行过程中出现异常,回调函数接收一个参数(err),否则不传递任何参数。

// relative
plugins.push(new DescriptionFilePlugin("relative", descriptionFiles, "described-relative"));
plugins.push(new NextPlugin("after-relative", "described-relative"));
var fs=requrie('fs');
fs.open('../test.js',function(err,fd){
    fs.truncate('../test.js',10,function(err){
        if(err){
            throw err;
        }
        console.log(fd);
    });    
}); 

  这似曾相识的感觉,这不就是解析package.json的插件么,又调用了一次。

fs.chmod(path, mode, [callback]) 和 fs.chmodSync(path, mode)
修改文件权限,主要说下第二个参数,实际上是:-rwxrwxrwx,三个一组,r:4、w:2、x:1、-: 0。可以 参考 http://zh.wikipedia.org/zh/Chmod

  但是有一点点微妙的不同,第一次调用该插件时,request对象如下所示:

fs.stat(path, [callback]),fs.lstat(path, [callback]),fs.fstat(fd, [callback]) 和 fs.statSync(path)、fs.lstatSync(path)、fs.fstatSync(fd)
读取文件元信息,回调函数将返回两个参数(err, stats),其中stats是fs.Stats的一个对象.者的区别在于:
第一个是返回文件的信息,参数是路径
第二个是和第一个一样,当路径是文件链接时,返回这个链接文件的信息
第三个是传递参数为fd文件描述符
fs.link(srcpath, dstpath, [callback])、fs.linkSync(srcpath, dstpath) 和 fs.symlink(linkdata, path, [callback])、fs.symlinkSync(linkdata, path)
建立文件链接,除非回调函数执行过程出现了异常,否则不会传递任何参数。link和symlink的区别是: link 创建的是hard link 所谓硬链接 symlink创建的是symbolic link 所谓符号链接 硬链接就是备份,软连接就是快捷方式
fs.readlink(path, [callback])、fs.realpath(path, [callback]) 、fs.unlink(path, [callback])和 fs.readlinkSync(path)、fs.realpathSync(path)、fs.unlinkSync(path)
异步调用readlink,回调函数返回两个参数(err,resolvedPath),resolvedPath为解析后的文件路径。 这3个函数分别是: 1、readlink:读取链接源地址 2、realpath:根据相对地址转换为绝对地址 3、unlink:删除某一个文件链接
fs.rmdir(path, [callback])、fs.mkdir(path, mode, [callback])、fs.readdir(path, [callback]) 和 fs.rmdirSync(path)、fs.mkdirSync(path, mode)、fs.readdirSync(path)
三个命令分别是: rmdir:删除目录 mkdir:建立目录 readdir:读取目录中的内容。回调函数接受两个参数(err, files),其中files参数是保存了目录中所有文件名的数组('.'和'..'除外)。
fs.close(fd, [callback])、fs.closeSync(fd) 和 fs.open(path, flags, [mode], [callback])、fs.openSync(path, flags, [mode])
fs.open与 C 语言标准库中的 fopen 函数类似。它接受两个必选参数,path 为文件的路径, flags 可以是以下值。  r :以读取模式打开文件。
 r :以读写模式打开文件。
 w :以写入模式打开文件,如果文件不存在则创建。
 w :以读写模式打开文件,如果文件不存在则创建。
 a :以追加模式打开文件,如果文件不存在则创建。
 a :以读取追加模式打开文件,如果文件不存在则创建。
mode 参数用于创建文件时给文件指定权限,默认是 0666。回调函数将会传递一个文 件描述符 fd。
fs.utimes(path, atime, mtime, callback)、fs.utimesSync(path, atime, mtime) 和 fs.futimes(path, atime, mtime, callback)、fs.futimesSync(path, atime, mtime)
更改文件时间戳,2者区别在于,utimes更改此文件时间戳,如果此文件指向一个符号链接,futimes更改符号链接的时间戳。
fs.write(fd, buffer, offset, length, position, [callback]) 和 fs.writeSync(fd, buffer, offset, length, position) 和 fs.writeSync(fd, str, position, encoding='utf8')
fs.write将buffer缓冲器内容写入fd文件描述符,
offset和length决定了将缓冲器中的哪部分写入文件。
position指明将数据写入文件从头部算起的偏移位置,若position为null,数据将从当前位置开始写入
回调函数接受两个参数(err, written),其中written标识有多少字节的数据已经写入
第三个是基于字符串的fs.write()的同步版本,返回写入数据的字节数。
注意:写完后要关闭它
fs.read(fd, buffer, offset, length, position, [callback]) 、fs.readSync(fd, buffer, offset, length, position)、fs.readSync(fd, length, position, encoding) 和 fs.readFile(filename, [encoding], [callback])、fs.readFileSync(filename, [encoding]) 〈br /> 前3个是读取文件描述符和BUFFER的方法,后2个是读取文件全部内容,比如输出html模版,或者css文件等。
一般来说,除非必要,否则不要使用前3个是读取文件方式读取文件,因为它要求你手动管理缓冲区 和文件指针,尤其是在你不知道文件大小的时候,这将会是一件很麻烦的事情。
fs.read回调函数接受两个参数,(err, bytesRead),bytesRead返回读取到的字节数。
fs.readFile的回调函数将传入两个参数(err, data),其中data为文件内容,如果没有设置编码,那么将返回原始内容格式的缓冲器。
fs.writeFile(filename, data, encoding='utf8', [callback]),fs.writeFileSync(filename, data, encoding='utf8')
对应文件写功能
〈strong>fs.watchFile(filename, [options], listener),fs.unwatchFile(filename)
fs.watchFile监听指定文件filename的变化,回调函数listener将在每次该文件被访问时被调用.
第二个参数[options]是可选项,如果指定了options参数,它应该是一个包含如下内容的对象:名为persistent的布尔值,和名为interval单位为毫秒的轮询时间间隔,默认值为{ persistent: true, interval: 0 }。 listener监听器将获得两个参数(curr, prev),分别标识当前的状态对象和改变前的状态对象,这些状态对象为fs.Stat的实例。
fs.unwatchFile停止监听文件filename的变化。
fs.Stats
fs.stat()和 fs.lstat()方法返回的对象为此类型
stats.isFile()
stats.isDirectory()
stats.isBlockDevice()
stats.isCharacterDevice()
stats.isSymbolicLink() (only valid with fs.lstat()) stats.isSymbolicLink() (仅对fs.lstat()有效)
stats.isFIFO()
stats.isSocket()

/*
    {
        context: { issuer: '', compiler: undefined },
        path: 'd:\workspace\doc',
        request: './input.js',
        query: '',
        module: false,
        directory: false,
        file: false
    }
*/

{ dev: 2049,
ino: 305352,
mode: 16877,
nlink: 12,
uid: 1000,
gid: 1000,
rdev: 0,
size: 4096,
blksize: 4096,
blocks: 8,
atime: '2009-06-29T11:11:55Z',
mtime: '2009-06-29T11:11:40Z',
ctime: '2009-06-29T11:11:40Z' }

  在经过几个插件的洗礼后,变成了下面这样:

fs.createReadStream(path, [options])
返回一个新的可读流对象options是包含如下默认值的对象:
{ flags: 'r', encoding: null, fd: null, mode: 0666, bufferSize: 64 * 1024 }
如果不想读取文件的全部内容,可以在options参数中设置start和end属性值以读取文件中指定范围的内容。start和end包含在范围中(闭集合),取值从0开始。这两个参数需要同时设置。
fs.createWriteStream(path, [options])

/*
    {
        context: { issuer: '', compiler: undefined },
        path: 'd:\workspace\doc\input.js',
        request: undefined,
        query: '',
        module: false,
        directory: false,
        file: false,
        descriptionFilePath: 'd:\workspace\doc\package.json',
        descriptionFileData: {*package.json*},
        descriptionFileRoot: 'd:\workspace\doc',
        relativePath: './input.js',
        __innerRequest_request: './input.js',
        __innerRequest_relativePath: '.',
        __innerRequest: './input.js'
    }
*/

options参数是包含如下默认值的对象:
{ flags: 'w', encoding: null, mode: 0666 }

  主要变化就是path由文件目录变成了文件路径,request被置为undefined。

  由于插件源码之前跑过,但是有一个不同点,就是forEachBail中的路径获取。

var descriptionFilePath = resolver.join(directory, filename);

  这里的directory就是上面的path,filename没有变,就是package.json。

  之前看源码分析过,这里是获取对应directory的Map值,然后再获取Map中键为filename的路径字符串,由于参数更改,所以这里内部生成了一个新的Map保存新directory路径。

  那么问题来了,再来看看处理路径的方法:

module.exports = function join(path, request) {
    /*
        path => d:\workspace\doc\input.js
        request => package.json
    */
    if (!request) return normalize(path);
    if (absoluteWinRegExp.test(request)) return normalize(request.replace(///g, "\"));
    if (absoluteNixRegExp.test(request)) return normalize(request);
    if (path == "/") return normalize(path   request);
    // 依然满足绝对路径的正则校验
    // 拼接后变成了d:workspacedocinput.jspackage.json
    if (absoluteWinRegExp.test(path)) return normalize(path.replace(///g, "\")   "\"   request.replace(///g, "\"));
    if (absoluteNixRegExp.test(path)) return normalize(path   "/"   request);
    return normalize(path   "/"   request);
};

  完全是一个非法路径,所以以下代码会直接报错:

if (resolver.fileSystem.readJson) {
    // 非法路径
    resolver.fileSystem.readJson(descriptionFilePath, function(err, content) {
        if (err) {
            /*
                { 
                    Error: ENOENT: no such file or directory, open 'd:workspacedocinput.jspackage.json'
                    errno: -4058,
                    code: 'ENOENT',
                    syscall: 'open',
                    path: 'd:\workspace\doc\input.js\package.json' 
                }
            */
            // 进入这个if分支
            if (typeof err.code !== "undefined") return callback();
            return onJson(err);
        }
        onJson(null, content);
    });
}

  注意,这里调用的是无参callback,进入的分支也不一样:

function(err, result) {
    if (err) return callback(err);
    // 之前读取package.json成功进入这个分支
    if (result) {
        return callback(null, result);
    }
    // 这次是这里 
    else {
        directory = cdUp(directory);
        if (!directory) {
            return callback();
        } else {
            return findDescriptionFile();
        }
    }
}

  这个奇妙的cdUp函数名就很灵性了,看看是什么鬼。

// directory => d:workspacedocinput.js
function cdUp(directory) {
    if (directory === "/") return null;
    // 从后往前搜索路径字符
    var i = directory.lastIndexOf("/"),
        j = directory.lastIndexOf("\");
    var p = i < 0 ? j : j < 0 ? i : i < j ? j : i;
    if (p < 0) return null;
    // 切割字符串
    // 返回d:workspacedoc
    return directory.substr(0, p || 1);
}

  其实也没啥,三元超级表达式配合返回的切割就是获取对应的目录。

  获取到了对应的目录,再次调用了findDescriptionFile函数,即读取配置文件的IIFE。这一次directory变成了目录,跟第一次一样,走的流程也一样了。

 

described-relative => FileKindPlugin

  最后其实什么都没有做,触发了下一个事件流described-relative,这个插件比较简单:

FileKindPlugin.prototype.apply = function(resolver) {
    var target = this.target;
    resolver.plugin(this.source, function(request, callback) {
        // false
        if (request.directory) return callback();
        var obj = Object.assign({}, request);
        delete obj.directory;
        resolver.doResolve(target, obj, null, callback);
    });
};

  由于之前在ParsePlugin解析过文件属性,判断为非文件目录,所以会直接调用doResolve进行下一个事件流。

  说实话,我有点怕这里调用callback,因为又要思考,这到底是哪个callback???

 

raw-file => TryNextPlugin

  该事件流注入如下:

本文由皇牌天下投注网发布于计算机教程,转载请注明出处:node.js api解读之file system模块皇牌天下投注网:

关键词:

上一篇:皇牌天下投注网使用Sencha Cmd创建Ext项目

下一篇:没有了

最火资讯