node.js中express框架的基本使用

express是一个基于node.js平台的，快速，开放，极简的web开发框架。

一、安装 express

npm install express --save

　　

二、简单使用 express

//引入express
const express = require('express');
//创建一个应用
let app = express();

//匹配GET请求路径设置回调函数
app.get('/hello', function (req, res) {
    res.end('hello');
});

//监听端口
app.listen(8888, function () {
    console.log('port : 8888');
});

通过访问 localhost:8888/hello 我们就可以看到内容输出了。

当然 express 还支持其他的一些请求方法，比如 app.post()，app.put()，app.delete()，app.head() 等。

//引入express
const express = require('express');
//创建一个应用
let app = express();

//匹配POST请求
app.post('/hello', function (req, res) {
    res.end('post hello');
});

//监听端口
app.listen(8888, function () {
    console.log('port : 8888');
});

如果我们想要匹配所有的请求路径，可以使用通配符 * 号。

//引入express
const express = require('express');
//创建一个应用
let app = express();

app.get('/hello', function (req, res) {
    res.end('hello');
});

//*号匹配所有路径
app.get('*', function (req, res) {
    res.end('not found');
});

//监听端口
app.listen(8888, function () {
    console.log('port : 8888');
});

express 还提供了 all() 方法，可以匹配所有请求方法。

//引入express
const express = require('express');
//创建一个应用
let app = express();

//匹配所有请求方法
app.all('/hello', function (req, res) {
    res.end('all hello');
});

//监听端口
app.listen(8888, function () {
    console.log('port : 8888');
});

　　

三、express 中间件的概念

express中间件就是处理http请求的函数，用来完成一些特定的操作，比如登陆检查，权限控制等等。

1、一个中间件处理完请求和响应，可以把数据传递给下一个中间件。

2、在回调函数中使用 next()，就可以让请求继续向下传递。

3、通过不同路径，分别执行不同的中间件。

我们可以使用 use() ，在路由数组中添加一个中间件。注意我们设置的路由路径最终会存放在一个数组里，由上到下的把路径加入这个数组中。

//引入express
const express = require('express');
//创建一个应用
let app = express();

//如果没有设置路径，则会匹配全部
app.use(function (req, res, next) {
    console.log('匹配全部路径');
    //注意这里如果不调用next()，则请求并不会向下传递。
    next();
});

app.use('/hello', function (req, res, next) {
    console.log('use hello');
    next();
});

app.get('/hello', function (req, res, next) {
    console.log('get hello');
    next();
});

//监听端口
app.listen(8888, function () {
    console.log('port : 8888');
});

next() 函数可以传入一个参数，表示错误信息，默认将执行错误中间件。

//引入express
const express = require('express');
//创建一个应用
let app = express();

app.get('/hello', function (req, res, next) {
    console.log('get hello');
    next('error!!!');
});

//注意错误处理中间件的参数是4个
app.use(function (err, req, res, next) {
    console.log(err);
    res.end(err);
});

//监听端口
app.listen(8888, function () {
    console.log('port : 8888');
});

　　

四、express中的request对象

在express中对原生的req请求对象进行了扩展，添加了一些属性和方法。

//引入express
const express = require('express');
//创建一个应用
let app = express();

app.get('/hello', function (req, res, next) {
    //主机名
    res.write('req.hostname : ' + req.hostname + '\r\n');
    //请求URL的路径
    res.write('req.path : ' + req.path + '\r\n');
    //查询字符串对象
    res.write('req.query : ' + JSON.stringify(req.query) + '\r\n');
    //请求的远程IP地址
    res.write('req.ip : ' + req.ip + '\r\n');
    //请求方法
    res.write('req.method : ' + req.method + '\r\n');
    res.end();
});

//监听端口
app.listen(8888, function () {
    console.log('port : 8888');
});

通过 req.params 获取路径里的参数

//引入express
const express = require('express');
//创建一个应用
let app = express();

app.get('/list/:key/:page/:size', function (req, res, next) {
    //注意，设置了多少参数，地址就需要传入多少参数
    res.end(JSON.stringify(req.params));
});

//监听端口
app.listen(8888, function () {
    console.log('port : 8888');
});

　　

五、express中的response对象

express中也对原生的res对象进行了扩展，添加了一些属性和方法。

