node学习笔记_03 express框架

express api地址：http://www.expressjs.com.cn/starter/static-files.html

一.安装依赖

　　npm i --save express

　　npm i --save ejs (模板引擎)

　　npm i --save jade (模板引擎)

 补充： npm init 命令为你的应用建立一个 package.json 文件

二.进入 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

而后在浏览器中打开 http://localhost:3000/ 并查看输出结果。

三.中间件

http://www.expressjs.com.cn/guide/using-middleware.html

Express 是一个自身功能极简，彻底是由路由和中间件构成一个的 web 开发框架：从本质上来讲，一个 Express 应用就是在调用各类中间件。

中间件（Middleware） 是一个函数，它能够访问请求对象（request object (req)）, 响应对象（response object (res)）, 和 web 应用中处于请求-响应循环流程中的中间件，通常被命名为 next 的变量。

中间件的功能包括：

• 执行任何代码。
• 修改请求和响应对象。
• 终结请求-响应循环。
• 调用堆栈中的下一个中间件。

若是当前中间件没有终结请求-响应循环，则必须调用 next() 方法将控制权交给下一个中间件，不然请求就会挂起。

Express 应用可以使用以下几种中间件：

• 应用级中间件
• 路由级中间件
• 错误处理中间件
• 内置中间件
• 第三方中间件

使用可选则挂载路径，可在应用级别或路由级别装载中间件。另外，你还能够同时装在一系列中间件函数，从而在一个挂载点上建立一个子中间件栈。

应用级中间件

应用级中间件绑定到 app 对象 使用 app.use() 和 app.METHOD()， 其中， METHOD 是须要处理的 HTTP 请求的方法，例如 GET, PUT, POST 等等，所有小写。例如：

var app = express(); // 没有挂载路径的中间件，应用的每一个请求都会执行该中间件 app.use(function (req, res, next) { console.log('Time:', Date.now()); next(); }); // 挂载至 /user/:id 的中间件，任何指向 /user/:id 的请求都会执行它 app.use('/user/:id', function (req, res, next) { console.log('Request Type:', req.method); next(); }); // 路由和句柄函数(中间件系统)，处理指向 /user/:id 的 GET 请求 app.get('/user/:id', function (req, res, next) { res.send('USER'); }); 

下面这个例子展现了在一个挂载点装载一组中间件。

// 一个中间件栈，对任何指向 /user/:id 的 HTTP 请求打印出相关信息 app.use('/user/:id', function(req, res, next) { console.log('Request URL:', req.originalUrl); next(); }, function (req, res, next) { console.log('Request Type:', req.method); next(); }); 

做为中间件系统的路由句柄，使得为路径定义多个路由成为可能。在下面的例子中，为指向 /user/:id 的 GET 请求定义了两个路由。第二个路由虽然不会带来任何问题，但却永远不会被调用，由于第一个路由已经终止了请求-响应循环。

// 一个中间件栈，处理指向 /user/:id 的 GET 请求 app.get('/user/:id', function (req, res, next) { console.log('ID:', req.params.id); next(); }, function (req, res, next) { res.send('User Info'); }); // 处理 /user/:id， 打印出用户 id app.get('/user/:id', function (req, res, next) { res.end(req.params.id); }); 

若是须要在中间件栈中跳过剩余中间件，调用 next('route') 方法将控制权交给下一个路由。 注意： next('route') 只对使用 app.VERB() 或 router.VERB() 加载的中间件有效。

// 一个中间件栈，处理指向 /user/:id 的 GET 请求 app.get('/user/:id', function (req, res, next) { // 若是 user id 为 0, 跳到下一个路由 if (req.params.id == 0) next('route'); // 不然将控制权交给栈中下一个中间件 else next(); // }, function (req, res, next) { // 渲染常规页面 res.render('regular'); }); // 处理 /user/:id， 渲染一个特殊页面 app.get('/user/:id', function (req, res, next) { res.render('special'); }); 

路由级中间件

路由级中间件和应用级中间件同样，只是它绑定的对象为 express.Router()。

