当前位置: 首页 > 后端技术 > Node.js

ExpressDocumentation(Routing)

时间:2023-04-03 17:35:08 Node.js

Routing路由是指应用程序的端点(URI)如何响应客户端请求。有关路由的介绍,请参阅路由基础知识。路由是使用与HTTP方法相对应的Express应用程序对象的方法定义的,例如,用于处理GET请求的app.get()和用于处理POST请求的app.post(),请参阅app.METHOD以获取完整列表。您还可以使用app.all()来处理所有HTTP方法,并使用app.use()将中间件指定为回调函数(有关详细信息,请参阅使用中间件)。这些路由方法指定回调函数(有时称为“处理函数”),当应用程序收到对指定路由(端点)和HTTP方法的请求时调用这些函数,换句话说,应用程序“侦听”与指定路由的匹配和方法请求,当它检测到匹配时,它调用指定的回调函数。事实上,路由方法可以有多个回调函数作为参数。当使用多个回调函数时,重要的是提供next作为回调函数的参数,然后在函数体中调用next()将控制传递给下一个回调。以下代码是一个非常基本的路由示例。varexpress=require('express')varapp=express()//当向主页发出GET请求时以“helloworld”响应app.get('/',function(req,res){res.send('helloworld')})路由方法路由方法派生自其中一种HTTP方法,并附加到express类的一个实例。以下代码是为应用程序根的GET和POST方法定义的路由示例。//GET方法routeapp.get('/',function(req,res){res.send('GET请求到主页')})//POST方法routeapp.post('/',function(req,res){res.send('POSTrequesttothehomepage')})Express支持所有HTTP请求方法对应的methods:get、post等,完整列表见app.METHOD。有一个特殊的路由方法app.all()加载路由上所有HTTP请求方法的中间件函数,例如,无论是使用GET、POST、PUT、DELETE还是http模块支持的任何其他HTTP请求方法,如下为路由“/secret”的请求执行处理程序。app.all('/secret',function(req,res,next){console.log('Accessingthesecretsection...')next()//将控制传递给下一个处理程序})routingpathroutingpathwith请求方法组合定义了可以发出请求的端点,路由路径可以是字符串、字符串模式或正则表达式。字符?、+、*和()是它们对应的正则表达式的子集,而连字符(-)和点(.)按字符串路径逐字解释。如果您需要在路径字符串中使用美元字符($),请将其括在([和])中,例如,对于位于“/data/$book”的请求的路径字符串将是“/data/([\$])书”。Express使用path-to-regexp来匹配路由路径,请参阅path-to-regexp文档以了解定义路由路径的所有可能性,ExpressRouteTester是用于测试基本Express路由的便捷工具,但它不支持模式匹配。查询字符串不是路由路径的一部分。以下是一些基于字符串的路由路径示例。这个路由路径会将请求匹配到根路由/。app.get('/',function(req,res){res.send('root')})此路由路径将匹配/about的请求。app.get('/about',function(req,res){res.send('about')})此路由路径将匹配对/random.text的请求。app.get('/random.text',function(req,res){res.send('random.text')})以下是一些基于字符串模式的路由路径示例。此路由路径将匹配acd和abcd。app.get('/ab?cd',function(req,res){res.send('ab?cd')})这个路由路径会匹配abcd,abbcd,abbbcd等app.get('/ab+cd',function(req,res){res.send('ab+cd')})这个路由路径会匹配abcd,abxcd,abRANDOMcd,ab123cd等app.get('/ab*cd',function(req,res){res.send('ab*cd')})此路由路径将匹配/abe和/abcde。app.get('/ab(cd)?e',function(req,res){res.send('ab(cd)?e')})基于正则表达式的路由路径示例:此路由路径将匹配任何内容其中的“一个”。app.get(/a/,function(req,res){res.send('/a/')})这个路由路径会匹配butterfly和dragonfly,但不会匹配butterflyman,dragonflyman等app.get(/.*fly$/,function(req,res){res.send('/.*fly$/')})routeparametersrouteparameters是命名的URL片段,用于捕获位置指定的值,捕获的值是填充在req.params对象中,路径中指定的路由参数的名称作为它们各自的键。路由路径:/users/:userId/books/:bookIdRequestURL:http://localhost:3000/users/34/books/8989req.params:{"userId":"34","bookId":"8989"}要使用路由参数定义路由,只需在路由路径中指定路由参数,如下所示。app.get('/users/:userId/books/:bookId',function(req,res){res.send(req.params)})路由参数名称必须由“单词字符”组成([A-Za-z0-9_])组成。由于连字符(-)和点(.)按字面解释,因此可以将它们与路由参数一起用于有用的目的。航线路径:/flights/:from-:toRequestURL:http://localhost:3000/flights/LAX-SFOreq.params:{"from":"LAX","to":"SFO"}航线路径:/plantae/:genus.:speciesRequestURL:http://localhost:3000/plantae/Prunus.persicareq.params:{"genus":"Prunus","species":"persica"}要更好地控制路由参数,您可以精确匹配的字符串,正则表达式可以追加在中括号(()):路由路径:/user/:userId(\d+)请求URL:http://localhost:3000/user/42req.params:{"userId":"42"}因为正则表达式通常是文字字符串的一部分,所以一定要用额外的反斜杠转义任何\字符,例如\\d+。在Express4.x中,正则表达式中的*字符不会以通常的方式解释,要解决此问题,请使用{0,}而不是*,这可能会在Express5中得到修复。路由处理程序您可以提供多个回调函数,这些回调函数的行为像处理请求的中间件一样,唯一的例外是这些回调可能会调用next('route')来绕过剩余的路由回调,你可以使用这种机制在路由上施加前置条件,然后将控制权传递给后续如果没有理由继续当前路线,则路线。路由处理程序可以是函数、函数数组或两者的组合,如以下示例所示。单个回调函数可以处理路由,例如:app.get('/example/a',function(req,res){res.send('HellofromA!')})多个回调函数可以处理路由(make确保指定下一个对象),例如:app.get('/example/b',function(req,res,next){console.log('响应将由下一个函数发送...')next()},function(req,res){res.send('HellofromB!')})一组回调函数可以处理路由,例如:varcb0=function(req,res,next){console.log('CB0')next()}varcb1=function(req,res,next){console.log('CB1')next()}varcb2=function(req,res){res.send('你好fromC!')}app.get('/example/c',[cb0,cb1,cb2])单个函数和函数数组的组合可以处理路由,例如:varcb0=function(req,res,next){console.log('CB0')next()}varcb1=function(req,res,next){console.log('CB1')next()}app.get('/example/d',[cb0,cb1],function(req,res,next){console.log('响应将由下一个函数发送...')next()},function(req,res){res.send('你好来自D!')})ResponseMethods下表中Response对象(res)上的方法可以向客户端发送响应并终止请求-响应循环。如果没有从路由处理程序调用这些方法,则客户端请求将保持挂起状态。方法说明res.download()提示下载文件res.end()结束响应过程res.json()发送JSON响应res.jsonp()使用JSONP支持发送JSON响应res.redirect()重定向请求res。render()渲染视图模板res.send()发送各种类型的响应res.sendFile()将文件作为八位字节流发送res.sendStatus()设置响应状态代码并将其字符串表示形式作为响应发送身体到应用程序。route()您可以使用app.route()为路由路径创建可链接的路由处理程序。由于路径是在一个地方指定的,因此有助于创建模块化路由,同时减少冗余和拼写错误。关于路由有关更多信息,请参阅:Router()文档。下面是使用app.route()定义的链接路由处理程序的示例。app.route('/book').get(function(req,res){res.send('随机获取一本书')}).post(function(req,res){res.send('添加一本书')}).put(function(req,res){res.send('Updatethebook')})express.Router使用express.Router类创建模块化、可加载的路由处理程序。Router实例是一个完整的中间件和路由系统,因此常被称为“小程序”。以下示例将路由器创建为一个模块,在其中加载中间件功能,定义一些路由,并将路由器模块安装在主应用程序的路径上。在应用程序目录中创建一个名为birds.js的路由器文件,其中包含以下内容:varexpress=require('express')varrouter=express.Router()//特定于此路由器的中间件router.use(functiontimeLog(req,res,next){console.log('Time:',Date.now())next()})//定义首页routerouter.get('/',function(req,res){res.send('Aboutbirds')})//定义关于routerouter.get('/about',function(req,res){res.send('Aboutbirds')})module.exports=routerthen,加载应用程序中的路由器模块:varbirds=require('./birds')//...app.use('/birds',birds)应用程序现在可以处理对/birds和/birds/about请求的调用,以及调用特定于该路由的timeLog中间件函数。上一篇:常见问题下一篇:编写中间件