您好,欢迎访问一九零五行业门户网

express框架入门学习知识点总结

前面的话express是一个简洁、灵活的 node.js web 应用开发框架, 它提供一系列强大的特性,帮助开发者创建各种 web 和移动设备应用。本文将详细介绍express框架
概述官网对express的描述,它是一个基于 node.js 平台,快速、开放、极简的 web 开发框架。优点是易上手、高性能、扩展性强
1、易上手:nodejs最初就是为了开发高性能web服务器而被设计出来的,然而相对底层的api会让不少新手望而却步。express对web开发相关的模块进行了适度的封装,屏蔽了大量复杂繁琐的技术细节,让开发者只需要专注于业务逻辑的开发,极大的降低了入门和学习的成本
2、高性能:express仅在web应用相关的nodejs模块上进行了适度的封装和扩展,较大程度避免了过度封装导致的性能损耗
3、扩展性强:基于中间件的开发模式,使得express应用的扩展、模块拆分非常简单,既灵活,扩展性又强
【安装】
安装express前,首先安装nodejs,接下来为应用创建一个目录,然后进入此目录并将其作为当前工作目录
$ mkdir myapp $ cd myapp
通过 npm init 命令为应用创建一个 package.json 文件
$ npm init
此命令要求输入几个参数,例如应用的名称和版本。 直接按“回车”键接受默认设置即可,下面这个除外:
entry point: (index.js)
键入 app.js 或者所希望的名称,这是当前应用的入口文件。如果希望采用默认的 index.js 文件名,只需按“回车”键即可
接下来安装 express 并将其保存到依赖列表中:
$ npm install express --save
如果只是临时安装 express,不想将它添加到依赖列表中,只需略去 --save 参数即可:
$ npm install express
入门实例在项目根目录下,新建一个启动文件,假定叫做index.js,新建一个public文件夹,并在public目录下,新建index.html
var express = require('express');var app = express(); app.use(express.static(__dirname + '/public')); app.listen(8080);
运行index.js后,访问http://localhost:8080,它会在浏览器中打开public目录的index.html文件
当然,也可以在index.js之中,生成动态网页
// index.jsvar express = require('express');var app = express(); app.get('/', function (req, res) {   res.send('hello world!'); }); app.listen(3000);
运行index.js文件后,会在本机的3000端口启动一个网站,网页显示hello world
启动脚本index.js的app.get方法,用于指定不同的访问路径所对应的回调函数,这叫做“路由”(routing)。上面代码只指定了根目录的回调函数,因此只有一个路由记录。实际应用中,可能有多个路由记录
var express = require('express');var app = express(); app.get('/', function (req, res) {   res.send('hello world!'); }); app.get('/customer', function(req, res){   res.send('customer page'); }); app.get('/admin', function(req, res){   res.send('admin page'); }); app.listen(3000);
这时,最好就把路由放到一个单独的文件中,比如新建一个routes子目录
// routes/index.jsmodule.exports = function (app) {   app.get('/', function (req, res) {     res.send('hello world');   });   app.get('/customer', function(req, res){     res.send('customer page');   });   app.get('/admin', function(req, res){     res.send('admin page');   }); };
然后,原来的index.js就变成下面这样
// index.jsvar express = require('express');var app = express();var routes = require('./routes')(app); app.listen(3000);
路由
         当用get请求访问一个网址的时候,做什么事情:
    app.get(网址,function(req,res){2        3    });
当用post访问一个网址的时候,做什么事情:
    app.post(网址,function(req,res){2        3    });
如果想处理这个网址的任何method的请求,那么写all
    app.all(/,function(){2        3    });
这里的网址,不分大小写,也就是说,你路由是
    app.get(/aab,function(req,res){2        res.send(你好);3    });
中间件
        如果我的的get、post回调函数中,没有next参数,那么就匹配上第一个路由,就不会往下匹配了。
        如果想往下匹配的话,那么需要写next()
app.get(/,function(req,res,next){2        console.log(1);3        next();4    });5    6    app.get(/,function(req,res){7        console.log(2);8    });
路由get、post这些东西,就是中间件,中间件讲究顺序,匹配上第一个之后,就不会往后匹配了。next函数才能够继续往后匹配。      
       app.use()也是一个中间件。与get、post不同的是,他的网址不是精确匹配的。而是能够有小文件夹拓展的。
       比如网址:  http://127.0.0.1:3000/admin/aa/bb/cc/dd
