學習nodejs：express 入門和基礎知識

本章為大家介紹學習nodejs：express 入門與基礎知識。那麼什麼是express，express 是一個自身功能極簡，完全是由路由和中間件構成一個的 web 開發框架：從本質上來說，一個express 應用就是在呼叫各種中間件。有一定的參考價值，有需要的朋友可以參考一下，希望對你有幫助。

初始化

新目錄myapp，專案初始化

$ npm init

安裝express

$ npm install express --save

#建立一個hello world實例

進入myapp目錄，建立一個名為app.js

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

app.get('/', function(req, res) {
	res.send('Hello World!');
});

var server = app.listen(3000, function() {
	var host = server.address().address;
	var port = server.address().port;

	console.log('Example app listening at http://%s:%s', host, port);
});

上面的程式碼啟動一個服務並監聽從3000 端口進入的所有連線請求。他將對所有 (/) URL 或 路由 傳回 “Hello World!” 字串。對於其他所有路徑全部傳回 404 Not Found。

透過以下命令列啟動

$ node app.js

express生成器

透過應用程式產生器工具express 可以快速建立一個應用的骨架。

1.安裝以下指令

$ npm install express-generator -g

2.在目前目錄建立myapp的應用，執行下列指令

$ express myapp
$ cd myapp 
$ npm install> set DEBUG=myapp & npm start

透過Express 應用程式產生器所建立的應用程式一般都有如下目錄結構：

├── app.js
├── bin
│   └── www
├── package.json
├── public
│   ├── images
│   ├── javascripts
│   └── stylesheets
│       └── style.css
├── routes
│   ├── index.js
│   └── users.js
└── views
    ├── error.jade
    ├── index.jade
    └── layout.jade

7 directories, 9 files

express路由

路由（Routing）是由一個URI（或叫路徑）和一個特定的 HTTP 方法（ GET、POST 等）組成的，涉及應用如何回應客戶端對某個網站節點的存取。每一個路由都可以有一個或多個處理器函數，當配對到路由時，這個/些函數將會被執行。

路由的定義由以下結構組成：app.METHOD(PATH, HANDLER)。其中，app 是一個 express 實例；METHOD 是某個 HTTP 請求方式中的一個；PATH 是伺服器端的路徑；HANDLER 是當路由匹配到時需要執行的函數。

以下是一些常見的路由程式碼：

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

// respond with "hello world" when a GET request is made to the homepage
app.get('/', function(req, res) {
  res.send('hello world');
});

// POST method route
app.post('/', function (req, res) {
  res.send('POST request to the homepage');
});
//app.all() 是一个特殊的路由方法，没有任何 HTTP 方法与其对应，它的作用是对于一个路径上的所有请求加载中间件。
app.all('/secret', function (req, res, next) {
  console.log('Accessing the secret section ...');
  next(); // pass control to the next handler
});

使用字串模式的路由路徑範例：字元?、 、* 和() 是正規表示式的子集，- 和. 在基於字串的路徑中按照字面值解釋。

// 匹配 acd 和 abcd
app.get('/ab?cd', function(req, res) {
  res.send('ab?cd');
});

// 匹配 abcd、abbcd、abbbcd等
app.get('/ab+cd', function(req, res) {
  res.send('ab+cd');
});

// 匹配 abcd、abxcd、abRABDOMcd、ab123cd等
app.get('/ab*cd', function(req, res) {
  res.send('ab*cd');
});

// 匹配 /abe 和 /abcde
app.get('/ab(cd)?e', function(req, res) {
 res.send('ab(cd)?e');
});

//使用正则表达式的路由路径示例：
// 匹配任何路径中含有 a 的路径：
app.get(/a/, function(req, res) {
  res.send('/a/');
});

// 匹配 butterfly、dragonfly，不匹配 butterflyman、dragonfly man等
app.get(/.*fly$/, function(req, res) {
  res.send('/.*fly$/');
});

路由句柄

可以為請求處理提供多個回呼函數，其行為類似 中介軟體。唯一的差異是這些回呼函數有可能呼叫 next('route') 方法而略過其他路由回呼函數。

路由句柄有多種形式，可以是一個函數、一個函數數組，或是兩者混合，如下：

//使用多个回调函数处理路由（记得指定 next 对象）：
app.get('/example/b', function (req, res, next) {
  console.log('response will be sent by the next function ...');
  next();
}, function (req, res) {
  res.send('Hello from B!');
});

