本文以express 4.xx版本为准
express.xxx相关
express.json()
作用：将请求中Content-type为「application/json」类型的请求数据，解析成json
使用PostMan发送Post请求，body内容为一段JSON
image.png
const express = require("express");
const app = express();
app.use((request, response, next) => {
// 由于请求以流的形式传输，顾最开始此处接收值为空对象
console.log("request", request.body); // {}
// 以流的形式获得数据
request.on("data", (chunk) => {
console.log("chunk::::", chunk.toString()); // 将二进制内容以字符串形式打印
});
response.send("hi!!!");
next();
});
app.listen(3000, () => {
console.log("监听端口3000中...");
});
使用express.json()后
const express = require("express");
const app = express();
app.use(express.json()); // 使用express.json中间件，会将请求库的Json自动处理
app.use((request, response, next) => {
console.log("request", request.body); // 此处接受的请求体已经为object
// 并且此处并不会接收数据data，也就可以不用写了
// request.on("data", (chunk) => {
// console.log("chunk::::", chunk.toString());
// });
response.send("hi!!!");
next();
});
app.listen(3000, () => {
console.log("监听端口3000中...");
});
express.raw()
作用：将请求体信息解析为「Buffer」
express.text()
作用：将请求体信息转换为「字符串」
express.urlencoded()
作用：将Content-Type为「application/x-www-form-urlencoded」类型（该类型以key=xxx&value=yyy的形式传输）的数据，解析成对象
express.Router()
作用：生成一个路由对象
// app.ts
const express = require("express");
const app = express();
app.get("/admin", (request, response, next) => {
response.end("这是admin页面");
next();
});
app.get("/user", (request, response, next) => {
response.end("这是user页面");
next();
});
app.listen(3000, () => {
console.log("监听端口3000中...");
});
如上述代码，当我们设置了「admin」和「user」等多个模块路由时，都会写在一个文件里面，显得比较杂乱。使用express.Router()后可以分模块建路由
// src/admin.ts
const express = require("express");
const router = express.Router();
// 此处其实在请求「/admin」路由的时候，就会命中此处
router.get("/", (request, response, next) => {
response.end("这里是admin路由的首页");
});
export default router;
// app.ts
import admin from './src/admin';
const express = require('express');
const app = express();
app.get('/admin', admin); // 此处就是将admin的router对象置于/admin路由的处理
app.listen(3000, () => {
console.log('listening 3000...');
});
express.static()
作用：用于挂载静态资源
const express = require("express");
const app = express();
app.use(express.static("yyy"));
app.use((request, response, next) => {
console.log(request.body);
next();
});
app.listen(3000, () => {
console.log("listening 3000...");
});
当我们将静态资源指定为yyy文件夹后，直接访问「http://localhost:3000」即可显示yyy文件夹下的index.html文件
image.png
app.xxx相关
app.get()
作用：封装对GET请求的处理，也可以获取app.set()设置的值
app.use((request, response, next) => {
const { method } = request;
// 以往需要根据method字段来判断是否为GET请求
if (method === "GET") {
...
}
});
// 现在可以直接使用app.get来对GET请求处理
app.get('/', (request, response, next) => {
})
app.post()，app.put()等同理
app.set()
作用：设置引擎模板上的属性
app.set('title', 'express');
app.get('title'); // express
app.locals
作用：将某个属性挂载到全局变量上。一旦app.locals设置属性后，该属性会贯穿整个生命周期，
const express = require("express");
const app = express();
app.locals.name = "Jason";
app.get("/", function (req, res) {
console.log(app.locals.name); // Jason
res.send("Admin Homepage");
});
app.listen(3000, () => {
console.log("listening 3000...");
});
request.xxx相关
- request.hostname
获取「主机名」
// Host: "example.com:3000"
console.dir(req.hostname)
// => 'example.com'
- request.accepts
检查可接受的请求的文档类型
response.xxx相关
- response.status
设置响应的状态码
- response.download
传送指定路径的文件
router相关
可以用router单独抽出一部分路由处理，比如以下router内容是对「user」部分的处理
const express = require("express");
const router = express.Router();
router.get("/", (request, response, next) => {
response.end("This is index");
});
router.get("/:id", (request, response, next) => {
response.end("This is id page");
});
router.get("/:id/edit", (request, response, next) => {
response.end("This is edit page");
});
module.exports = router;
import userRouter from './router/user'; // 将上述处理user部分的路由处理引入
app.use('/user', userRouter); // 路径是/user的时候，采用userRouter的路由处理