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

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) 的方法可以向客户机发送响应，并终止请求/响应循环。如果没有从路由处理程序调用其中任何方法，客户机请求将保持挂起状态。

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