Node.js 框架 express 4.X API 中文手冊【express()篇】

Node.js 框架 express 4.X API 中文手冊【express()篇】

波多馬克河畔 前端先鋒

原創做者：波多馬克河畔，京程一燈特邀做者
波多馬克河畔，留學海外對編程充滿熱情的高中生

寫過 node.js 應用的小夥伴們應該都知道 express 應用框架，它讓咱們在開發時候的路由設計簡化，直接方便咱們快速的開發，然而，由於版本更新的太快，致使像這類的API都沒什麼人願意去翻譯，哪怕翻譯出來一段時間後，新的API又出來了。因而乎間接的讓許多英語很差的小夥伴都不能好好的玩耍了。

express 5 overview
做爲一名身在海外的高中生，爲了提高英語閱讀（我剛出來時候英語真的不咋的，但只有讀纔是提高閱讀水平的最好方法），我也只好好好的翻譯翻譯啦~ 除了爲幫助本身，也間接幫助一些須要中文API的小夥伴們。
該 Express 4.X 中文手冊我講以官網的目錄形式來發布文章，共5章，分別爲：

express()
Application
Reques
Response
Router

Express's menu
若是有什麼翻譯不對的地方~ 歡迎在下方評論告訴我奧~ enjoy your express API.

---

express()

創建一個Express的應用程序，express() 函數是一個由express模型導出的高級入口函數。

var express = require('express');
var app = express();

---

方法：
express.static(root, [options])
express.static 函數是Express中惟一一個內置的中間件 (middleware) 函數。該函數提供了靜態文件功能並基於server-static開發。
其中，root 參數是指向須要提供靜態資源服務的根目錄，須要提供的靜態文件將會經過req.url 和提供的根目錄的組合來肯定。當一個文件找不到時，該模型不會發送404響應，而是將其代替爲調用 next() 來移動到下一個中間件，並容許堆積與後退。
下面的表格描述了 options 可選對象的屬性。

options of express.static()

dotfiles

該選項可能用到的值有：

「 allow 」 - 不特別處理點文件
" deny " - 拒絕點文件的請求，用403響應，而後調用 next();
「 ignore 」 - 若是dotfile不存在，用404響應，而後調用 next();

注意：使用默認值時，它將不會忽視以點開頭的文件或者文件夾。

---

fallthrough
當該選項爲 true 時，客戶端的錯誤例如一個很差的請求或者一個不存在文件的請求都將致使這個中間件去簡單的調用 next() 來調用棧中的下一個中間件。當該選項爲 false 時，這些錯誤（甚至是404錯誤）都將調用 next(err)。
將此選項的值設置爲 true 以便於你能夠將多個物理目錄映射到同一個Web地址或路由以填充不存在的文件。
若是已將此中間件安裝在嚴格爲單個文件系統目錄的路徑上，則可使用false。這樣容許讓404短路從而減小開銷。 這個中間件也將回復全部的方法。

---

setHeaders
對於該選項，請指定一個函數去設置自定義響應標頭。 對標頭的更改必須同步進行。
該函數的簽名爲：

fn ( res, path, stat );

參數：

res, 響應的對象
path, 要發送的文件路勁
stat, 要發送的文件的 stat 對象

---

express.Router([options])
建立一個新的路由對象
var router = express.Router( [ options ] );
下表中的可選 options 參數指定了路由器的行爲:

options of express.Router()你能夠像路由應用同樣向路由器中添加中間件和HTTP方法路由（例如 get，put，post 等方法）。