const path = require('path');
//引入express
const express = require('express');
//创建一个应用
let app = express();

app.get('/send/str', function (req, res, next) {
    //send方法会自动判断数据类型，并进行相应的head信息设置
    //如果参数是字符串，则Content-Type为 text/html
    res.send('hello, world');
});

app.get('/send/arr', function (req, res, next) {
    //如果参数是一个数组，则返回json
    res.send([1, 2, 3]);
});

app.get('/send/obj', function (req, res, next) {
    //如果参数是一个对象，则返回json
    res.send({name: 'xiaoxu', age: 24});
});

app.get('/send/number', function (req, res, next) {
    //如果是一个数字，则返回相应状态码短语
    res.send(404);
});

app.get('/download', function (req, res, next) {
    //提示下载文件
    res.download('./1.txt');
});

app.get('/json', function (req, res, next) {
    //响应json对象
    res.json({name: 'xiaoxu'});
});

app.get('/jsonp', function (req, res, next) {
    //客户端请求时，需要带上callback=test
    res.jsonp('hello');
});

app.get('/redirect', function (req, res, next) {
    //重定向到一个地址
    res.redirect('http://www.baidu.com');
});

app.get('/sendfile', function (req, res, next) {
    //发送一个文件
    res.sendFile(path.resolve('./1.txt'));
});

app.get('/sendstatus', function (req, res, next) {
    //发送一个状态码
    res.sendStatus(302);
});

//监听端口
app.listen(8888, function () {
    console.log('port : 8888');
});

　　

六、ejs模板的使用

支持express的模板有很多种，这里我们使用ejs作为模板引擎。

安装ejs:

npm install ejs

使用ejs模板

const path = require('path');
const express = require('express');
//创建一个应用
let app = express();
//设置模板引擎
app.set('view engine', 'ejs');
//设置模板目录
app.set('views', path.join(__dirname, 'views'));
//监听
app.listen(8888);

如果我们希望，ejs能够渲染html页面，可以使用如下

const path = require('path');
const express = require('express');
let app = express();

//设置视图引擎为html引擎
app.set('view engine', 'html');
//设置视图的路径
app.set('views', path.join(__dirname, 'views'));
//配置html引擎
app.engine('html', require('ejs').__express);

app.listen(8888);

渲染视图，输出内容。

const path = require('path');
const express = require('express');
let app = express();

app.set('view engine', 'html');
app.set('views', path.join(__dirname, 'views'));
app.engine('html', require('ejs').__express);

app.get('/hello', function (req, res, next) {
    //参数一表示模板的名称，会在当前项目目录下的views目录查找
    //参数二表示传入模板中的数据
    res.render('hello', {
        name: 'xiaoxu',
        age: 24
    });
});

app.listen(8888);

hello.html的代码：

<!doctype html>
<html lang="zh-CN">
<head>
    <meta charset="UTF-8">
    <title>Document</title>
</head>
<body>
    <%= name %>
    <%= age %>
</body>
</html>

　　

七、静态文件服务器

有些时候我们需要在页面上加载css，js，img等静态资源，指定存放静态资源的目录，浏览器发出非html文件请求时，服务器会到这个目录下找对应的资源。

const path = require('path');
const express = require('express');
let app = express();

app.set('view engine', 'html');
app.set('views', path.join(__dirname, 'views'));
app.engine('html', require('ejs').__express);

//注意express.static这个中间件是express内置的
app.use(express.static(path.join(__dirname, 'public')));

app.get('/hello', function (req, res, next) {
    //参数一表示模板的名称，会在当前项目目录下的views目录查找
    //参数二表示传入模板中的数据
    res.render('hello', {
        name: 'xiaoxu',
        age: 24
    });
});

app.listen(8888);

　　

八、使用body-parser中间件解析post过来的数据

安装body-parser

npm install body-parser

使用body-parser

const path = require('path');
const express = require('express');
const bodyParser = require('body-parser');
let app = express();

app.set('view engine', 'html');
app.set('views', path.join(__dirname, 'views'));
app.engine('html', require('ejs').__express);

//解析 application/json
app.use(bodyParser.json());
//解析 application/x-www-form-urlencoded
app.use(bodyParser.urlencoded({extended:false}));

app.post('/form', function (req, res) {
    console.log(req.body);
});

app.listen(8888);