从 GoFrame v1.11 版本开始， Request 对象提供了对客户端提交的 JSON/XML 数据格式的原生支持，为开发者提供了更便捷的数据获取特性，以进一步提高开发效率。

示例1，简单示例

  1. package main
  3. import (
  4.     "github.com/gogf/gf/v2/frame/g"
  5.     "github.com/gogf/gf/v2/net/ghttp"
  6. )
  8. func main() {
  9.     s := g.Server()
  10.     s.BindHandler("/", func(r *ghttp.Request) {
  11.         r.Response.Writef("name: %v, pass: %v", r.Get("name"), r.Get("pass"))
  12.     })
  13.     s.SetPort(8199)
  14.     s.Run()
  15. }

执行后，我们通过 curl 工具提交数据来测试一下：

  1. Query 数据格式
  1. $ curl "http://127.0.0.1:8199/?name=john&pass=123"
  2. name: john, pass: 123
  1. Form 表单提交
  1. $ curl -d "name=john&pass=123" "http://127.0.0.1:8199/"
  2. name: john, pass: 123
  1. JSON 数据格式
  1. $ curl -d '{"name":"john","pass":"123"}' "http://127.0.0.1:8199/"
  2. name: john, pass: 123
  1. XML 数据格式
  1. $ curl -d '<?xml version="1.0" encoding="UTF-8"?><doc><name>john</name><pass>123</pass></doc>' "http://127.0.0.1:8199/"
  2. name: john, pass: 123
  5. $ curl -d '<doc><name>john</name><pass>123</pass></doc>' "http://127.0.0.1:8199/"
  6. name: john, pass: 123

示例2，对象转换及校验

  1. package main
  3. import (
  4.     "github.com/gogf/gf/v2/frame/g"
  5.     "github.com/gogf/gf/v2/net/ghttp"
  6.     "github.com/gogf/gf/v2/util/gvalid"
  7. )
  9. type RegisterReq struct {
  10.     Name  string `p:"username"  v:"required|length:6,30#请输入账号|账号长度为:{min}到:{max}位"`
  11.     Pass  string `p:"password1" v:"required|length:6,30#请输入密码|密码长度不够"`
  12.     Pass2 string `p:"password2" v:"required|length:6,30|same:password1#请确认密码|密码长度不够|两次密码不一致"`
  13. }
  15. type RegisterRes struct {
  16.     Code  int         `json:"code"`
  17.     Error string      `json:"error"`
  18.     Data  interface{} `json:"data"`
  19. }
  21. func main() {
  22.     s := g.Server()
  23.     s.BindHandler("/register", func(r *ghttp.Request) {
  24.         var req *RegisterReq
  25.         if err := r.Parse(&req); err != nil {
  26.             // Validation error.
  27.             if v, ok := err.(gvalid.Error); ok {
  28.                 r.Response.WriteJsonExit(RegisterRes{
  29.                     Code:  1,
  30.                     Error: v.FirstString(),
  31.                 })
  32.             }
  33.             // Other error.
  34.             r.Response.WriteJsonExit(RegisterRes{
  35.                 Code:  1,
  36.                 Error: err.Error(),
  37.             })
  38.         }
  39.         // ...
  40.         r.Response.WriteJsonExit(RegisterRes{
  41.             Data: req,
  42.         })
  43.     })
  44.     s.SetPort(8199)
  45.     s.Run()
  46. }

执行后，我们通过 curl 工具提交数据来测试一下：

  1. JSON 数据格式
  1. $ curl -d '{"username":"johngcn","password1":"123456","password2":"123456"}' "http://127.0.0.1:8199/register"
  2. {"code":0,"error":"","data":{"Name":"johngcn","Pass":"123456","Pass2":"123456"}}
  5. $ curl -d '{"username":"johngcn","password1":"123456","password2":"1234567"}' "http://127.0.0.1:8199/register"
  6. {"code":1,"error":"两次密码不一致","data":null}

可以看到，我们提交的 JSON 内容也被 Parse 方法智能地转换为了结构体对象。

  1. XML 数据格式
  1. $ curl -d '<?xml version="1.0" encoding="UTF-8"?><doc><username>johngcn</username><password1>123456</password1><password2>123456</password2></doc>' "http://127.0.0.1:8199/register"
  2. {"code":0,"error":"","data":{"Name":"johngcn","Pass":"123456","Pass2":"123456"}}
  5. $ curl -d '<?xml version="1.0" encoding="UTF-8"?><doc><username>johngcn</username><password1>123456</password1><password2>1234567</password2></doc>' "http://127.0.0.1:8199/register"
  6. {"code":1,"error":"两次密码不一致","data":null}

可以看到，我们提交的 XML 内容也被 Parse 方法智能地转换为了结构体对象。