文件系统

https://nodejs.org/api/fs.html

异步和同步

方法名带有 Sync 的都是同步方式
建议大家是用异步方法，比起同步，异步方法性能更高，速度更快，而且没有阻塞。

open 打开文件

• 格式

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

• 参数

path - 文件的路径。
flags - 文件打开的行为。具体值详见下文。
mode - 设置文件模式(权限)，文件创建默认权限为 0666(可读，可写)。
callback - 回调函数，带有两个参数如：callback(err, fd)。

• flags 参数可以是以下值

带x的都是如果文件存在就失败
带+的都是写操作
带s的都是同步操作

• 代码

var fs = require("fs");

// 异步打开文件
console.log("准备打开文件！");
fs.open('input.txt', 'r+', function(err, fd) {
   if (err) {
       return console.error(err);
   }
  console.log("文件打开成功！");     
});

• 运行&输出

$ node open.js
准备打开文件！
文件打开成功！

stat 获取文件信息

• 格式

fs.stat(path, callback)

• 参数

path - 文件路径。
callback - 回调函数，带有两个参数如：(err, stats), stats 是 fs.Stats 对象。

• stats类中的方法有

• 代码

var fs = require("fs");

console.log("准备打开文件！");
fs.stat('input.txt', function (err, stats) {
   if (err) {
       return console.error(err);
   }
   console.log(stats);
   console.log("读取文件信息成功！");

   // 检测文件类型
   console.log("是否为文件(isFile) ? " + stats.isFile());
   console.log("是否为目录(isDirectory) ? " + stats.isDirectory());    
});

• 运行&输出

$ node stat.js
准备打开文件！
{ dev: 16777220,
  mode: 33188,
  nlink: 1,
  uid: 501,
  gid: 20,
  rdev: 0,
  blksize: 4096,
  ino: 11045667,
  size: 94,
  blocks: 8,
  atime: Wed Nov 30 2016 15:50:28 GMT+0800 (CST),
  mtime: Wed Nov 30 2016 15:50:28 GMT+0800 (CST),
  ctime: Wed Nov 30 2016 15:50:28 GMT+0800 (CST),
  birthtime: Wed Nov 30 2016 15:50:13 GMT+0800 (CST) }
读取文件信息成功！
是否为文件(isFile) ? true
是否为目录(isDirectory) ? false

writeFile 写入文件

• 格式

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

• 参数

path - 文件路径。
data - 要写入文件的数据，可以是 String(字符串) 或 Buffer(流) 对象。
options - 该参数是一个对象，包含 {encoding, mode, flag}。默认编码为 utf8, 模式为 0666 ， flag 为 'w'
callback - 回调函数，回调函数只包含错误信息参数(err)，在写入失败时返回。

• 代码

var fs = require("fs");

console.log("准备写入文件");
fs.writeFile('input.txt', '京东(JD.COM)-综合网购首选-',  function(err) {
   if (err) {
       return console.error(err);
   }
   console.log("数据写入成功！");
   console.log("--------我是分割线-------------")
   console.log("读取写入的数据！");
   fs.readFile('input.txt', function (err, data) {
      if (err) {
         return console.error(err);
      }
      console.log("异步读取文件数据: " + data.toString());
   });
});

• 运行&输出

$ node writeFile.js
准备写入文件
数据写入成功！
--------我是分割线-------------
读取写入的数据！
异步读取文件数据: 京东(JD.COM)-综合网购首选-

read 读取文件

• 格式

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

• 参数

fd - 通过 fs.open() 方法返回的文件描述符。
buffer - 数据写入的缓冲区。
offset - 缓冲区写入的写入偏移量。
length - 要从文件中读取的字节数。
position - 文件读取的起始位置，如果 position 的值为 null，则会从当前文件指针的位置读取。
callback - 回调函数，有三个参数err, bytesRead, buffer，err 为错误信息， bytesRead 表示读取的字节数，buffer 为缓冲区对象。

• 代码

var fs = require("fs");
var buf = new Buffer(1024);

console.log("准备打开已存在的文件！");
fs.open('input.txt', 'r+', function(err, fd) {
   if (err) {
       return console.error(err);
   }
   console.log("文件打开成功！");
   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(buf.slice(0, bytes).toString());
      }
   });
});

• 运行&输出

$ node read.js
准备打开已存在的文件！
文件打开成功！
准备读取文件：
34  字节被读取
京东(JD.COM)-综合网购首选-

关闭文件

• 格式

fs.close(fd, callback)

• 参数

