You are viewing an old version of this page. View the current version.
Compare with Current View Page History
Version 1 Next »
从上面的例子中,我们可以看到,路由方法定义使用固定的格式:
func Handler(ctx context.Context, req *Request) (res *Response, err error)
其中输入参数和输出参数都是两个,并且都是必须的一个都不能少。简单介绍下:
ctx context.Context
Server
req *Request
就算没有接收参数也要定义,因为请求结构体中不仅仅包含请求参数的定义,也包含了接口的请求定义。
res *Response
就算没有返回参数也要定义,因为返回结构体中不仅仅包含返回参数的定义,也可以包含接口返回定义。
err error
在规范化路由注册中,非常重要的是请求/返回结构体的定义,在该结构体不仅仅包含了输入参数的定义,也包含了接口的定义,特别是路由地址、请求方法、接口描述等信息。为保证命名规范化,输入数据结构以XxxReq方式命名,输出数据结构以XxxRes方式命名。即便输入或者输出参数为空,也需要定义相应的数据结构,这样的目的一个是便于后续扩展,另一个是便于接口信息的管理。关于结构体中涉及到OpenAPIv3协议的标签介绍请查看后续章节。
XxxReq
XxxRes
OpenAPIv3
请求参数自动转换到请求数据结构,字段映射转换不区分大小写,也会自动忽略特殊字符。
请求结构体在进入API接口执行前将会被自动执行校验,如果其中一条规则校验失败,那么将终止后续规则的校验。校验功能使用的是框架统一的校验组件,具体请参考:数据校验
接口的数据返回处理需要设置统一的后置中间件,当然也可以使用Server默认提供的数据返回中间件。开发者自定义中间件时可以参考Server默认提供的中间件。注意其中的一个重要的方法:
// GetHandlerResponse retrieves and returns the handler response object and its error. // return type handlerResponse struct { // Object interface{} // Error error // } func (r *Request) GetHandlerResponse() interface{}
通过后置中间件执行时通过请求对象的GetHandlerResponse方法获取当前业务执行的结果,并根据需要做相应处理。
GetHandlerResponse
我们推荐使用对象化的方式来管理所有路由方法,并通过分组路由的Bind方法执行统一注册。
Bind
需要注意的是,在规范化路由方式下,路由地址以及请求方式将由请求结构体在g.Meta中定义,通过分组路由可以定义分组下的所有路由前缀。
g.Meta