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])
*/