Exprsss的入门详解
Express是什么
Express 是基于 Node.js 平台,快速、开放、极简的 web 开发框架。
Express安装与使用
安装
新建Myapp目录
使用cmd创建pakeage.json文件
npm init
安装express
npm install express --save
使用
进入 Myapp 目录,创建一个名为 app.js 的文件,然后将下列代码复制进去:
var express = require('express');
// 引入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);
});
运行
node app.js
在浏览器中打开 http://localhost:3000/ 并查看输出结果。
Express生成器
我们使用Express生成器可以快速创建一个应用的骨架。这是一个脚手架工具.
安装
npm install express-generator -g
使用
创建工作目录,在工作目录下运行以下命令
express myapp
这会在你的工作目录下创建一个myapp文件夹,然后我们进入myapp文件夹,运行以下命令安装依赖
npm install
完成后运行以下命令启动
set DEBUG=myapp & npm start
在浏览器中打开 http://localhost:3000/ 网址就可以看到这个应用了。
Express路由
路由是指如何定义应用的端点(URIs)以及如何响应客户端的请求。
路由是由一个 URI、HTTP 请求(GET、POST等)和若干个句柄组成,它的结构如下: app.METHOD(path, [callback...], callback), app 是 express 对象的一个实例, METHOD 是一个 HTTP 请求方法, path 是服务器上的路径, callback 是当路由匹配时要执行的函数。
下面是一个基本路由实例
var express = require('express');
var app = express();
app.get('/', function(req, res) {
res.send('第一个路由');
});
路由方法
路由方法源于 HTTP 请求方法,和 express 实例相关联。
Express 定义了如下和 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 方法与其对应,它的作用是对于一个路径上的所有请求加载中间件。
路由路径
使用字符串的路由路径示例:
// 匹配根路径的请求
app.get('/', function (req, res) {
res.send('root');
});
使用字符串模式的路由路径示例:
// 匹配 acd 和 abcd
app.get('/ab?cd', function(req, res) {
res.send('ab?cd');
});
使用正则表达式的路由路径示例:
// 匹配任何路径中含有 a 的路径
app.get(/a/, function(req, res) {
res.send('/a/');
});
在脚手架中的使用
打开myapp文件夹下的routes文件夹,里面有脚手架为我们创建的index.js路由文件,打开后我们可以看到
var express = require('express');
var router = express.Router();
router.get('/', function(req, res, next) {
res.render('index', { title: 'Express' });
// 加载index模版传入title
});
module.exports = router;
这就是一个路由
然后我们打开myapp下的app.js(也有可能是index.js)文件
可以找到这样的两行代码
var index = require('./routes/index');
// 引入index文件
app.use('/', index);
// 使用
Express模版引擎
需要在应用中进行如下设置才能让 Express 渲染模板文件:
views, 放模板文件的目录,比如: app.set('views', './views')
view engine, 模板引擎,比如: app.set('view engine', 'jade')
安装相应的模板引擎 npm 软件包。
npm install jade --save
// 或者
npm install ejs --save
在 views 目录下生成名为 index.jade 的 Jade 模板文件,内容如下:
html
head
title!= title
body
h1!= message
Express中间件
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('Request Type:', req.method);
next();
});
在路由中的这个function就是中间件,它有3个参数,分别为req(请求对象).res(响应对象).next(),如果去掉next(),下一个中间件就不会执行
例如
var app = express();
app.use('/user/:id', function (req, res, next) {
console.log('Request Type:', req.method);
});
app.use('/user/:id', function (req, res, next) {
console.log('Request Type:', req.method);
next()
});
如果需要在中间件栈中跳过剩余中间件,调用 next('route') 方法将控制权交给下一个路由。 注意: next('route') 只对使用 app.VERB() 或 router.VERB() 加载的中间件有效。
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();
// 一个中间件栈,显示任何指向 /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();
});
错误处理中间件
错误处理中间件和其他中间件定义类似,只是要使用 4 个参数,而不是 3 个,其签名如下: (err, req, res, next)。
app.use(function(err, req, res, next) {
console.error(err.stack);
res.status(500).send('Something broke!');
});
内置中间件
express.static(root, [options])
express.static 是 Express 唯一内置的中间件。它基于 serve-static,负责在 Express 应用中提托管静态资源。
第三方中间件
通过使用第三方中间件从而为 Express 应用增加更多功能。
安装所需功能的 node 模块,并在应用中加载,可以在应用级加载,也可以在路由级加载。
实际上,我们创建的这个应用已经引入了两个第三方的中间件,在 package.json 中就可以找到
"dependencies": {
"body-parser": "~1.18.2",
"cookie-parser": "~1.4.3",
"debug": "~2.6.9",
"express": "~4.15.5",
"jade": "~1.11.0",
"morgan": "~1.9.0",
"serve-favicon": "~2.4.5"
}
其中 body-parser 和 cookie-parser 就是两个第三方中间件
进程管理器
进程管理器
在编写程序时,我们发现,每次更改文件之后,都需要在命令行内停止当前的服务,然后输入 npm start ,很麻烦。我们需要一款自动刷新的工具
这里介绍一下 pm2
安装:
npm install pm2 -gd
安装完毕,运行我们的程序吧:
还记得我们之前说的 npm start 的启动路径没
pm2 start ./bin/www --watch
[PM2] Applying action restartProcessId on app [www](ids: 0)
[PM2] [www](0) ✓
[PM2] Process successfully started
┌──────────┬────┬──────┬───────┬────────┬─────────┬────────┬─────┬──────────┬──────────┬──────────┐
│ App name │ id │ mode │ pid │ status │ restart │ uptime │ cpu │ mem │ user │ watching │
├──────────┼────┼──────┼───────┼────────┼─────────┼────────┼─────┼──────────┼──────────┼──────────┤
│ www │ 0 │ fork │ 14448 │ online │ 0 │ 0s │ 0% │ 8.6 MB │ motor │ enabled │
└──────────┴────┴──────┴───────┴────────┴─────────┴────────┴─────┴──────────┴──────────┴──────────┘
Use `pm2 show ` to get more details about an app
当显示 status 为 online 时,说明程序启动成功
现在可以打开 http://localhost:3000 就可以看到运行的程序了
从命令行中我们可以看出我们的 app 名称, id ,状态,内存和 cpu 占用,监视状态等信息
启动完成之后我们就可以根据我们程序的id进行控制了
下次启动可以输入
pm2 start 0 --watch
别忘了 --watch ,没有它,程序是无法自动刷新的
pm2 stop 0
//停止应用:
pm2 restart 0
//重启
pm2 show 0
//显示程序信息
pm2 delete 0
//删除程序
pm2 list
//查看程序列表