node_02 基本模块

$\color{red}{fs}$
Node.js内置的fs模块就是文件系统模块，负责 $\color{purple}{读写文件}$ 。
和所有其它JavaScript模块不同的是，fs模块同时提供了 $\color{purple}{异步}$ 和 $\color{purple}{同步}$ 的方法。
回顾一下什么是异步方法。因为JavaScript的单线程模型，执行IO操作时，JavaScript代码无需等待，而是传入回调函数后，继续执行后续JavaScript代码。比如jQuery提供的getJSON()操作：例子（本地請求有跨域問題，建議自己寫一個接口）

    $.getJSON('https://example.com/ajax',function(data){
        console.log('IO結果返回後執行')
    })
    console.log('不等待IO結果直接執行後續代碼')
    結果：
        console.log('不等待IO結果直接執行後續代碼')
        console.log('IO結果返回後執行')

而同步的IO操作则需要等待函数返回：
同步操作的好处是代码简单，缺点是程序将等待IO操作，在等待时间内，无法响应其它任何事件。而异步读取不用等待IO操作，但代码较麻烦。

$\color{orange}{异步读文件}$

按照JavaScript的标准，异步读取一个文本文件的代码如下：
$\color{red}{腳本}$ (index6.js)

    'use strict'
    var fs = require('fs');
    fs.readFile('./text.text','utf-8',function(err,data){
        if(err){
            console.log(err);
        }else{
            console.log(data)
        }
    })

$\color{red}{腳本}$ (text.text)

    666
    console.log(888)

index4.png

$\color{red}{腳本}$ (index8.js)

    'use strict'

    var fs = require('fs');
    fs.readFile('./image/index5.png',function(err,data){   (圖片自找,屬於二進制，返回buffer對象)
        if(err){
            console.log(err)
        }else{
            console.log(data);
            console.log(data.length + 'bytes')
        }
      // var text = data.toString('utf-8');  把一个Buffer对象转换成String
      // console.log(text);
      // var buf = Buffer.from(text, 'utf-8');  把一个String转换成Buffer：
      // console.log(buf);
    })

index4.png

$\color{orange}{同步读文件}$

除了标准的异步读取模式外，fs也提供相应的同步读取函数。同步读取的函数和异步函数相比，多了一个Sync后缀，并且 $\color{red}{不接收回调函数}$ ，函数直接返回结果。
用fs模块同步读取一个文本文件的代码如下：

    'use strict'
    var fs = require('fs');
    var data = fs.readFileSync('text.text','utf-8');
    console.log(data)

index4.png

如果同步读取文件发生错误，则需要用try...catch捕获该错误：
$\color{red}{正確腳本}$

    'use strict'
    var fs = require('fs')
    try{
        var data = fs.readFileSync('text.text','utf-8')
        console.log(data)
    }catch(err){
        console.log(err+"666")
    }

$\color{red}{錯誤腳本}$

    'use strict'
    var fs = require('fs')
    try{
        var data = fs.readFileSync('text.tex','utf-8') //<-.text.text
        console.log(data)
    }catch(err){
        console.log(err+"666")
    }

index4.png

$\color{orange}{写文件}$

$\color{red}{腳本}$ (index11.js)

    'use strict'

    var fs = require('fs')

    var data = 'Hello, Node.js'
    var read = fs.readFileSync('text.text','utf-8')
    console.log(read)
    fs.writeFile('text.text',data,function(err){    //文件、數據、回調
        if(err){
            console.log(err)
        }else{
            read = fs.readFileSync('text.text','utf-8')
            console.log('ok')
            console.log(read)
        }
    })

index4.png

writeFileSync()和readFileSync()一樣；

$\color{orange}{stat}$

如果我们要获取文件大小，创建时间等信息，可以使用fs.stat()，它返回一个Stat对象，能告诉我们文件或目录的详细信息：

    'use strit'

    var fs = require('fs')

    var date = fs.stat('text.text',function(err,stat){
        if(err){
            console.log(err)
        }else{
            //是否文件
            console.log('isFile:' + stat.isFile())
            //是否目錄
            console.log('isDirectory:' + stat.isDirectory())
            if(stat.isFile()){
                //文件大小
                console.log('size:'+stat.size);
                //創建事件,Date對象
                console.log('birth time:' + stat.birthtime)
                //修改事件，Date對象
                console.log('modified time:' + stat.mtime)
            }
        }
    })

index4.png

stat()也有一个对应的同步函数statSync()，请试着改写上述异步代码为同步代码。

异步还是同步
在fs模块中，提供同步方法是为了方便使用。那我们到底是应该用异步方法还是同步方法呢？

由于Node环境执行的JavaScript代码是服务器端代码，所以，绝大部分需要在服务器运行期反复执行业务逻辑的代码，必须使用异步代码，否则，同步代码在执行时期，服务器将停止响应，因为JavaScript只有一个执行线程。

服务器启动时如果需要读取配置文件，或者结束时需要写入到状态文件时，可以使用同步代码，因为这些代码只在启动和结束时执行一次，不影响服务器正常运行时的异步执行。