//使用回调函数数组处理路由：
var cb0 = function (req, res, next) {
  console.log('CB0');
  next();
}
var cb1 = function (req, res, next) {
  console.log('CB1');
  next();
}
var cb2 = function (req, res) {
  res.send('Hello from C!');
}
app.get('/example/c', [cb0, cb1, cb2]);

回應方法

下表中回應物件（res）的方法向客戶端回傳回應，終結請求回應的循環。如果在路由句柄中一個方法也不調用，來自客戶端的請求會一直掛起。

方法 描述：
   res.download() 提示下載檔案。
   res.end() 終結回應處理流程。
   res.JSON() 傳送一個 JSON 格式的回應。
   res.jsonp() 傳送一個支援 JSONP 的 JSON 格式的回應。
   res.redirect() 重定向請求。
   res.render() 渲染視圖範本。
   res.send() 發送各種類型的回應。
   res.sendFile 以八位元位元組流的形式傳送檔案。
   res.sendStatus() 設定回應狀態碼，並將其以字串形式作為回應體的一部分傳送。

app.route()

可使用 app.route() 建立路由路徑的鍊式路由句柄。由於路徑在一個地方指定，這樣做有助於創建模組化的路由，而且減少了程式碼冗餘和拼寫錯誤。

app.route('/book')
  .get(function(req, res) {    res.send('Get a random book');
  })
  .post(function(req, res) {    res.send('Add a book');
  })
  .put(function(req, res) {    res.send('Update the book');
  });

express.Router

#可使用 express.Router 類別建立模組化、可掛載的路由句柄。 Router 實例是一個完整的中間件和路由系統，因此常稱其為一個 “mini-app”。

在app 目錄下建立名為birds.js 的文件，內容如下：

var express = require('express');
var router = express.Router();
// 该路由使用的中间件
router.use(
	function timeLog(req, res, next) {
		console.log('Time: ', Date.now());
		next();
	});
// 定义网站主页的路由
router.get('/', function(req, res) {
	res.send('Birds home page');
});
// 定义 about 页面的路由
router.get('/about', function(req, res) {
	res.send('About birds');
});
module.exports = router;

然後在應用程式中載入路由模組：

var birds = require('./birds');
...
app.use('/birds', birds);

應用程式即可處理髮自/birds 和/birds/about 的請求，並且呼叫為該路由指定的timeLog 中間件。

利用Express 託管靜態檔案

透過Express 內建的express.static 可以方便地託管靜態文件，例如圖片、CSS、JavaScript 文件等。

將靜態資源檔案所在的目錄作為參數傳遞給 express.static 中間件就可以提供靜態資源檔案的存取權了。例如，假設在 public 目錄放置了圖片、CSS 和 JavaScript 文件，你就可以：

app.use(express.static('public'));

現在，public 目錄下面的文件就可以存取了。

http://localhost:3000/images/kitten.jpg
http://localhost:3000/css/style.css
http://localhost:3000/js/app.js
http://localhost:3000/images/bg.png
http://localhost:3000/hello.html

如果你的靜態資源存放在多個目錄下面，你可以多次呼叫 express.static 中介軟體：

app.use(express.static('public'));
app.use(express.static('files'));

如果你希望所有通过 express.static 访问的文件都存放在一个“虚拟（virtual）”目录（即目录根本不存在）下面，可以通过为静态资源目录指定一个挂载路径的方式来实现，如下所示：

app.use('/static', express.static('public'));

现在，你就爱可以通过带有 “/static” 前缀的地址来访问 public 目录下面的文件了。

http://localhost:3000/static/images/kitten.jpg
http://localhost:3000/static/css/style.css
http://localhost:3000/static/js/app.js
http://localhost:3000/static/images/bg.png
http://localhost:3000/static/hello.html

常见问题

如何处理 404 ？

在 Express 中，404 并不是一个错误（error）。因此，错误处理器中间件并不捕获 404。这是因为 404 只是意味着某些功能没有实现。也就是说，Express 执行了所有中间件、路由之后还是没有获取到任何输出。你所需要做的就是在其所有他中间件的后面添加一个处理 404 的中间件。如下：

app.use(function(req, res, next) {  
res.status(404).send('Sorry cant find that!');
});

Express 支持哪些模板引擎？

Express 支持任何符合 (path, locals, callback) 接口规范的模板引擎。

如何渲染纯 HTML 文件？

不需要！无需通过 res.render() 渲染 HTML。你可以通过 res.sendFile() 直接对外输出 HTML 文件。如果你需要对外提供的资源文件很多，可以使用 express.static() 中间件。

以上是學習nodejs：express 入門和基礎知識的詳細內容。更多資訊請關注PHP中文網其他相關文章！