3.2 IRouter 路由配置抽象类

现在我们来给Zinx实现一个非常简单基础的路由功能,目的当然就是为了快速的让Zinx步入到路由的阶段。后续我们会不断的完善路由功能。

A) 创建抽象的IRouter层

ziface下创建irouter.go文件

zinx/ziface/irouter.go

  1. package ziface
  2. /*
  3. 路由接口, 这里面路由是 使用框架者给该链接自定的 处理业务方法
  4. 路由里的IRequest 则包含用该链接的链接信息和该链接的请求数据信息
  5. */
  6. type IRouter interface{
  7. PreHandle(request IRequest) //在处理conn业务之前的钩子方法
  8. Handle(request IRequest) //处理conn业务的方法
  9. PostHandle(request IRequest) //处理conn业务之后的钩子方法
  10. }

我们知道router实际上的作用就是,服务端应用可以给Zinx框架配置当前链接的处理业务方法,之前的Zinx-V0.2我们的Zinx框架处理链接请求的方法是固定的,现在是可以自定义,并且有3种接口可以重写。

Handle:是处理当前链接的主业务函数

PreHandle:如果需要在主业务函数之前有前置业务,可以重写这个方法

PostHandle:如果需要在主业务函数之后又后置业务,可以重写这个方法

当然每个方法都有一个唯一的形参IRequest对象,也就是客户端请求过来的连接和请求数据,作为我们业务方法的输入数据。

B) 实现Router类

znet下创建router.go文件

  1. package znet
  2. import "zinx/ziface"
  3. //实现router时,先嵌入这个基类,然后根据需要对这个基类的方法进行重写
  4. type BaseRouter struct {}
  5. //这里之所以BaseRouter的方法都为空,
  6. // 是因为有的Router不希望有PreHandle或PostHandle
  7. // 所以Router全部继承BaseRouter的好处是,不需要实现PreHandle和PostHandle也可以实例化
  8. func (br *BaseRouter)PreHandle(req ziface.IRequest){}
  9. func (br *BaseRouter)Handle(req ziface.IRequest){}
  10. func (br *BaseRouter)PostHandle(req ziface.IRequest){}

我们当前的Zinx目录结构应该如下:

  1. .
  2. ├── README.md
  3. ├── ziface
  4. ├── iconnnection.go
  5. ├── irequest.go
  6. ├── irouter.go
  7. └── iserver.go
  8. └── znet
  9. ├── connection.go
  10. ├── request.go
  11. ├── router.go
  12. ├── server.go
  13. └── server_test.go