本週的專案進度比較零散(老實說一向如此),所以筆記就照情境拆成兩篇寫。這篇記錄的是 Node 學習心得,另一篇則是專案裡累積到的 Web 前端知識。
Node 的 HTTP 模組早在第一篇就已經碰過,這次來把書中範例出現過的 API 仔細看一遍。
var qs = require('querystring');
require('http').createServer(function(req, res){
if('/' == req.url){
res.writeHead(200, {'Content-Type': 'text/html'});
res.end([
'<form method="POST" action="/url">',
'<h1>My form</h1>',
'<fieldset>',
'<label>Personal information</label>',
'<p>What is your name?</p>',
'<input type="text" name="name">',
'<p><button>Submit</button></p>',
'</form>',
].join(''));
}else if('/url' == req.url && 'POST' == req.method){
var body = '';
req.on('data', function(chunk){
body += chunk;
});
req.on('end', function(){
res.writeHead(200, {'Content-Type': 'text/html'});
res.end('<b>Your name is <b>' + qs.parse(body).name + '</b></p>');
});
}else{
res.writeHead(404);
res.end('not found');
}
}).listen(3000);
它的參數是一個回呼函式 function(req, res)。其中 req(請求)是 http.IncomingMessage 的實例,res(回應)則是 http.ServerResponse 的實例。
範例裡用到了 url、method 兩個字串屬性。顧名思義,url 記錄的是 HTTP 位址中主機名之後的所有內容,method 則是請求使用的方法(GET、POST 等)。
用來送出一個 HTTP 回應標頭。這個方法只會在標頭即將送出時被呼叫一次,而且必須排在 end 這類方法之前。如果順序顛倒——先呼叫了 write(chunk, [encoding]) 或 end([data], [encoding])——系統會自動補上一個「不太理想」的預設標頭內容並送出,之後再呼叫 writeHead 就沒有意義了。
用來告訴伺服器:回應內容已經全部送完。所以每次回應結束前都必須呼叫它。若呼叫時帶了參數,這個方法就等同於連續執行 write('內容', [encoding]) 與 end(),寫起來相當省事。
範例透過 req.on 監聽事件並綁在 req 物件上。它的原型是 emitter.on(event, listener):req 是產生事件的主體,而在監聽函式中,this 會指向該監聽器所關聯的 EventEmitter 物件。
這裡其實藏著 Node 處理請求體的關鍵思維:POST 的內容不會一次到齊,而是被切成一個個 chunk 分批送來,所以要用 data 事件逐段收集,等到 end 事件觸發時,才代表資料完整、可以進行解析。範例正是靠 querystring 把拼好的字串轉成物件,取出其中的 name 欄位。