摘要：服務(wù)器每收到一條請求，都會用新的和對象觸發(fā)回調(diào)函數(shù)。但不會在回調(diào)函數(shù)被觸發(fā)之前開始對請求體的解析。在調(diào)用完請求回調(diào)函數(shù)之后，就要由你負(fù)責(zé)用方法結(jié)束響應(yīng)了見下圖。比較常見的情況是當(dāng)所請求的資源不存在時返回一個狀態(tài)碼。

本文將通過一個todo list前后端分離的小項目來講解如何用Node創(chuàng)建符合RESTful風(fēng)格的API接口。

我們先來了解下如何用Node創(chuàng)建HTTP服務(wù)器（熟悉的讀者可以直接跳過）。
用Node創(chuàng)建HTTP服務(wù)器是非常方便的，創(chuàng)建HTTP服務(wù)器要調(diào)用http.createServer()函數(shù)，它只有一個參數(shù)，是個回調(diào)函數(shù)，服務(wù)器每次收到HTTP請求后都會調(diào)用這個回調(diào)函數(shù)。這個回調(diào)會收到兩個參數(shù)，請求和響應(yīng)對象，通常簡寫為req和res：

var http = require("http")
var server = http.createServer(function(req, res){
   res.end("Hello World")
})
server.listen(3000, "127.0.0.1")

運行上面的代碼，在瀏覽器中訪問http://localhost:3000。然后你應(yīng)該能看到一個包含“Hello World.”的普通文本頁面。

服務(wù)器每收到一條HTTP請求，都會用新的req和res對象觸發(fā)回調(diào)函數(shù)。
在觸發(fā)回調(diào)函數(shù)之前，Node會解析請求的HTTP頭，并將它們作為req對象的一部分提供給請求回調(diào)。但Node不會在回調(diào)函數(shù)被觸發(fā)之前開始對請求體的解析。這種做法跟某些服務(wù)端框架不同，比如PHP就是在程序邏輯運行前就把請求頭和請求體都解析出來了。

Node不會自動往客戶端寫任何響應(yīng)。在調(diào)用完請求回調(diào)函數(shù)之后，就要由你負(fù)責(zé)用res.end()方法結(jié)束響應(yīng)了（見下圖）。這樣在結(jié)束響應(yīng)之前，你可以在請求的生命期內(nèi)運行任何你想運行的異步邏輯。如果你沒能結(jié)束響應(yīng)，請求會掛起，直到客戶端超時，或者它會一直處于打開狀態(tài)。

搭建HTTP服務(wù)器僅僅是個開始。接下來我們來看看如何設(shè)定響應(yīng)狀態(tài)碼和響應(yīng)頭中的字段，如何正確處理異常。

可以用res.setHeader(field, value)來設(shè)置相應(yīng)的響應(yīng)頭，下面是代碼：

var http = require("http")
var server = http.createServer(function(req, res){
  var body = "
Hello Node
"
  res.setHeader("Content-Length", body.length)
  res.setHeader("Content-Type", "text/html")
  res.end(body)
})
server.listen(3000)

我們經(jīng)常需要返回默認(rèn)狀態(tài)碼200之外的HTTP狀態(tài)碼。比較常見的情況是當(dāng)所請求的資源不存在時返回一個404 Not Found狀態(tài)碼。
這可以通過設(shè)定res.statusCode屬性來實現(xiàn)。在程序響應(yīng)期間可以隨時給這個屬性賦值，但必須在第一次調(diào)用res.write()或res.end()之前。

var http = require("http")
var server = http.createServer(function(req, res) {
  var body = "
頁面丟失了
"
  res.setHeader("Content-Type", "text/html;charset=utf-8")
  res.statusCode = 404
  res.end(body)
})
server.listen(3000, "127.0.0.1")

Node的策略是提供小而強的網(wǎng)絡(luò)API，不同于Rails或Django之類的框架。像會話這種高級概念以及HTTP cookies這樣的基礎(chǔ)組件都沒有包括在Node的內(nèi)核之中。那些都要由第三方模塊提供。

Roy Fielding博士在2000年提出了表征狀態(tài)轉(zhuǎn)移 （REST）。它是一種基于 HTTP 協(xié)議的網(wǎng)絡(luò)應(yīng)用的接口風(fēng)格。
依照規(guī)定，比如GET、POST、PUT和DELETE，分別與資源的獲取、創(chuàng)建、更新和刪除相對應(yīng)。
HTTP 協(xié)議定義了以下8種標(biāo)準(zhǔn)的方法：

GET：請求獲取指定資源。

HEAD：請求指定資源的響應(yīng)頭。

POST：向指定資源提交數(shù)據(jù)。

PUT：請求服務(wù)器存儲一個資源。

DELETE：請求服務(wù)器刪除指定資源。

TRACE：回顯服務(wù)器收到的請求，主要用于測試或診斷。

CONNECT：HTTP/1.1 協(xié)議中預(yù)留給能夠?qū)⑦B接改為管道方式的代理服務(wù)器。

OPTIONS：返回服務(wù)器支持的HTTP請求方法。

創(chuàng)建標(biāo)準(zhǔn)的REST服務(wù)需要實現(xiàn)四個HTTP謂詞。每個謂詞會覆蓋一個操作：

GET：獲取

POST：新增

PUT：更新

DELETE：刪除

接下來，我們開始編寫符合RESTful風(fēng)格的GET和POST接口。

項目決定采用前后端分離，交互數(shù)據(jù)格式約定為json，前端添加的數(shù)據(jù)提交到服務(wù)器后，由服務(wù)器存入服務(wù)器內(nèi)存中。前端界面如下：

首先，我們先編寫前端部分。

前端部分采用當(dāng)今流行的vue.js作為框架，ajax請求采用axios庫。代碼如下：

  
  

  
  





  
Todo List
  

    
{{ item }}
  

  
  button

后端部分將用req.method獲取請求的HTTP謂詞，并分情況對其進(jìn)行處理。代碼如下：

var http = require("http")

var items = []

http.createServer(function(req, res) {
  // 設(shè)置cors跨域
  res.setHeader("Access-Control-Allow-Origin", "*")
  res.setHeader("Access-Control-Allow-Headers", "Content-Type")
  res.setHeader("Content-Type", "application/json")

  switch (req.method) {
    // 設(shè)置了cors跨域
    // post請求時，瀏覽器會先發(fā)一次options請求，如果請求通過，則繼續(xù)發(fā)送正式的post請求
    case "OPTIONS":
      res.statusCode = 200
      res.end()
      break

    case "GET":
      let data = JSON.stringify(items)
      res.write(data)
      res.end()
      break

    case "POST":
      let item = ""
      req.on("data", function (chunk) {
        item += chunk
      })
      req.on("end", function () {
        // 存入
        item = JSON.parse(item)
        items.push(item.item)
        // 返回到客戶端
        let data = JSON.stringify(items)
        res.write(data)
        res.end()
      })
      break
  }
}).listen(3000)

console.log("http server is start...")

當(dāng)然，一個完整的RESTful服務(wù)還應(yīng)該實現(xiàn)PUT謂詞和DELETE謂詞，如果你真的讀懂了本文，那么相信這對你已經(jīng)不再是問題了。