Express框架基本用法包括安装、创建应用、监听请求和响应客户端
Express 框架基本用法
1.安装:
使用npm或cnpm将Express安装到项目中,命令为$ npm install express@4.17.1。安装后,还需安装一些额外的中间件,如body-parser、cookie-parser和multer,以处理不同类型的数据。
2.创建应用:
首先导入express模块,然后调用express()函数创建一个新的Express应用对象。例如,可以创建一个基本的Web服务器,代码如下:
const express = require('express');
const app = express();
app.listen(80, () => {
console.log('express server running at http://127.0.0.1');
})
注:此代码会启动一个监听80端口的服务器。
3.监听请求:
使用app.get()和app.post()方法分别监听GET和POST请求。例如,要监听根路径(“/”)上的GET请求,可以使用以下代码:
app.get('/', function(req, res) {
res.send('Hello World');
});
注:这样,当用户访问"http://127.0.0.1/“时,服务器将响应"Hello World”。
4.响应客户端:
通过res对象的send方法,可以将数据发送回客户端。除了文本,还可以发送JSON对象、状态码等。例如:
app.get('/user', function(req, res) {
res.send({ name: 'zt', age: 20 });
});
注:此代码在访问"/user"时返回一个包含姓名和年龄的JSON对象。
综上所述,Express的基本用法涵盖了从安装、创建应用、监听请求到响应客户端的全过程,适用于快速搭建Web服务器和API接口服务器。
Express 框架新增知识
一.Express模块中请求对象
Express模块中的请求对象(req)是对HTTP请求的封装,它包含了请求查询字符串、参数、正文、HTTP标头等属性。
1.属性和方法
属性:
req.params: 包含命名路由参数的对象,例如在路径/user/:id中,:id可以通过req.params.id访问。
req.query: 包含GET请求查询字符串参数的对象,以键值对形式存储。
req.body: 包含POST请求参数的对象,需要使用如body-parser这样的中间件来解析请求体。
req.cookies: 包含从客户端传递过来的Cookies值的对象。
req.headers: 一个对象,包含了从客户端接收到的所有请求头信息。
req.ip: 表示客户端的IP地址。
req.path: 请求的路径部分,不包含查询字符串。
req.protocol: 指示所使用的协议,如HTTP或HTTPS。
req.secure: 如果连接使用的是HTTPS,则此属性为true。
req.originalUrl: 包含了原始请求URL和查询字符串的属性。
方法:
req.accepts([types]): 用于确定客户端是否接受一个或多个指定的MIME类型。该方法对于编写可提供多种内容类型的API非常有用。
2.请求对象使用示例
获取请求参数和路径:通过req.params可以获取路径参数;通过req.query可以获取URL查询字符串参数。
解析请求体:通常使用body-parser中间件来解析HTTP请求体,解析后的数据可通过req.body访问。
读取Cookie数据:通过req.cookies可以直接访问客户端传递的Cookie对象。
获取客户端的IP地址:req.ip属性包含了发起请求的客户端的IP地址信息。
查看请求的HTTP方法和原始URL:分别通过req.method和req.originalUrl可以得知请求的HTTP方法以及请求被发送时的完整URL。
二.Express模块中响应对象
1.属性
res.app:此属性指向创建响应对象的Express应用实例。这在有时候需要访问应用层面的对象或方法时非常有用。
res.headersSent:这是一个布尔属性,用于表示HTTP头是否已经发送。在发送任何响应体之前,该属性的值为false,发送之后变为true。这个属性对于确定是否还可以修改响应头很有用。
res.locals:这是一个可用来存储响应本地变量的对象,常用于中间件之间传递数据。与req.app相同,但主要用于响应相关的数据。
res.req:此属性是对原始请求对象的引用,在某些情况下,如在一个中间件函数内部创建了对请求对象的引用,则可能会用到这个属性。
2.方法
res.append():此方法用于在响应头中追加指定的字段值。如果字段已存在,新的值将被追加到已有值后面,使用逗号分隔。
res.download():此方法用于向客户端发送一个文件,通常用于文件下载操作。它设置适当的头信息,以便浏览器进行下载操作而非显示文件内容。
res.end():此方法用于终结响应处理流程,它可以不带参数,也可以带有一个可选的响应体参数和一个字符编码参数。当不需要发送任何数据时调用此方法可以快速结束响应。
res.json():此方法用于发送一个JSON格式的响应。这个方法与res.send()相似,但是更专注于发送JSON数据。它还允许发送一些在严格JSON格式中不是合法值的数据,如null或undefined。
res.jsonp():此方法类似于res.json(),但是它支持JSONP(JSON with Padding),这意味着响应可以包含一个JSONP回调函数的包裹形式。
res.redirect():此方法用于执行一个重定向操作,可以将用户代理重定向到新的路径或外部URL。它也可以指定HTTP状态码,默认为302 Found。
res.render():此方法用于渲染视图模板并将结果作为HTML发送给客户端。这个方法常用于Web应用程序中,配合模板引擎使用,如ejs、pug等。
res.send():此方法用于发送各种类型的响应体数据,包括Buffer对象、字符串、纯对象或数组。根据数据类型自动设置适当的Content-Type头。
三.Express模块中的中间件
中间件在Express模块中扮演着至关重要的角色,它提供了一种灵活而强大的机制来处理HTTP请求,从而扩展了Express应用的功能。
1.基本概念:
Express中间件本质上是一个函数,它可以访问请求对象(req)、响应对象(res)和应用程序的请求-响应循环中的下一个中间件函数(通常由一个名为next的变量表示)。
中间件能够执行代码、修改请求和响应对象、结束请求-响应循环或调用下一个中间件函数。如果当前中间件函数没有结束请求-响应循环,它必须通过调用next()方法将控制权传递给下一个中间件函数,否则,请求将保持挂起状态。
2.中间件类型:
应用级中间件通过app.use()或app.METHOD()函数绑定到应用程序对象的实例。
路由器级中间件类似于应用级中间件,但它绑定到express.Router()的实例。
错误处理中间件是一种特殊的中间件,用于捕获和处理应用程序中的错误。
Express提供了一些内置的中间件,如express.static(用于提供静态文件服务)、express.json(用于解析JSON数据)和express.urlencoded(用于解析URL编码数据)。
注:开发者还可以根据需要自定义中间件,以满足特定的业务逻辑或数据处理需求。