浅谈Node.js轻量级Web框架Express4.x使用指南

Express是一个轻量级的Web框架,简单、灵活

也是目前最流行的基于Nodejs的Web框架

通过它我们可以快速搭建功能完整的网站 (express 英文意思:特快列车)

Express现在是4.x版本,更新很快,并且不兼容旧版本,导致现在市面上很多优秀的Node书籍过时

这篇文章是一篇入门级的Express使用,需要一定Node.js的基础

Web应用创建

首先要做的是下载express并引用

npm install express --save

全局安装就+个-g

引用express

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

通过app我们就可以使用各种express的API

在3.x版本的时候是这样写的

var app =express.createServer(); 

现在这个函数已经被抛弃了

下面正式创建应用

//app.js
var express = require('express');
var app = express();
app.get('/', function(req, res){
 res.send('Express');
});
app.listen(3000);

启动之后就能给够在页面看到效果

$ node app.js

app.get()

上面的app.listen()就不多说了

用于监听端口

app.get(path, function(req, res){ }) 

用于用于处理客户端向服务器发送的GET请求

path表示请求的路径

回调函数的req和res是request和response的意思

request表示客户端发送的HTTP请求信息

response表示服务器发送的HTTP响应信息

使用res.send()可以向客户端发送信息

//app.js
var express = require('express');
var app = express();

app.get('/', function(req, res){
 res.send('<h1>Express</h1>');
});
app.get('/demo', function(req, res){
 res.send('<h1>Demo</h1>');
})
app.get('/*', function(req, res){
 res.send('<h1>404<h1>');
})

app.listen(3000);
 

app.post()

app.post(path, function(req, res){ }) 

用于用于处理客户端向服务器发送的POST请求

和GET请求不同,POST请求不会将信息放在url中

而是写入请求头中

它的解析有所不同,下面再说

app.all()

在此之前还要提一个概念――中间件

Middleware中间件在不同环境下有不同含义

而在我们express中,简单说它就是一个特殊的函数

用来处理HTTP请求的函数

并且它有一个特点――处理完一个中间件可以传递给下一个中间件来处理

funciton(req, res, next){
  ...
  next();
}

(如果不使用执行next函数,那么之后监听的函数也不会执行)

可以向next中传递字符串参数,代表抛出的错误信息

这样当数据往下传递的时候,中间件不再进行处理

直到找到一个错误处理函数为止

app.all(path, function(req, res, next){ })的使用中

就需要我们定义这样的中间件

这个方法可以过滤所有路径上的请求

换句话说,在其他所有的中间件处理之前

必须先通过app.all()的中间件进行处理

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

app.all('*', function(req, res, next){
 res.writeHead(200, ':)');
 next();
});

app.get('/', function(req, res){
 res.end('<h1>Express</h1>');
});
app.get('/demo', function(req, res){
 res.end('<h1>Demo</h1>');
})
app.get('/*', function(req, res){
 res.end('<h1>404<h1>');
})

app.listen(3000);

这样不论客户端向我们发出了什么样的路径请求

服务器响应信息前都会先打上响应头

app.use()

app.use([path, ]function(req, res, next){ }) 

这个方法一般情况是用来调用中间件的

与前面的函数不同,它的第一个path参数可以省略,默认'/'

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

上面的这个用法就是指定静态文件的访问路径

通过next参数我们可以连续调用中间件函数

app.use(function(req, res, next){
 console.log(1);
 next();
});
app.use(function(req, res, next){
 console.log(2);
 next();
});
app.use(function(req, res, next){
 console.log(3);
});
app.use(function(req, res, next){
 console.log(4);
});

当发出网络请求的时候

控制台就会输出 1 2 3

因为第三个中间件没有调用next方法

所以处理到此为止

不会输出4

app.use()除了调用中间件

还可以根据请求路径的不同,返回不同信息

但我们一般不会这么用

//app.js
var express = require('express');
var app = express();

app.use(function(req, res, next){
 if(req.url == '/'){
  res.end('<h1>Express</h1>');
 }else{
  next();
 }
});
app.use(function(req, res, next){
 if(req.url == '/demo'){
  res.end('<h1>Demo</h1>');
 }else{
  next();
 }
});
app.use(function(req, res, next){
 res.end('<h1>404<h1>');
});

app.listen(3000);

请求与响应

上面express中每一个回调函数都不可缺少req和res参数

重要性可见一斑

常见的req与res中的属性/方法如下(原生node.js的req、res属性/方法也可以使用)

Request对象:

API 含义
req.app 当callback为外部文件时,用于访问express的实例
req.baseUrl 获取路由当前安装的URL路径
req.body/cookies 获得「请求主体」/ Cookies
req.fresh/stale 判断请求是否还「新鲜」
req.hostname/ip 获取主机名和IP地址
req.originalUrl 获取原始请求URL
req.params 获取路由的parameters
req.path 获取请求路径
req.protocol 获取协议类型
req.query 获取URL的查询参数串
req.route 获取当前匹配的路由
req.subdomains 获取子域名
req.acceptsCharsets 返回指定字符集的第一个可接受字符编码
req.acceptsEncodings 返回指定字符集的第一个可接受字符编码
req.acceptsLanguages 返回指定字符集的第一个可接受字符编码
req.accepts() 检查可接受的请求的文档类型
req.get() 获取指定的HTTP请求头
req.is() 判断请求头Content-Type的MIME类型

Response对象:

API 含义
res.app 同req.app
res.append() 追加指定HTTP头
res.set() 在res.append()后将重置之前设置的头
res.cookie() 设置Cookie
res.clearCookie() 清除Cookie
res.download() 传送指定路径的文件
res.get() 返回指定的HTTP头
res.json() 传送JSON响应
res.jsonp() 传送JSONP响应
res.location() 只设置响应的Location HTTP头,不设置状态码或者close response
res.redirect() 设置响应的Location HTTP头,并且设置状态码302
res.send() 传送HTTP响应
res.sendFile() 传送指定路径的文件 -会自动根据文件extension设定Content-Type
res.set() 设置HTTP头,传入object可以一次设置多个头
res.status() 设置HTTP状态码
res.type() 设置Content-Type的MIME类型

挑一些重点

req.query

req.query可以获取请求路径参数的对象

向服务器发送请求 http://localhost:3000/?user=tester&pass[a]=123&pass[b]=456

//app.js
var express = require('express');
var app = express();

app.get('/', function(req, res, next){
 console.log(req.query);
 console.log(req.query.user); //tester
 console.log(req.query.pass.a); //123
 console.log(req.query.pass.b); //456
 res.end();
});

app.listen(3000);

req.params

req.params可以解析复杂路由规则上的属性
(req.param综合了req.query和req.param的功能,但是被移除了不要使用)

向服务器发送请求 http://localhost:3000/123456

//app.js
var express = require('express');
var app = express();

app.get('/:id', function(req, res, next){
 console.log(req.params.id); //123456
 res.end();
});

app.listen(3000);

 这样不论我在根路径后输入的是什么

都会被解析为req.params.id

res.send()

res.send用于向客户端响应信息 并且它的强大之处在于可以智能的处理我们传递的不同类型参数

app.get('/', function(req, res, next){
 res.send('express');
});

当参数为字符串,会将响应头Content-Type默认设置为text/html

也就是解析为html呈现在我们的页面上

app.get('/', function(req, res){
 res.send(200);
});

当参数为数字,会自动帮我们设置响应体(状态码…)

app.get('/', function(req, res){
 res.send([1, 2, 3]);
});

当参数为数组或对象,它会响应一个JSON

res.redirect()

使用这个方法可以让我们对网页重定向

比如使用绝对url跳转到不同的域名

app.get('/', function(req, res){
 res.redirect('http://www.baidu.com');
});

res.redirect()默认响应状态码是302

可以更改这个状态码作为res.redirect()的第一个参数

//app.js
var express = require('express');
var app = express();

app.get('/', function(req, res){
 res.redirect(302, 'demo');
});
app.get('/demo', function(req, res){
 res.end();
});

app.listen(3000);

当在url地址栏中输入http://localhost:3000

页面就会重定向到http://localhost:3000/demo

静态资源

静态资源就是指我们在开发中用到的css、js、img等等

它们需要存放到一个静态资源目录

当浏览器发出了一个非HTML文件请求

服务器就会从这个静态资源目录下去查找文件

我们一般在根目录下创建一个public文件来存储

并在public中创建stylesheets、javascripts、images等文件夹

用来存储特定类型的资源

指定静态资源目录的方法上面已经提到了

var path = require('path');
app.use(express.static(path.join(__dirname, 'public')));

比如说我们的html中有这样的代码

<link href="/javascripts/jquery.js" rel="external nofollow" rel="stylesheet" media="screen">

那么客户端运行发出请求

服务器就会在public的javascripts文件夹下找到jQuery.js静态资源

模板引擎

express框架默认是ejs和jade渲染模板