fd - 通过 fs.open() 方法返回的文件描述符。
callback - 回调函数，没有参数。

• 代码

var fs = require("fs");
var buf = new Buffer(1024);

console.log("准备打开文件！");
fs.open('input.txt', 'r+', function(err, fd) {
   if (err) {
       return console.error(err);
   }
   console.log("文件打开成功！");
   console.log("准备读取文件！");
   fs.read(fd, buf, 0, buf.length, 0, function(err, bytes){
      if (err){
         console.log(err);
      }

      // 仅输出读取的字节
      if(bytes > 0){
         console.log(buf.slice(0, bytes).toString());
      }

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

• 运行&输出

$ node close.js
准备打开文件！
文件打开成功！
准备读取文件！
京东(JD.COM)-综合网购首选-
文件关闭成功

截取文件

• 格式

fs.ftruncate(fd, len, callback)

• 参数

fd - 通过 fs.open() 方法返回的文件描述符。
len - 文件内容截取的长度。
callback - 回调函数，没有参数。

• 代码

var fs = require("fs");
var buf = new Buffer(1024);

console.log("准备打开文件！");
fs.open('input.txt', 'r+', function(err, fd) {
   if (err) {
       return console.error(err);
   }
   console.log("文件打开成功！");
   console.log("截取10字节后的文件内容。");

   // 截取文件
   fs.ftruncate(fd, 10, function(err){
      if (err){
         console.log(err);
      } 
      console.log("文件截取成功。");
      console.log("读取相同的文件"); 
      fs.read(fd, buf, 0, buf.length, 0, function(err, bytes){
         if (err){
            console.log(err);
         }

         // 仅输出读取的字节
         if(bytes > 0){
            console.log(buf.slice(0, bytes).toString());
         }

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

• 运行&输出

$ node ftruncate.js
准备打开文件！
文件打开成功！
截取10字节后的文件内容。
文件截取成功。
读取相同的文件
京东(JD.
文件关闭成功！

删除文件

• 格式

fs.unlink(path, callback)

• 参数

path - 文件路径。
callback - 回调函数，没有参数。

• 代码

var fs = require("fs");

console.log("准备删除文件！");
fs.unlink('output.txt', function (err) {
    if (err) {
        return console.error(err);
    }
    console.log("文件删除成功！");
});

• 运行&输出

$ node file.js 
准备删除文件！
文件删除成功！

创建目录

• 格式

fs.mkdir(path[, mode], callback)

• 参数

path - 文件路径。
mode - 设置目录权限，默认为 0777。
callback - 回调函数，没有参数。

• 代码

var fs = require("fs");

console.log("创建目录 ./test/");
fs.mkdir("./test/",function(err){
   if (err) {
       return console.error(err);
   }
   console.log("目录创建成功。");
});

• 运行&输出

$ node mkdir.js
创建目录 ./test/
目录创建成功。

读取目录

• 格式

fs.readdir(path, callback)

• 参数

path - 文件路径。
callback - 回调函数，回调函数带有两个参数err, files，err 为错误信息，files 为 目录下的文件数组列表。

• 代码

var fs = require("fs");

console.log("查看 ./ 目录");
fs.readdir("./", function (err, files) {
    if (err) {
        return console.error(err);
    }
    files.forEach(function (file) {
        console.log(file);
    });
});

• 运行&输出

$ node readdir.js
查看 ./ 目录
close.js
ftruncate.js
input.txt
mkdir.js
open.js
read.js
readdir.js
stat.js
unlink.js
writeFile.js

删除目录

• 格式

fs.rmdir(path, callback)

• 参数

path - 文件路径。
callback - 回调函数，没有参数。

• 代码

var fs = require("fs");

console.log("准备删除目录 ./test");
fs.rmdir("./test", function (err) {
    if (err) {
        return console.error(err);
    }
});

• 运行&输出

$ node rmdir.js
准备删除目录 ./test

文件模块方法参考手册

OS 模块

一些基本的系统操作函数

https://nodejs.org/dist/latest-v7.x/docs/api/os.htm

• 方法

• 属性

Path 模块

用于处理文件路径

https://nodejs.org/dist/latest-v7.x/docs/api/path.html

• 方法

• 属性

Net 模块

用于底层的网络通信的小工具，包含了创建服务器/客户端的方法

https://nodejs.org/dist/latest-v7.x/docs/api/net.html

• 方法

• net.Server

• net.Socket

代码

https://github.com/hans007/JavaScriptCodes/tree/master/nodejs-do

我的博客