对象转换
对象转换方法使用Request
对象的Parse
方法或者Get*Struct
方法,具体方法定义请参考API文档:https://godoc.org/github.com/gogf/gf/net/ghttp#Request
参数映射
客户端提交的参数如果需要映射到服务端定义的struct
上,可以采用默认的映射关系,这一点非常方便。默认的转换规则如下:
struct
中需要匹配的属性必须为公开属性
(首字母大写)。- 如果匹配成功,那么将键值赋值给属性,如果无法匹配,那么忽略该键值。
以下是几个匹配的示例:
自定义规则
自定义的参数映射规则可以通过为属性绑定tag
实现,tag
名称可以为p/param/params
。例如:
其中我们使用了p
标签来指定该属性绑定的参数名称。password1
参数将会映射到Pass1
属性,password2
将会映射到Pass2
属性上。其他属性采用默认的转换规则即可,无需设置tag
。
Parse
转换
从v1.11
版本开始,我们推荐使用Parse
方法来实现struct
的转换,该方法是一个便捷方法,内部会自动进行转换及数据校验,但如果struct
中没有校验tag
的绑定将不会执行校验逻辑。
在该示例中,我们定义了两个结构体:RegisterReq
用于参数接收,RegisterRes
用于数据返回。
其中,我们使用将客户端提交的参数转换为RegisterReq
对象,当转换成功时req
变量将会被初始化赋值(默认情况下为nil
),否则该方法返回err
并且req
变量为nil
。返回数据结构通过RegisterRes
定义,并且返回格式为JSON
,通过r.Response.WriteJsonExit
实现,该方法将RegisterRes
根据其内部定义的json
标签转换为JSON
格式并退出当前服务方法,不再执行该服务方法的后续逻辑。
为了演示测试效果,这里在正常的返回结果Data
属性中将RegisterReq
对象返回,由于该对象没有绑定json
标签,因此返回的JSON
字段将会为其属性名称。
我们使用了和POST
两种提交方式来做测试,可以看到服务端都能完美地获取到提交参数并完成对象转换。