这里以jade为例

使用时肯定要下载

npm install jade --save

再通过app.set()指定查找模板文件的目录(类似于静态资源)

并指定模板文件后缀为jade

app.set('views', path.join(__dirname, 'views'));
app.set('view engine', 'jade');

(如果不使用模板而使用原生html,app.set('view engine', 'html');)

如果我们想要访问模板该怎么做呢?

很简单,只需要一个方法res.render()

现在我写了一个简单的jade模板(关于jade语法超出本文讨论范围)

//views/index.jade
doctype html
html
 head
  title= title
  link(rel='stylesheet', href='/stylesheets/style.css')
 body
  h1= title
  p= content

通过res.render渲染

//app.js
var express = require('express');
var path = require('path');
var app = express();

app.use(express.static(path.join(__dirname, 'public')));

app.set('views', path.join(__dirname, 'views'));
app.set('view engine', 'jade');

app.get('/', function(req, res){
 res.render('index', {
  title: 'Express',
  content: 'this is an example'
 });
});

app.listen(3000);

res.render()

res.render(view[, datas][, callback])

用于对网页模板进行渲染

第一个参数是要渲染的模板名称

第二个参数是传递给模板的变量,以对象形式存储,没有可省略

第三个参数是渲染后回调函数,可以省略

路由

路由的意思就是根据不同的路径,来指定不同的处理方法

我们一般把不同的路由封装进不同的模块

首先在根目录下创建一个文件夹routes存储路由

现在我在routes文件夹下创建俩个路由文件index.js和users.js

修改app.js

//app.js
var express = require('express');
var path = require('path');
var app = express();

var index = require('./routes/index');
var users = require('./routes/users');

app.use('/', index);
app.use('/users', users);

app.listen(3000);

这样表示http://localhost:3000/的路由交给index处理

http://localhost:3000/users的路由交给users处理

下面简单的实现一下路由

//routes/index.js
var express = require('express');
var router = express.Router();

router.get('/', function(req, res){
 res.end('index');
});

router.get('/123', function(){
 res.end(123);
});

module.exports = router;
//routes/users.js
var express = require('express');
var router = express.Router();

router.get('/', function(req, res) {
 res.end('users');
});

module.exports = router;

通过express.Router()创建的router就像一个mini版的app一样

app能做的,router都能做

只是我们把逻辑都封装到了各个路由模块中

上面代码的结果:

body-parser中间件

作为一个入门级文章

最后就来浅显的谈一个中间件body-parser吧

其实express在3.x版本中内置了很多中间件

但是4.x版本就将出static以外的所有中间件全部抽离出来了

所以就需要我们单独安装

对照表如下:

Express 3.0 Express 4.0
bodyParser body-parser
compress compression
cookieSession cookie-session
logger morgan
cookieParser cookie-parser
session express-session
favicon static-favicon
response-time response-time
error-handler errorhandler
method-override method-override
timeout connect-timeout
vhost vhost
csrf csurf

刚才就提到了POST请求有所不同

不同的地方就在于我们需要body-parser这个中间件来处理数据

通过req.body来获得数据

首先使用前不要忘记下载

npm install body-parser --save
//app.js
var express = require('express');
var bodyParser = require('body-parser');
var path = require('path');
var app = express();

app.use(bodyParser.json());
app.use(bodyParser.urlencoded({ extended: false }));

app.get('/', function(req, res){
 res.send('<form method="POST" action="./form">\
       <input type="text" name="user">\
       <input type="submit">\
      </form>');
});
app.post('/form', function(req, res){
 console.log(req.body);
 var user = req.body.user;
 res.send('账号: ' + user);
});

app.listen(3000);

下面这四个方法分别用于对body内容采取不同的处理方法

  1. bodyParser.json(options) 处理JSON数据
  2. bodyParser.raw(options) 处理buffer数据
  3. bodyParser.text(options) 处理文本数据
  4. bodyParser.urlencoded(options) 处理UTF-8编码数据

这样我首先通过get请求获取主页面

提交表单向服务器发送post请求

服务器响应结果

express-generator

通过express-generator应用生成器

可以为我们快速生成项目雏形

在你要生成项目的目录中下载express-generator

npm install express-generator

然后输入

express <项目文件名>

这样express就会把必要的文件夹以及代码快速生成了

以上就是本文的全部内容,希望对大家的学习有所帮助,也希望大家多多支持编程小技巧。

代码技巧

转载请关注公众号:代码技巧 回复:授权

本文链接地址:https://www.oudahe.com/p/53484/