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);