OnceIO(Node.JS)的路由(Routing)、路由方法和路由变量
OnceIO Node.JS by newghost on 1478058875870


OnceIO是OnceDoc企业内容(网盘)系统的底层Web框架,它可以实现模板文件、静态文件的全缓存,运行起来完全不需要I/O操作,并且支持客户端缓存优化,GZIP压缩等(只在第一次压缩),拥有非常好的性能,为您节约服务器成本。它可以让你对Web进行分布式存储,即一个扩展包里即可包含前端、后端和数据库定义,只需通过添加/删除目录的方式就可实现功能删减,实现真正的模块化扩展。这里是介绍如何使用OnceIO的一系列文章。

路由定义

路由用于确定应用程序如何响应对特定端点的客户机请求,包含一个 URI(或路径)和一个特定的 HTTP 请求方法(GET、POST 等)。

每个路由可以具有一个或多个处理程序函数,这些函数在路由匹配时执行。

路由定义采用以下结构:

app.METHOD(PATH, HANDLER)

其中:

  • app 是 OnceIO 的实例。
  • METHOD 是 HTTP 请求方法, 如get/post。
  • PATH 是服务器上的路由路径。
  • HANDLER 是在路由匹配时执行的函数。

路由路径

多个路径可以用数组表示,例如:

此路由路径将匹配 apple, banana 和 strawberry

app.get(['/apple', '/banana', '/strawberry'], function(req, res) {
  res.send('fruit')
})

路径可以用正则表达式表示,例如:

此路由路径将匹配 abcd、abbcd、abbbcd 等。

app.get(/ab*cd/, function(req, res) {
  res.send('/ab*cd/')
})  

此路由路径将匹配名称中具有“a”的所有路由。

app.get(/a/, function(req, res) {
  res.send('/a/')
})

此路由路径将匹配 butterfly 和 dragonfly,但是不匹配 butterflyman、dragonfly man 等。

app.get(/.*fly$/, function(req, res) {
  res.send('/.*fly$/')
})

路由变量

路径中可以加入变量,例如:

此路由路径将匹配所有路由,路径的第一个和第二个斜杠之间的内容会被存入 req.params.id 中。如路径为 '/1234/5678',req.params.id 的值将为 '1234'。

app.get('/:id', function(req, res){
  res.send(req.params.id)
})

可以将路由的第三个参数设置为 { mode: 'loose' },令路由路径匹配所有以其开头的路径,例如:

此路由路径将匹配所有以 '/OnceAcademy' 开头的路径,比如 '/OnceAcademy'、'/OnceAcademy/routing'、'/OnceAcademy/middleware',但是不匹配 '/OnceAcademyRouting'、'/OnceAcademyMiddleware'。

app.get('/OnceAcademy', function(req, res) {
  res.send('OnceAcademy')
}, { mode: 'loose' })

响应方法

下表中响应对象 (res) 的方法可以向客户机发送响应,并终止请求/响应循环。如果没有从路由处理程序调用其中任何方法,客户机请求将保持挂起状态。

方法 描述
res.end() 结束响应进程。
res.redirect() 重定向请求。
res.send(statusCode, text) 设置响应状态码(默认为 200)并在 text 为空时以响应主体形式发送其字符串表示。text 是选填参数,可以是 html 文件、json 变量等,以响应主体形式发送。
res.send(json) 发送 JSON 响应。
res.sendFile() 以字节流形式发送文件。
res.cookie(name, value, options) 设置 cookie 的名称和值,将其随响应一起发送。

 

 

 OnceIO地址:  https://github.com/OnceDoc/onceio

 

 

上一篇: 在OnceIO中创建和使用Middleware中间件 下一篇: 静态文件路由