nodejs 之 file system 文件系统

var fs = require('fs');
/**
   先解释有函数如：unlink()和unlinkSync()，它们的功能是一样的
   只是unlink是同步类型，因为它最后那个参数是回调函数，而unlinkSync参数中是没有回调函数的
   两个方法运用比较如下：
   1，fs.unlink('/tmp/hello', function (err) {
         if (err) throw err;
         console.log('successfully deleted /tmp/hello');
       });
   2，fs.unlinkSync('/tmp/hello')
      console.log('successfully deleted /tmp/hello');
   
   同步类型的方法并没有固定的运行顺序，如下面的代码就可能出错：
    fs.rename('/tmp/hello', '/tmp/world', function (err) {
          if (err) throw err;
          console.log('renamed complete');
    });
        fs.stat('/tmp/world', function (err, stats) {
          if (err) throw err;
          console.log('stats: ' + JSON.stringify(stats));
        });
        fs.stat很可能在fs.rename之前被执行。下面是正确的方法：
        fs.rename('/tmp/hello', '/tmp/world', function (err) {
          if (err) throw err;
          fs.stat('/tmp/world', function (err, stats) {
            if (err) throw err;
            console.log('stats: ' + JSON.stringify(stats));
          });
        });
        在很繁忙进程中，强烈建议使用异步类型的函数。因同步的，在它没有运行完之前，将阻塞整个进程
        
*/


/** fs.rename(oldPath, newPath, [callback])
 
*/

/** fs.truncate(fd, len, [callback])
 
*/

/** fs.chown(path, uid, gid, [callback])
    fs.fchown(fd, uid, gid, [callback])
    fs.lchown(path, uid, gid, [callback])
 
*/

/** fs.chmod(path, mode, [callback])
    fs.fchmod(fd, mode, [callback])
    fs.lchmod(path, mode, [callback])
 
*/

/** fs.stat(path, [callback])
    fs.lstat(path, [callback])
    fs.fstat(fd, [callback]) fd file descriptor文件说明符
    它们的回调函数拥有两个参数（err,stats），stats为fs.Stats对象
     •stats.isFile()
         •stats.isDirectory()
         •stats.isBlockDevice()
         •stats.isCharacterDevice()
         •stats.isSymbolicLink() (only valid with fs.lstat())
         •stats.isFIFO()
         •stats.isSocket()

*/

/** fs.link(srcpath, dstpath, [callback])
    fs.symlink(srcpath, dstpath, [type], [callback])
        type参数值为dir、file或junction.只适用于Windows,其他平台type被忽略
        当用的是junctions时，dstpath（destination path目标路径）要为绝对路径
        dstpath将会被自动标准化（normalized）为绝对路径
    fs.readlink(path, [callback])
      回调函数拥有两个参数(err, linkString)
*/


/** fs.realpath(path, [cache], callback)
    回调函数拥有两个参数(err, resolvedPath)
*/
  var cache = {'/etc':'/private/etc'};
  fs.realpath(process.cwd() +'/etc/passwd', cache, function(err, resolvedPath){
      if(err) throw err;
      console.log(resolvedPath);
    });

/** fs.unlink(path, [callback])
*/


/** fs.rmdir(path, [callback])          删除目录
    fs.mkdir(path, [mode], [callback])  创建目录
    fs.readdir(path, [callback])
      回调函数拥有两个参数(err, files) files为path路径下文件名的数组
    
*/


/** fs.close(fd, [callback])
*/

/** fs.open(path, flags, [mode], [callback])
     回调函数拥有两个参数(err, fd)
*/

/** fs.write(fd, buffer, offset, length, position, [callback])
    回调函数拥有三个参数(err, written, buffer)
    buffer写到fd文件的内容，offset,length为从offset位置开始写length长的内容（buffer）
    position为从fd文件position位置开始把内容写进去
*/

/** fs.read(fd, buffer, offset, length, position, [callback])
     在buffer的offset位置开始写入fd文件中position位置开始的内容，内容长度为length
     回调函数拥有三个参数(err, bytesRead, buffer).

*/
/** fs.readFile(filename, [encoding], [callback])
     读取文件的全部内容
     回调函数拥有两个参数(err, data).data为文件的内容
*/
  fs.readFile('/etc/passwd', function (err, data) {
     if (err) throw err;
       console.log(data);
   });
/** fs.writeFile(filename, data, [encoding], [callback])
     将data数据写入到filename中
*/
  fs.writeFile('message.txt', 'Hello Node', function (err) {
     if (err) throw err;
     console.log('It\'s saved!');
  });
/** fs.appendFile(filename, data, encoding='utf8', [callback])
     将data数据添加到filename文件中，文件不存在会自动创建
     当data为buffer时，encoding忽略不写，data可以为string或buffer
*/
  fs.appendFile('message.txt', 'data to append', function (err) {
    if (err) throw err;
     console.log('The "data to append" was appended to file!');
  });
/** fs.watchFile(filename, [options], listener) //不稳定，如果可用，用fs.watch()
      监视文件，listener回调函数在每次文件被使用时触发
      options有两个选项：persistent 布尔值--文件被监视进程是否再继续，
                        interval 时间(单位毫秒)--文件被多长时间被查询一次
    fs.unwatchFile(filename, [listener])   //不稳定，如果可用，用fs.watch()
    fs.watch(filename, [options], [listener]) //不稳定，不是所有的平台都适用
*/
   fs.watchFile('message.text', function (curr, prev) {
          console.log('the current mtime is: ' + curr.mtime);
          console.log('the previous mtime was: ' + prev.mtime);
        });
        fs.watch('somedir', function (event, filename) { //目前只有linux和windows平台提供filename参数
          console.log('event is: ' + event);
          if (filename) {
            console.log('filename provided: ' + filename);
          } else {
            console.log('filename not provided');
          }
        });
        
/**  fs.exists(path, [callback])
     判断path是否存在
*/
 fs.exists('/etc/passwd', function (exists) {
  util.debug(exists ? "it's there" : "no passwd!");
});

/**  fs.createReadStream(path, [options])
      { flags: 'r',
        encoding: null, //'utf8', 'ascii', or 'base64'
        fd: null,
        mode: 0666,
        bufferSize: 64 * 1024
      } 也有start,end表示从什么位置开始读，到什么位置结束
*/
/**  fs.createWriteStream(path, [options])
      { flags: 'w',
              encoding: null,
              mode: 0666 }也包括start允许从什么位置开始写入数据
*/
/** fs.utimes(path, atime, mtime, [callback])
      更改path路径下的文件的文件时间戳
      fs.futimes(fd, atime, mtime, [callback])
      更改有关该文件说明符的文件的文件时间戳
*/


/** fs.fsync(fd, [callback])
*/