var router = express.Router(); 

路由级使用 router.use() 或 router.VERB() 加载。

上述在应用级建立的中间件系统，可经过以下代码改写为路由级：

var app = express(); var router = express.Router(); // 没有挂载路径的中间件，经过该路由的每一个请求都会执行该中间件 router.use(function (req, res, next) { console.log('Time:', Date.now()); next(); }); // 一个中间件栈，显示任何指向 /user/:id 的 HTTP 请求的信息 router.use('/user/:id', function(req, res, next) { console.log('Request URL:', req.originalUrl); next(); }, function (req, res, next) { console.log('Request Type:', req.method); next(); }); // 一个中间件栈，处理指向 /user/:id 的 GET 请求 router.get('/user/:id', function (req, res, next) { // 若是 user id 为 0, 跳到下一个路由 if (req.params.id == 0) next('route'); // 负责将控制权交给栈中下一个中间件 else next(); // }, function (req, res, next) { // 渲染常规页面 res.render('regular'); }); // 处理 /user/:id， 渲染一个特殊页面 router.get('/user/:id', function (req, res, next) { console.log(req.params.id); res.render('special'); }); // 将路由挂载至应用 app.use('/', router); 

错误处理中间件

错误处理中间件有 4 个参数，定义错误处理中间件时必须使用这 4 个参数。即便不须要 next 对象，也必须在签名中声明它，不然中间件会被识别为一个常规中间件，不能处理错误。

错误处理中间件和其余中间件定义相似，只是要使用 4 个参数，而不是 3 个，其签名以下： (err, req, res, next)。

app.use(function(err, req, res, next) { console.error(err.stack); res.status(500).send('Something broke!'); }); 

请参考 错误处理 一章了解更多关于错误处理中间件的内容。

内置中间件

从 4.x 版本开始，, Express 已经再也不依赖 Connect 了。除了 express.static, Express 之前内置的中间件如今已经所有单独做为模块安装使用了。请参考 中间件列表。

express.static(root, [options])

express.static 是 Express 惟一内置的中间件。它基于 serve-static，负责在 Express 应用中提托管静态资源。

参数 root 指提供静态资源的根目录。

可选的 options 参数拥有以下属性。

属性	描述	类型	缺省值
dotfiles	是否对外输出文件名以点（.）开头的文件。可选值为 “allow”、“deny” 和 “ignore”	String	“ignore”
etag	是否启用 etag 生成	Boolean	true
extensions	设置文件扩展名备份选项	Array	[]
index	发送目录索引文件，设置为 false 禁用目录索引。	Mixed	“index.html”
lastModified	设置 Last-Modified 头为文件在操做系统上的最后修改日期。可能值为 true 或 false。	Boolean	true
maxAge	以毫秒或者其字符串格式设置 Cache-Control 头的 max-age 属性。	Number	0
redirect	当路径为目录时，重定向至 “/”。	Boolean	true
setHeaders	设置 HTTP 头以提供文件的函数。	Function

下面的例子使用了 express.static 中间件，其中的 options 对象通过了精心的设计。

var options = { dotfiles: 'ignore', etag: false, extensions: ['htm', 'html'], index: false, maxAge: '1d', redirect: false, setHeaders: function (res, path, stat) { res.set('x-timestamp', Date.now()); } } app.use(express.static('public', options)); 

每一个应用可有多个静态目录。

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

更多关于 serve-static 和其参数的信息，请参考 serve-static 文档。

第三方中间件

经过使用第三方中间件从而为 Express 应用增长更多功能。

安装所需功能的 node 模块，并在应用中加载，能够在应用级加载，也能够在路由级加载。

下面的例子安装并加载了一个解析 cookie 的中间件： cookie-parser

$ npm install cookie-parser

var express = require('express'); var app = express(); var cookieParser = require('cookie-parser'); // 加载用于解析 cookie 的中间件 app.use(cookieParser()); 

请参考 第三方中间件 获取 Express 中常常用到的第三方中间件列表。