浅谈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();
现在这个函数已经被抛弃了
狼蚁网站SEO优化正式创建应用
//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中
而是写入请求头中
它的解析有所不同，狼蚁网站SEO优化再说
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处理
狼蚁网站SEO优化简单的实现一下路由
//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);
狼蚁网站SEO优化这四个方法分别用于对body内容采取不同的处理方法
- bodyParser.json(options) 处理JSON数据
- bodyParser.raw(options) 处理buffer数据
- bodyParser.text(options) 处理文本数据
- bodyParser.urlencoded(options) 处理UTF-8编码数据
这样我首先通过get请求获取主页面
提交表单向服务器发送post请求
服务器响应结果
express-generator
通过express-generator应用生成器
可以为我们快速生成项目雏形
在你要生成项目的目录中下载express-generator
npm install express-generator
然后输入
express <项目文件名>
这样express就会把必要的文件夹以及代码快速生成了
以上就是本文的全部内容，希望对大家的学习有所帮助，也希望大家多多支持狼蚁SEO。