Koa 基础篇(二)—— 路由与中间件

路由

Koa 中,路由,是一个由一个 URI 和一个特定的 HTTP 方法组成的,涉及到应用如何响应客户端对某个网站节点的访问。

简而言之,就是针对不同的 URI 服务器做出不同的响应。

Koa 中使用路由

Koa 中使用路由可以分为以下几步:

  1. 安装
npm install --save koa-router
  1. 在模块中引入路由
const router = require("koa-router")()
  1. 启动路由
app.use(router.routes())
app.use(router.allowedMethods())
  1. 基本使用
router.get("/",async ctx => {
    ctx.body = "hello koa router"
})

完整代码:

const Koa = require("koa")
const router = require("koa-router")()

let app = new Koa()

router.get("/",async ctx => {
    ctx.body = "hello koa router"
})

app.use(router.routes())
app.use(router.allowedMethods())
app.listen(3000)

运行项目,在浏览器访问本地3000端口,在页面上就会看到输出的语句。这就是最简单的路由。

获取查询字符串

其实,不知不觉的,在上面的例子中已经处理了一个 GET 请求。那么,如何获取到 GET 请求中的查询字符串呢?

示例:

router.get("/news",async ctx => {
    console.log(ctx.query)
    ctx.body = "hello koa router"
})

很简单,通过 ctx.query 就可以获取到所有的查询字符串(被封装为一个对象)。

动态路由匹配

通过语法 :param 来指定动态路由。

示例:

router.get("/news/:id",async ctx => {
    console.log(ctx.params)
    ctx.body = "hello koa router"
})

通过 ctx.params 就可以获取到所有动态路由参数(被封装为一个对象)。

处理 post 请求

处理 post 请求并不是一件困难的事,直接使用 router.post() 就可以处理了,问题就在于如何获取 post 请求的请求体。

在原生的 node.js 中,post 请求提交的数据是由一个个数据块来组成的,所以在接收的时候需要手动进行拼接,这无疑带来不友好的体验,所以,使用第三方中间件 koa-bodyparser 来进行请求体的解释。

  1. 安装
npm install --save koa-bodyparser
  1. 引入
const parser = require("koa-bodyparser")
app.use(parser())
  1. 使用
router.post("/login",async (ctx,next) => {
    console.log(ctx.request.body)
    ctx.body = "login success"
})

通过 ctx.request.body 就可以获取到 post 请求体的内容了。

中间件

中间件就是匹配路由之前或匹配路由完成后做的一系列操作。

可以通过中间件来执行代码,修改请求和响应对象,调用堆栈中的下一个中间件。

应用级中间件

需求:在处理所有请求之前都要打印当前的时间。

显然,不可能在每个路由中都插入一段代码来完成这个工作,所以此时就需要用到中间件了。

示例:

app.use(async (ctx,next) => {
    console.log(new Date())
    await next()
})

router.get("/news",async (ctx,next) => {
	console.log("news")
    ctx.body = "this is news page"
})

router.get("/home",async (ctx,next) => {
	console.log("home")
    ctx.body = "this is home page"
})

在上面的例子中,通过一个 use 方法,作为所有路由的 “拦截器” ,在处理所有路由之前先执行了这个路由里面的逻辑。

路由中间件

只处理某个具体路由的中间件。

示例:

router.get("/news",async (ctx,next) => {
    console.log("news")
    await next()
})

router.get("/news",async (ctx,next) => {
    ctx.body = "this is news page"
})

访问该路由时,会在控制台打印输出,在页面上也会有对应的显示。这说明访问一个 url 由两个路由处理了。

错误处理中间件

ctx 对象中,有一个 status 属性用于表示响应状态码,从而可以通过响应状态码来进行简单的错误处理。

示例:

app.use(async (ctx,next) => {
    if(ctx.status === 404){
        ctx.body = "404 page"
    }
    await next()
})

第三方中间件

第三方中间件就是使用第三方的包进行处理的中间件。比如,使用第三方中间件 koa-static 进行静态资源的托管。

  1. 安装
npm install --save koa-static
  1. 引入
const koa_static = require("koa-static")
  1. 配置
app.use(koa_static(path.join(__dirname,"public")))

注意:上面的 public 就是被托管的静态资源文件夹。

發表評論
所有評論
還沒有人評論,想成為第一個評論的人麼? 請在上方評論欄輸入並且點擊發布.
相關文章