app.use(/admin,function(req,res){
        res.write(req.originalurl + \n);   //    /admin/aa/bb/cc/dd3        res.write(req.baseurl + \n);  //   /admin4        res.write(req.path + \n);   //    /aa/bb/cc/dd5        res.end(你好);6    });
● 大多数情况下,渲染内容用res.render(),将会根据views中的模板文件进行渲染。如果不想使用views文件夹,想自己设置文件夹名字,那么app.set(views,aaaa);
      ● 如果想写一个快速测试页,当然可以使用res.send()。这个函数将根据内容,自动帮我们设置了content-type头部和200状态码。send()只能用一次,和end一样。和end不一样在哪里?能够自动设置mime类型。
      ● 如果想使用不同的状态码,可以:
              res.status(404).send('sorry, we cannot find that!');
      ● 如果想使用不同的content-type,可以:
              res.set('content-type', 'text/html');
生成器通过应用生成器工具 express 可以快速创建一个应用的骨架
[注意]一定要使用全局模式安装express-generator,否则无法使用express命令
$ npm install express-generator -g
-h 选项可以列出所有可用的命令行选项:
$ express -h   usage: express [options] [dir]   options:-h, --help          output usage information-v, --version       output the version number-e, --ejs           add ejs engine support (defaults to jade)--hbs           add handlebars engine support-h, --hogan         add hogan.js engine support-c, --css <engine>  add stylesheet <engine> support (less|stylus|compass|sass) (defaults to plain css)--git           add .gitignore-f, --force         force on non-empty directory
例如,下面的示例就是在当前工作目录下创建一个命名为 myapp 的应用
$ express myapp    create : myapp    create : myapp/package.json    create : myapp/app.js    create : myapp/public    create : myapp/public/javascripts    create : myapp/public/images    create : myapp/routes    create : myapp/routes/index.js    create : myapp/routes/users.js    create : myapp/public/stylesheets    create : myapp/public/stylesheets/style.css    create : myapp/views    create : myapp/views/index.jade    create : myapp/views/layout.jade    create : myapp/views/error.jade    create : myapp/bin    create : myapp/bin/www
然后安装所有依赖包:
$ cd myapp  $ npm instal
启动这个应用(macos 或 linux 平台):
$ debug=myapp npm start
windows 平台使用如下命令:
> set debug=myapp & npm start
然后在浏览器中打开 http://localhost:3000/ 网址就可以看到这个应用了。i
通过 express 应用生成器创建的应用一般都有如下目录结构:
. ├── app.js ├── bin │   └── www ├── package.json ├── public │   ├── images │   ├── javascripts │   └── stylesheets │       └── style.css ├── routes │   ├── index.js │   └── users.js └── views     ├── error.jade     ├── index.jade     └── layout.jade7 directories, 9 files
http模块express框架建立在node.js内置的http模块上。http模块生成服务器的原始代码如下
var http = require(http);var app = http.createserver(function(request, response) {   response.writehead(200, {content-type: text/plain});   response.end(hello world!); }); app.listen(3000, localhost);
上面代码的关键是http模块的createserver方法,表示生成一个http服务器实例。该方法接受一个回调函数,该回调函数的参数,分别为代表http请求和http回应的request对象和response对象。
express框架的核心是对http模块的再包装。上面的代码用express改写如下
var express = require('express');var app = express(); app.get('/', function (req, res) {   res.send('hello world!'); }); app.listen(3000);
比较两段代码,可以看到它们非常接近。原来是用http.createserver方法新建一个app实例,现在则是用express的构造方法,生成一个epress实例。两者的回调函数都是相同的。express框架等于在http模块之上,加了一个中间层
中间件【概述】
express 是一个自身功能极简,完全是由路由和中间件构成一个的 web 开发框架:从本质上来说,一个 express 应用就是在调用各种中间件
简单说,中间件(middleware)就是处理http请求的函数。它最大的特点就是,一个中间件处理完,再传递给下一个中间件。app实例在运行过程中,会调用一系列的中间件
每个中间件可以从app实例,接收三个参数,依次为request对象(代表http请求)、response对象(代表http回应),next回调函数(代表下一个中间件)。每个中间件都可以对http请求(request对象)进行加工,并且决定是否调用next方法,将request对象再传给下一个中间件
中间件的功能包括:1、执行任何代码;2、修改请求和响应对象;3、终结请求-响应循环;4、调用堆栈中的下一个中间件
如果当前中间件没有终结请求-响应循环,则必须调用 next() 方法将控制权交给下一个中间件,否则请求就会挂起
一个不进行任何操作、只传递request对象的中间件,就是下面这样
function uselessmiddleware(req, res, next) {   next(); }
上面代码的next就是下一个中间件。如果它带有参数,则代表抛出一个错误,参数为错误文本
function uselessmiddleware(req, res, next) {   next('出错了!'); }
抛出错误以后,后面的中间件将不再执行,直到发现一个错误处理函数为止
【分类】
express 应用可使用如下几种中间件:1、应用级中间件;2、路由级中间件;3、错误处理中间件;4、内置中间件;5、第三方中间件
1、应用级中间件绑定到 app 对象 使用 app.use() 和 app.method(),其中, method 是需要处理的 http 请求的方法,例如 get, put, post 等等,全部小写
2、路由级中间件绑定的对象为 express.router()
3、错误处理中间件和其他中间件定义类似,只是要使用 4 个参数,而不是 3 个,其签名如下: (err, req, res, next)
app.use(function(err, req, res, next) {   console.error(err.stack);   res.status(500).send('something broke!'); });
4、express.static 是 express 唯一内置的中间件。它基于 serve-static,负责在 express 应用中提托管静态资源
5、通过使用第三方中间件从而为 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());
【use方法】
use是express注册中间件的方法,它返回一个函数。下面是一个连续调用两个中间件的例子
var express = require(express);var http = require(http);var app = express(); app.use(function(request, response, next) {   console.log(in comes a  + request.method +  to  + request.url);   next(); }); app.use(function(request, response) {   response.writehead(200, { content-type: text/plain });   response.end(hello world!\n); }); http.createserver(app).listen(1337);
上面代码使用app.use方法,注册了两个中间件。收到http请求后,先调用第一个中间件,在控制台输出一行信息,然后通过next方法,将执行权传给第二个中间件,输出http回应。由于第二个中间件没有调用next方法,所以request对象就不再向后传递了。
use方法内部可以对访问路径进行判断,据此实现简单的路由,根据不同的请求网址,返回不同的网页内容
var express = require(express);var http = require(http);var app = express(); app.use(function(request, response, next) {  if (request.url == /) {     response.writehead(200, { content-type: text/plain });     response.end(welcome to the homepage!\n);   } else {     next();   } }); app.use(function(request, response, next) {  if (request.url == /about) {     response.writehead(200, { content-type: text/plain });   } else {     next();   } }); app.use(function(request, response) {   response.writehead(404, { content-type: text/plain });   response.end(404 error!\n); }); http.createserver(app).listen(1337);
上面代码通过request.url属性,判断请求的网址,从而返回不同的内容。注意,app.use方法一共登记了三个中间件,只要请求路径匹配,就不会将执行权交给下一个中间件。因此,最后一个中间件会返回404错误,即前面的中间件都没匹配请求路径,找不到所要请求的资源。
除了在回调函数内部判断请求的网址,use方法也允许将请求网址写在第一个参数。这代表,只有请求路径匹配这个参数,后面的中间件才会生效。无疑,这样写更加清晰和方便
app.use('/path', somemiddleware);
上面代码表示,只对根目录的请求,调用某个中间件。
因此,上面的代码可以写成下面的样子
var express = require(express);var http = require(http);var app = express(); app.use(/home, function(request, response, next) {   response.writehead(200, { content-type: text/plain });   response.end(welcome to the homepage!\n); }); app.use(/about, function(request, response, next) {   response.writehead(200, { content-type: text/plain });   response.end(welcome to the about page!\n); }); app.use(function(request, response) {   response.writehead(404, { content-type: text/plain });   response.end(404 error!\n); }); http.createserver(app).listen(1337);
托管静态资源上面介绍了, express.static 是 express 唯一内置的中间件,负责在 express 应用中提托管静态资源,例如图片、css、javascript 文件等
express.static(root, [options])
参数 root 指提供静态资源的根目录,可选的 options 参数拥有如下属性
属性        类型      缺省值 描述 dotfiles    string   “ignore” 是否对外输出文件名以点开头的文件。可选值为allow、deny和ignore etag        boolean   true 是否启用 etag 生成 extensions  array    [] 设置文件扩展名备份选项 index          mixed    “index.html” 发送目录索引文件,设置为 false 禁用目录索引。 lastmodified    boolean  true  设置last-modified头为文件在操作系统上的最后修改日期。可选值为true或falsemaxage          number   0 以毫秒或者其字符串格式设置 cache-control 头的 max-age 属性。 redirect        boolean  true 当路径为目录时,重定向至 “/”。 setheaders      function      设置 http 头以提供文件的函数。
var options = {   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));
一般地,如果不需要特殊的设置,将静态资源文件所在的目录作为参数传递给 express.static 中间件就可以提供静态资源文件的访问了。例如,假设在 public 目录放置了图片、css 和 javascript 文件
app.use(express.static('public'));
现在,public 目录下面的文件就可以访问了
http://localhost:3000/images/kitten.jpghttp://localhost:3000/css/style.csshttp://localhost:3000/js/app.jshttp://localhost:3000/images/bg.pnghttp://localhost:3000/hello.html
如果静态资源存放在多个目录下面,可以多次调用 express.static 中间件:
app.use(express.static('public')); app.use(express.static('files'));
访问静态资源文件时,express.static 中间件会根据目录添加的顺序查找所需的文件。
如果希望所有通过 express.static 访问的文件都存放在一个“虚拟(virtual)”目录(即目录根本不存在)下面,可以通过为静态资源目录指定一个挂载路径的方式来实现,如下所示:
app.use('/static', express.static('public'));
现在,可以通过带有 “/static” 前缀的地址来访问 public 目录下面的文件了
http://localhost:3000/static/images/kitten.jpghttp://localhost:3000/static/css/style.csshttp://localhost:3000/static/js/app.jshttp://localhost:3000/static/images/bg.pnghttp://localhost:3000/static/hello.html
常用中间件【cookie-parser()】
用于解析cookie的中间件,添加中间后,req具备cookies属性。通过req.cookies.xxx可以访问cookie的值
$ npm install cookie-parser

var cookieparser = require('cookie-parser') app.use(cookieparser(secret, options))
secret 是可选参数,用于对cookie进行签名 ,通过它可以判断出客户是否修改了cookie,这是处于安全考虑,这个参数是任意字符串
options 可选参数,是一个json对象,可选项包括path、expires、maxage、domain、secure、httponly
var express      = require('express')var cookieparser = require('cookie-parser')  var app = express() app.use(cookieparser())   app.get('/', function(req, res) {   console.log('cookies: ', req.cookies) })   app.listen(8080)
【express-session】
session运行在服务器端,当客户端第一次访问服务器时,可以将客户的登录信息保存。 当客户访问其他页面时,可以判断客户的登录状态,做出提示,相当于登录拦截。session可以和redis或者数据库等结合做持久化操作,当服务器挂掉时也不会导致某些客户信息(购物车)丢失。
当浏览器访问服务器并发送第一次请求时,服务器端会创建一个session对象,生成一个类似于key,value的键值对, 然后将key(cookie)返回到浏览器(客户)端,浏览器下次再访问时,携带key(cookie),找到对应的session(value)。客户的信息都保存在session中
$ npm install express-session
var express = require('express')var session = require('express-session')var app = express() app.use(session(options))
options 常用选项如下:
name - 默认'connect.sid',可自定义
store - session 储存器实例
secret - 用于对cookie进行签名 ,通过它可以判断出客户是否修改了cookie,这是处于安全考虑,这个参数是任意字符串
cookie - 对session cookie的设置 。默认值 { path: '/', httponly: true, secure: false, maxage: null }
genid -  是个函数,调用它来生成一个新的会话id。 (默认:使用uid2库)
rolling -  强制对每个响应的cookie,重置到期日期。 (默认:false)
resave - 每一次都重新保存,即使没修改过(默认:true)
proxy - ture/false,是否支持trust proxy,,需要设置 app.enable('trust proxy');一般来说,无需设置
常用方法如下:
session.destroy() :删除session,当检测到客户端关闭时调用
session.reload() :当session有修改时,刷新session
session.regenerate() :将已有session初始化
session.save() :保存session
var express = require('express');var cookieparser = require('cookie-parser');var session = require('express-session');   app.use(cookieparser('sessiontest')); app.use(session({  secret: 'sessiontest',//与cookieparser中的一致  resave: true,  saveuninitialized:true}));
//修改router/index.js,第一次请求时保存一条用户信息。router.get('/', function(req, res, next) { var user={   name:chen-xy,   age:22,   address:bj  }  req.session.user=user;  res.render('index', {   title: 'the test for nodejs session' ,   name:'sessiontest'  }); });
//修改router/users.js,判断用户是否登陆。router.get('/', function(req, res, next) { if(req.session.user){  var user=req.session.user;  var name=user.name;   res.send('你好'+name+',欢迎来到我的家园。');  }else{   res.send('你还没有登录,先登录下再试试!');  } });
【serve-favicon】
设置网站的 favicon图标
$ npm install serve-favicon
var express = require('express')var favicon = require('serve-favicon')var path = require('path')  var app = express() app.use(favicon(path.join(__dirname, 'public', 'favicon.ico')))  // add your routes here, etc.  app.listen(3000)
【body-parser】
bodyparser用于解析客户端请求的body中的内容,内部使用json编码处理,url编码处理以及对于文件的上传处理
$ npm install body-parser
var bodyparser = require('body-parser')
1、底层中间件用法:这将拦截和解析所有的请求;也即这种用法是全局的。
var express = require('express')var bodyparser = require('body-parser')   var app = express()   // parse application/x-www-form-urlencodedapp.use(bodyparser.urlencoded({ extended: false }))   // parse application/jsonapp.use(bodyparser.json())    app.use(function (req, res) {  res.setheader('content-type', 'text/plain')  res.write('you posted:\n')  res.end(json.stringify(req.body, null, 2)) })
use方法调用body-parser实例;且use方法没有设置路由路径;这样的body-parser实例就会对该app所有的请求进行拦截和解析
2、特定路由下的中间件用法:这种用法是针对特定路由下的特定请求的,只有请求该路由时,中间件才会拦截和解析该请求;也即这种用法是局部的;也是最常用的一个方式
var express = require('express')var bodyparser = require('body-parser')   var app = express()   // create application/json parservar jsonparser = bodyparser.json()   // create application/x-www-form-urlencoded parservar urlencodedparser = bodyparser.urlencoded({ extended: false })   // post /login gets urlencoded bodiesapp.post('/login', urlencodedparser, function (req, res) { if (!req.body) return res.sendstatus(400)  res.send('welcome, ' + req.body.username) })   // post /api/users gets json bodiesapp.post('/api/users', jsonparser, function (req, res) { if (!req.body) return res.sendstatus(400) // create user in req.body})
express的post(或者get)方法调用body-parser实例;且该方法有设置路由路径;这样的body-parser实例就会对该post(或者get)的请求进行拦截和解析
3、设置content-type 属性;用于修改和设定中间件解析的body内容类型
// parse various different custom json types as jsonapp.use(bodyparser.json({ type: 'application/*+json' });  // parse some custom thing into a bufferapp.use(bodyparser.raw({ type: 'application/vnd.custom-type' }));  // parse an html body into a stringapp.use(bodyparser.text({ type: 'text/html' }));
【morgan】
mogran是一个node.js关于http请求的express默认的日志中间件
npm install  morgan
在basic.js中添加如下代码
var express = require('express');var app = express();var morgan = require('morgan'); app.use(morgan('short')); app.use(function(req, res, next){     res.send('ok'); }); app.listen(3000);
node basic.js运行程序,并在浏览器里访问 http://127.0.0.1:3000 ,打印日志如下
::1 - get / http/1.1 200 2 - 3.157 ms ::1 - get / http/1.1 304 - - 0.784 ms
morgan支持stream配置项,可以通过它来实现将日志落地的效果,代码如下:
var express = require('express');var app = express();var morgan = require('morgan');var fs = require('fs');var path = require('path');var accesslogstream = fs.createwritestream(path.join(__dirname, 'access.log'), {flags: 'a'}); app.use(morgan('short', {stream: accesslogstream})); app.use(function(req, res, next){     res.send('ok'); }); app.listen(3000);
morgan的api非常少,使用频率最高的就是morgan(),作用是返回一个express日志中间件
morgan(format, options)
参数说明如下:
format:可选,morgan与定义了几种日志格式,每种格式都有对应的名称,比如combined、short等,默认是default
options:可选,配置项,包含stream(常用)、skip、immediate
stream:日志的输出流配置,默认是process.stdout
skip:是否跳过日志记录
immediate:布尔值,默认是false。当为true时,一收到请求,就记录日志;如果为false,则在请求返回后,再记录日志
路由【路由方法】
针对不同的请求,express提供了use方法的一些别名,这些别名是和 http 请求对应的路由方法: get、post、put、head、delete、options、trace、copy、lock、mkcol、move、purge、propfind、proppatch、unlock、report、mkactivity、checkout、merge、m-search、notify、subscribe、unsubscribe、patch、search 和 connect
app.all() 是一个特殊的路由方法,没有任何 http 方法与其对应,它的作用是对于一个路径上的所有请求加载中间件
有些路由方法名不是合规的 javascript 变量名,此时使用括号记法,比如 app['m-search']('/', function ...
var express = require(express);var http = require(http);var app = express(); app.all(*, function(request, response, next) {   response.writehead(200, { content-type: text/plain });   next(); }); app.get(/, function(request, response) {   response.end(welcome to the homepage!); }); app.get(/about, function(request, response) {   response.end(welcome to the about page!); }); app.get(*, function(request, response) {   response.end(404!); }); http.createserver(app).listen(1337);
上面代码的all方法表示,所有请求都必须通过该中间件,参数中的“*”表示对所有路径有效。get方法则是只有get动词的http请求通过该中间件,它的第一个参数是请求的路径。由于get方法的回调函数没有调用next方法,所以只要有一个中间件被调用了,后面的中间件就不会再被调用了
【路由路径】
路由方法的第一个参数,都是请求的路径,称为路由路径,它可以是字符串、字符串模式或者正则表达式
1、字符串匹配
// 匹配 /about 路径的请求app.get('/about', function (req, res) {   res.send('about'); });
2、字符串模式匹配
// 匹配 acd 和 abcdapp.get('/ab?cd', function(req, res) {   res.send('ab?cd'); });
3、正则表达式匹配
// 匹配任何路径中含有 a 的路径:app.get(/a/, function(req, res) {   res.send('/a/'); });
【路由句柄】
可以为请求处理提供多个回调函数,其行为类似中间件。唯一的区别是这些回调函数可能调用 next('route') 方法而略过其他路由回调函数。可以利用该机制为路由定义前提条件,如果在现有路径上继续执行没有意义,则可将控制权交给剩下的路径
路由句柄有多种形式,可以是一个函数、一个函数数组,或者是两者混合
1、使用一个回调函数处理路由
app.get('/example/a', function (req, res) {   res.send('hello from a!'); });
2、使用多个回调函数处理路由
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!'); });
3、使用回调函数数组处理路由
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]);
4、混合使用函数和函数数组处理路由
var cb0 = function (req, res, next) {   console.log('cb0');   next(); }var cb1 = function (req, res, next) {   console.log('cb1');   next(); } app.get('/example/d', [cb0, cb1], function (req, res, next) {   console.log('response will be sent by the next function ...');   next(); }, function (req, res) {   res.send('hello from d!'); });
【链式路由句柄】
可使用 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 4.0开始,路由器功能成了一个单独的组件express.router。它好像小型的express应用程序一样,有自己的use、get、param和route方法
可使用 express.router 类创建模块化、可挂载的路由句柄。router 实例是一个完整的中间件和路由系统,因此常称其为一个 “mini-app”
【基本用法】
首先,express.router是一个构造函数,调用后返回一个路由器实例。然后,使用该实例的http动词方法,为不同的访问路径,指定回调函数;最后,挂载到某个路径
var express = require('express');var router = express.router(); router.get('/', function(req, res) {   res.send('首页'); }); router.get('/about', function(req, res) {   res.send('关于'); }); app.use('/', router);
上面代码先定义了两个访问路径,然后将它们挂载到根目录。如果最后一行改为app.use(‘/app’, router),则相当于为/app和/app/about这两个路径,指定了回调函数。
这种路由器可以自由挂载的做法,为程序带来了更大的灵活性,既可以定义多个路由器实例,也可以为将同一个路由器实例挂载到多个路径
【router.route方法】
router实例对象的route方法,可以接受访问路径作为参数
var express = require('express');var router = express.router(); router.route('/api')     .post(function(req, res) {// ...    })     .get(function(req, res) {         bear.find(function(err, bears) {if (err) res.send(err);             res.json(bears);         });     }); app.use('/', router);
【router中间件】
use方法为router对象指定中间件,在数据正式发给用户之前,对数据进行处理。下面是一个中间件的例子
router.use(function(req, res, next) {     console.log(req.method, req.url);     next();     });
上面代码中,回调函数的next参数,表示接受其他中间件的调用。函数体中的next(),表示将数据传递给下一个中间件
[注意]中间件放置顺序很重要,等同于执行顺序。而且,中间件必须放在http动词方法之前,否则不会执行
【对路径参数的处理】
router对象的param方法用于路径参数的处理
router.param('name', function(req, res, next, name) {// 对name进行验证或其他处理……    console.log(name);     req.name = name;     next();     }); router.get('/hello/:name', function(req, res) {     res.send('hello ' + req.name + '!'); });
上面代码中,get方法为访问路径指定了name参数,param方法则是对name参数进行处理
[注意]param方法必须放在http动词方法之前
【实例】
下面的实例程序创建了一个路由模块,并加载了一个中间件,定义了一些路由,并且将它们挂载至应用路径上
在 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 中间件
响应方法response对象包含以下9个方法,response对象的方法向客户端返回响应,终结请求响应的循环。如果在路由句柄中一个方法也不调用,来自客户端的请求会一直挂起
方法     描述 res.download()    提示下载文件。 res.end()      终结响应处理流程。 res.json()     发送一个 json 格式的响应。 res.jsonp()    发送一个支持 jsonp 的 json 格式的响应。 res.redirect()    重定向请求。 res.render()     渲染视图模板。 res.send()     发送各种类型的响应。 res.sendfile()    以八位字节流的形式发送文件。 res.sendstatus()  设置响应状态代码,并将其以字符串形式作为响应体的一部分发送。
1、response.download方法
//下载路径为'/report-12345.pdf'的文件res.download('/report-12345.pdf');//下载路径为'/report-12345.pdf'的文件,并将文件命名为 'report.pdf'res.download('/report-12345.pdf', 'report.pdf');//下载路径为'/report-12345.pdf'的文件,将文件命名为 'report.pdf',并且回调res.download('/report-12345.pdf', 'report.pdf', function(err){  if (err) {   } else {   } });
2、response.end方法
//终结响应处理流程res.end();//设置响应码为404,并终结响应处理流程res.status(404).end();
3、response.json方法
res.json(null) res.json({ user: 'tobi' }) res.status(500).json({ error: 'message' })
4、response.jsonp方法
res.jsonp(null) res.jsonp({ user: 'tobi' }) res.status(500).jsonp({ error: 'message' })
5、response.redirect方法
res.redirect('/foo/bar'); res.redirect('http://example.com'); res.redirect(301, 'http://example.com'); res.redirect('../login');
6、response.render方法
res.render('index'); res.render('index', function(err, html) {   res.send(html); }); res.render('user', { name: 'tobi' }, function(err, html) {  // ...});
7、response.send方法
res.send(new buffer('whoop')); res.send({ some: 'json' }); res.send('<p>some html</p>'); res.status(404).send('sorry, we cannot find that!'); res.status(500).send({ error: 'something blew up' });
8、response.sendfile方法
response.sendfile(/path/to/anime.mp4);
9、response.sendstatus方法
res.sendstatus(200); // 'ok'res.sendstatus(403); // 'forbidden'res.sendstatus(404); // 'not found'res.sendstatus(500); // 'internal server error'
请求方法【req.params】
// get /user/tjreq.params.name// => tj// get /file/javascripts/jquery.jsreq.params[0]// => javascripts/jquery.js?1.1.11
【req.query】
// get /search?q=tobi+ferretreq.query.q// => tobi ferret// get /shoes?order=desc&shoe[color]=blue&shoe[type]=conversereq.query.order// => descreq.query.shoe.color// => bluereq.query.shoe.type// => converse
【req.body】
// post user[name]=tobi&user[email]=tobi@learnboost.comreq.body.user.name// => tobireq.body.user.email// => tobi@learnboost.com// post { name: tobi }req.body.name// => tobi
【req.param(name)】
// ?name=tobireq.param('name')// => tobi// post name=tobireq.param('name')// => tobi// /user/tobi for /user/:name req.param('name')// => tobi
【req.cookies】
// cookie: name=tjreq.cookies.name// => tj
【req.ip】
req.ip// => 127.0.0.1
【req.path】
// example.com/users?sort=descreq.path// => /users
【req.host】
// host: example.com:3000req.host// => example.com
app方法【set方法】
set方法用于指定变量的值
app.set(views, __dirname + /views); app.set(view engine, jade);
上面代码使用set方法,为系统变量“views”和“view engine”指定值
【get方法】
除了作为use()方法的别名用法外,get方法还用于获取变量的值,与set方法相对应
app.get('title');// => undefinedapp.set('title', 'my site'); app.get('title');// => my site
【app.enable(name)】
将设置项 name 的值设为 true 
app.enable('trust proxy'); app.get('trust proxy');// => true
【app.disable(name)】
将设置项 name 的值设为 false 
app.disable('trust proxy'); app.get('trust proxy');// => false
【app.enabled(name)】
检查设置项 name 是否已启用
app.enabled('trust proxy');// => falseapp.enable('trust proxy'); app.enabled('trust proxy');// => true
【app.disabled(name)】
检查设置项 name 是否已禁用
app.disabled('trust proxy');// => trueapp.enable('trust proxy'); app.disabled('trust proxy');// => false
【app.engine(ext, callback)】
注册模板引擎的 callback 用来处理 ext 扩展名的文件
默认情况下, 根据文件扩展名 require() 加载相应的模板引擎。 比如想渲染一个 “foo.jade” 文件,express 会在内部执行下面的代码,然后会缓存 require() ,这样就可以提高后面操作的性能
app.engine('jade', require('jade').__express);
那些没有提供 .__express 的或者想渲染一个文件的扩展名与模板引擎默认的不一致的时候,也可以用这个方法。比如想用ejs模板引擎来处理 “.html” 后缀的文件:
app.engine('html', require('ejs').renderfile);
这个例子中 ejs 提供了一个 .renderfile() 方法和 express 预期的格式: (path, options, callback) 一致, 因此可以在内部给这个方法取一个别名 ejs.__express ,这样就可以使用 “.ejs” 扩展而不需要做任何改动
有些模板引擎没有遵循这种转换, 这里有一个小项目 consolidate.js专门把所有的node流行的模板引擎进行了包装,这样它们在 express 内部看起来就一样了。
var engines = require('consolidate'); app.engine('haml', engines.haml); app.engine('html', engines.hogan);
【app.locals】
应用程序本地变量会附加给所有的在这个应用程序内渲染的模板。这是一个非常有用的模板函数,就像应用程序级数据一样
app.locals.title = 'my app'; app.locals.strftime = require('strftime');
app.locals 对象是一个 javascript function,执行的时候它会把属性合并到它自身,提供了一种简单展示已有对象作为本地变量的方法。
app.locals({   title: 'my app',   phone: '1-250-858-9990',   email: 'me@myapp.com'}); app.locals.title// => 'my app'app.locals.email// => 'me@myapp.com'
app.locals 对象最终会是一个 javascript 函数对象,不可以使用 functions 和 objects 内置的属性,比如 name、apply、bind、call、arguments、length、constructor。
app.locals({name: 'my app'}); app.locals.name// => 返回 'app.locals' 而不是 'my app' (app.locals 是一个函数 !)// => 如果 name 变量用在一个模板里,则返回一个 referenceerror
默认情况下express只有一个应用程序级本地变量,它是 settings
app.set('title', 'my app');// 在 view 里使用 settings.title
【app.render(view, [options], callback)】
渲染 view , 回调函数 callback 用来处理返回的渲染后的字符串。这个是 res.render() 的应用程序级版本,它们的行为是一样的。
app.render('email', function(err, html){// ...}); app.render('email', { name: 'tobi' }, function(err, html){// ...});
【app.listen()】
在给定的主机和端口上监听请求,这个和 node 文档中的 http.server#listen() 是一致的。
var express = require('express');var app = express(); app.listen(3000);
express() 返回的 app 实际上是一个 javascript function,它被设计为传给 node 的 http servers 作为处理请求的回调函数。因为 app 不是从 http 或者 https 继承来的,它只是一个简单的回调函数,可以以同一份代码同时处理 http 和 https 版本的服务。
var express = require('express');var https = require('https');var http = require('http');var app = express(); http.createserver(app).listen(80); https.createserver(options, app).listen(443);
app.listen() 方法只是一个快捷方法,如果想使用 https ,或者同时提供 http 和 https ,可以使用上面的代码。
app.listen = function(){  var server = http.createserver(this);  return server.listen.apply(server, arguments); };
https使用express搭建https加密服务器很简单
var fs = require('fs');var options = {   key: fs.readfilesync('e:/ssl/myserver.key'),   cert: fs.readfilesync('e:/ssl/myserver.crt'),   passphrase: '1234'};var https = require('https');var express = require('express');var app = express(); app.get('/', function(req, res){   res.send('hello world expressjs'); });var server = https.createserver(options, app); server.listen(8084); console.log('server is running on port 8084');
模板引擎需要在应用中进行如下设置才能让 express 渲染模板文件:
views, 放模板文件的目录,比如: app.set('views', './views')
view engine, 模板引擎,比如: app.set('view engine', 'jade')
然后安装相应的模板引擎 npm 软件包
$ npm install jade --save
一旦 view engine 设置成功,就不需要显式指定引擎,或者在应用中加载模板引擎模块,express 已经在内部加载,如下所示
app.set('view engine', 'jade');
在 views 目录下生成名为 index.jade 的 jade 模板文件,内容如下:
html   head     title!= title   body     h1!= message
然后创建一个路由渲染 index.jade 文件。如果没有设置 view engine,需要指明视图文件的后缀,否则就会遗漏它
app.get('/', function (req, res) {   res.render('index', { title: 'hey', message: 'hello there!'}); });
此时向主页发送请求,“index.jade” 会被渲染为 html
数据库为 express 应用添加连接数据库的能力,只需要加载相应数据库的 node.js 驱动即可。这里简要介绍如何为 express 应用添加和使用一些常用的数据库 node 模块
【mysql】
$ npm install mysql
var mysql      = require('mysql');var connection = mysql.createconnection({   host     : 'localhost',   user     : 'dbuser',   password : 's3kreee7'}); connection.connect(); connection.query('select 1 + 1 as solution', function(err, rows, fields) {  if (err) throw err;   console.log('the solution is: ', rows[0].solution); }); connection.end();
【mongodb】
$ npm install mongoskin
var db = require('mongoskin').db('localhost:27017/animals'); db.collection('mamals').find().toarray(function(err, result) {  if (err) throw err;   console.log(result); });
上传文件首先,在网页插入上传文件的表单
<form action="/pictures/upload" method="post" enctype="multipart/form-data">   select an image to upload:  <input type="file" name="image">   <input type="submit" value="upload image"> </form>
然后,服务器脚本建立指向/upload目录的路由。这时可以安装multer模块,它提供了上传文件的许多功能
var express = require('express');var router = express.router();var multer = require('multer');var uploading = multer({   dest: __dirname + '../public/uploads/',  // 设定限制,每次最多上传1个文件,文件大小不超过1mb   limits: {filesize: 1000000, files:1}, }) router.post('/upload', uploading, function(req, res) {}) module.exports = router
上面代码是上传文件到本地目录。下面是上传到amazon s3的例子。
首先,在s3上面新增cors配置文件
<?xml version="1.0" encoding="utf-8"?> <corsconfiguration xmlns="http://s3.amazonaws.com/doc/2006-03-01/">   <corsrule>     <allowedorigin>*</allowedorigin>     <allowedmethod>get</allowedmethod>     <allowedmethod>post</allowedmethod>     <allowedmethod>put</allowedmethod>     <allowedheader>*</allowedheader>   </corsrule> </corsconfiguration>
上面的配置允许任意电脑向你的bucket发送http请求。
然后,安装aws-sdk
$ npm install aws-sdk --save
下面是服务器脚本
var express = require('express');var router = express.router();var aws = require('aws-sdk'); router.get('/', function(req, res) {   res.render('index') })var aws_access_key = 'your_aws_access_key'var aws_secret_key = 'your_aws_secret_key'var s3_bucket = 'images_upload'router.get('/sign', function(req, res) {   aws.config.update({accesskeyid: aws_access_key, secretaccesskey: aws_secret_key});  var s3 = new aws.s3()  var options = {     bucket: s3_bucket,     key: req.query.file_name,     expires: 60,     contenttype: req.query.file_type,     acl: 'public-read'   }   s3.getsignedurl('putobject', options, function(err, data){if(err) return res.send('error with s3')     res.json({       signed_request: data,       url: 'https://s3.amazonaws.com/' + s3_bucket + '/' + req.query.file_name     })   }) }) module.exports = router
上面代码中,用户访问/sign路径,正确登录后,会收到一个json对象,里面是s3返回的数据和一个暂时用来接收上传文件的url,有效期只有60秒。
浏览器代码如下
// html代码为// <br>please select an image// <input type="file" id="image">// <br>// <img id="preview">document.getelementbyid(image).onchange = function() {  var file = document.getelementbyid(image).files[0]  if (!file) return   sign_request(file, function(response) {     upload(file, response.signed_request, response.url, function() {       document.getelementbyid(preview).src = response.url     })   }) }function sign_request(file, done) {  var xhr = new xmlhttprequest()   xhr.open(get, /sign?file_name= + file.name + &file_type= + file.type)   xhr.onreadystatechange = function() {if(xhr.readystate === 4 && xhr.status === 200) {      var response = json.parse(xhr.responsetext)       done(response)     }   }   xhr.send() }function upload(file, signed_request, url, done) {  var xhr = new xmlhttprequest()   xhr.open(put, signed_request)   xhr.setrequestheader('x-amz-acl', 'public-read')   xhr.onload = function() {if (xhr.status === 200) {       done()     }   }   xhr.send(file) }
上面代码首先监听file控件的change事件,一旦有变化,就先向服务器要求一个临时的上传url,然后向该url上传文件
开发实例【静态网页模板】
在项目目录之中,建立一个子目录views,用于存放网页模板。
假定这个项目有三个路径:根路径(/)、自我介绍(/about)和文章(/article)。那么,app.js可以这样写:
var express = require('express');var app = express();   app.get('/', function(req, res) {    res.sendfile('./views/index.html'); });   app.get('/about', function(req, res) {    res.sendfile('./views/about.html'); });   app.get('/article', function(req, res) {    res.sendfile('./views/article.html'); });   app.listen(3000);
上面代码表示,三个路径分别对应views目录中的三个模板:index.html、about.html和article.html。另外,向服务器发送信息的方法,从send变成了sendfile,后者专门用于发送文件。
假定index.html的内容如下:
<html> <head>    <title>首页</title> </head> <body> <h1>express demo</h1> <header> <p>    <a href="/">首页</a> - <a href="/about">自我介绍</a> - <a href="/article">文章</a> </p> </header> </body> </html>
about.html内容如下
<!doctype html> <html lang="en"> <head>     <meta charset="utf-8">     <title>document</title> </head> <body>about</body> </html>
article.html内容如下
<!doctype html> <html lang="en"> <head>     <meta charset="utf-8">     <title>document</title> </head> <body>article</body> </html>
运行app.js后,访问http://localhost:3000/结果如下
【动态网页模板】
下面来制作一个动态网页网站,以使用ejs引擎为例
  npm install ejs
将view engine修改为ejs,并将模板的后缀修改为.html
var express = require('express');var app = express();var ejs = require('ejs');// 指定模板文件的后缀名为htmlapp.set('view engine', 'html');//运行ejs引擎读取html文件app.engine('.html', ejs.__express); app.get('/', function (req, res){     res.render('index'); }); app.get('/about', function(req, res) {     res.render('about'); }); app.get('/article', function(req, res) {     res.render('article'); });
接下来,新建数据脚本。渲染是指将数据代入模板的过程。实际运用中,数据都是保存在数据库之中的,这里为了简化问题,假定数据保存在一个脚本文件中
在项目目录中,新建一个文件blog.js,用于存放数据。blog.js的写法符合commonjs规范,使得它可以被require语句加载
// blog.js文件var entries = [     {id:1, title:第一篇, body:正文, published:7/2/2017},     {id:2, title:第二篇, body:正文, published:7/3/2017},     {id:3, title:第三篇, body:正文, published:7/4/2017},     {id:4, title:第四篇, body:正文, published:7/5/2017},     {id:5, title:第五篇, body:正文, published:7/10/2017},     {id:6, title:第六篇, body:正文, published:7/12/2017} ]; exports.getblogentries = function (){   return entries; } exports.getblogentry = function (id){   for(var i=0; i < entries.length; i++){ if(entries[i].id == id) return entries[i]; } }
新建header.html和footer.html
<!-- views/header.html文件 --> <!doctype html> <html lang="en"> <head>     <meta charset="utf-8">     <title><%=title %></title> </head> <body>      <!-- views/footer.html文件 -->    <footer>       <p>          <a href="/">首页</a>          <a href="/about">自我介绍</a>       </p>    </footer>       </body> </html>
接着,新建模板文件index.html
<!-- views/index.html文件 --> <% include header.html %> <h1>文章列表</h1> <% for(var i=0; i < entries.length; i++){ %>     <p>         <a href="/article/<%=entries[i].id %>><%=entries[i].title %></a>         <br>           <span>时间: <%=entries[i].published %></span>             </p> <% } %>   <% include footer.html %>
新建模板文件about.html
<!-- views/about.html文件 --> <% include header.html %> <h1><%=title %> </h1> <p>正文</p> <% include footer.html %>
新建模板文件article.html
<!-- views/article.html文件 --> <% include header.html %> <h1><%=blog.title %></h1> <p>时间: <%=blog.published %></p> <p><%=blog.body %></p> <% include footer.html %>
最后,改写app.js文件
var express = require('express');var app = express();var ejs = require('ejs');// 加载数据模块var blogengine = require('./blog');   app.set('view engine', 'html'); app.engine('html', ejs.__express); app.get('/', function(req, res) {    res.render('index',{title:最近文章, entries:blogengine.getblogentries()}); });   app.get('/about', function(req, res) {    res.render('about', {title:自我介绍}); });   app.get('/article/:id', function(req, res) {   var entry = blogengine.getblogentry(req.params.id);    res.render('article',{title:entry.title, blog:entry}); });   app.listen(3000);
上面代码中的render方法,现在加入了第二个参数,表示模板变量绑定的数据。
现在重启node服务器,然后访问http://127.0.0.1:3000来查看结果
以上就是express框架入门学习知识点总结的详细内容。
其它类似信息

推荐信息